---
title: "errorMetricsHandler()"
slug: "errormetricshandler"
updated: 2025-05-01T16:09:08Z
published: 2025-05-01T16:09:08Z
canonical: "docs.developer.comcast.com/errormetricshandler"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.developer.comcast.com/llms.txt
> Use this file to discover all available pages before exploring further.

# errorMetricsHandler()

## errorMetricsHandler()

Logs a system error metric (which was not the result of a user action).

For user errors, see [userErrorMetricsHandler](/docs/usererrormetricshandler).

#### Signature:

`$badger.errorMetricsHandler(message, visible, code, args)`

#### Parameters:

| parameter | description | data type | required? |
| --- | --- | --- | --- |
| message | The text of the error message | String | Yes |
| visible | indicates whether the error was displayed to the user | Boolean | Yes |
| code | The error code which was displayed. This can be any value which is meaningful to your X1 App, but defaults to CH_ERR | String | No |
| args | Optional arguments to include.The individual properties in args must be primitives (string, numeric or boolean). Nesting of properties is not supported. | Object | No |

#### Return Values:

None.

#### Usage Example:

```
$badger.errorMetricsHandler("This is an app error", false, "APP-001", { 
    httpStatusCode: '503',
    exception: 'Service timeout',
    responseTimeMs: 836
});
```

#### Mandatory integration:

Must be called to support the Error Free Session Rate metric of the [App Requirements](/docs/app-requirements).