Skip to Content
Mux Docs: Home

Focus your operational response with error categorization

Configure error categorization through the Mux Data Dashboard or your SDKs to track and report on custom error metadata for views in Mux Data.

Beta

This feature is currently in private beta.

1What is Error Categorization?

Error Categorization allows you to set custom error metadata to provide more actionable data. By using error categorization, you can distinguish between fatal errors or warnings and classify errors as playback failures or business exceptions. Errors categorized as warnings or as business exceptions are not considered playback failures, meaning these errors are excluded from alerting, giving a more accurate picture of the health of your system with less noise from alerts.

Playback Failure metrics (Playback Failure Percentage and Video Startup Playback Failure Percentage) only include fatal operational failures, while errors categorized as business exceptions and warnings are excluded. Errors that are categorized as a business exception will be included in the Playback Business Exception Percentage and Video Startup Business Exception Percentage metrics.

There are two dimensions, Playback Business Exception and Video Startup Business Exception, that are available as filters. Like the Playback Failure metrics, the Playback Failure and Video Startup Failure dimensions are not set for business exceptions and warnings.

The category information for errors can be set from the Mux Dashboard or from the individual player SDKs. You only need to set the categorization on an error in one place and information about the categories that are set in the Dashboard overrides the information set in the SDKs.

2Configuring Error Categorization

Categorizing Errors is available from the Settings page and selecting the "Categorize Errors" tab. You must be an admin user to add a new error code categorization.

In the configuration page, you can categorize errors by code. Click the "Add an error code" button. In the dropdown, you will see the error codes your environment has encountered. Select from this dropdown and press "Add" to create a new categorization. By default, errors will have fatal error severity and will be tagged as playback failures.

Type into the filter box to search for specific error codes. If you are configuring an error code not previously seen in this environment, you can press "Enter" to create a new categorization.

To edit a categorization, press the edit icon. After making your selections, save the categorization. All new video views with this error code will contain this categorization.

3Submitting Error metadata from Mux Data SDKs

Attach severity and type to errors with Mux Data SDKs

Error Categorization can also be configured in the Mux Data SDKs in a similar method to other error metadata. If an error code is already configured in the data dashboard, the settings from the dashboard will take precedence.

HTML5 Video Element and other web SDKs

In web-based SDKs, Error Categorizations can be set by passing through a function to the player. This function will set the relevant error metadata.

function errorTranslator (error) {
return {
player_error_code: translateCode(error.player_error_code),
player_error_message: translateMessage(error.player_error_message),
player_error_context: translateContext(error.player_error_context),
player_error_severity: translateSeverity(error.player_error_severity),
player_error_business_exception: translateBusinessException(error.player_error_business_exception)
};
}
mux.monitor('#my-player', {
debug: false,
errorTranslator: errorTranslator,
data: {
env_key: 'ENV_KEY', // required
// ... additional metadata
}
});

For more guidance on using and configuring the error translator in web-based SDKs, please refer to the guide on monitoring the HTML5 video element.

Version 5.2.0 or later of the HTML5 Video Element monitor is necessary to support Error Categorization.

ExoPlayer

Error Categorization is not currently supported in Android-based SDKs, but is coming soon.

For more guidance on using and configuring Android SDKs, please refer to the guide on monitoring ExoPlayer.

AVPlayer

Error Categorization is not currently supported in iOS SDKs, but is coming soon.

For more guidance on using and configuring iOS SDKs, please refer to the guide on monitoring AVPlayer.

Roku

Error Categorization is not currently supported in the Roku SDK, but is coming soon.

For more guidance on using and configuring the Roku SDK, please refer to the guide on monitoring Roku.

Was this page helpful?