Emby.DiagnosticsPlugin

The Diagnostics Plugin for Emby Server exposes a number of settings that allow us to better analyze problems and pinpoint errors.

Disclaimer:

The exposed settings are meant to be applied only on explicit request by our support staff.
They are not meant to complement Emby's regular settings, they are not meant for tweaking Emby behavior in general or for fixing certain problems.

Can't find a specific option?
Options are controlled by the server version, not the plugin. When you don't see it, it's not available.

System Requirements

The minimum required version of Emby Server is 4.4.0.8

Download and Installation

UPDATE: The plugin is now available from the plugin catalog!

• Please go to the plugins section of Emby Server and install the Diagnostics Plugin from there
  This will also make sure that it’s automatically updated to match the Emby Server version
• Don’t forget to restart Emby

Codec Parameters

After installing, there will be two additional navigation menu entries in the server dashboard menu.

• Diagnostic Options
• Codec Parameters

Codecs that are not configurable are showing an ‘i’ button which allows to display the codec capabilities.

Codecs with the gear button can be configured.

Diagnostic Options

Please apply settings as instructed by the Emby Support staff then click Save and follow any additional instructions you might have been given.

Generating EDD Files

The Diagnostics Plugin will also allow you to generate “EDD” (Emby Diagnostic Data) files.

Those files are including a lot more information than is available in the logfiles, yet the most important part is the media data analysis.

Media analysis will parse both, transcoding Input and Output and extract detailed (frame-level) information from them?r

Activating EDD File Generation

• Go to the “Diagnostic Options” dashboard page and scroll down to the bottom
• Check all three check-boxes
• Enter 500 or 1000 for the frame count

Important Note: Activating this will cause some significant CPU load each time you have stopped plaback). This should only be activated when it’s really needed).

Submitting EDD Files

• Those files get saved by Emby into the normal log folder, but they are not visible from the Emby Server Dashboard.
• Please access the file system directly to obtain one of those files.

Privacy

• EDD files are containing JSON-formatted text which can be reviewed at any time, there’s no “secret” information transmitted to Emby
• You can always send us your logs and data files via Private Message, if you want to avoid posting that publicly in the forums!

Additional Notes

• The diagnostic options are volatile and not being saved anywhere.
• After restarting Emby Server, all settings will be lost.