Error Tracking

Get the impact of an error tracking issue

Changed on

Get an issue's impact over a time window: its error counts by source, and the users, sessions, accounts, RUM views, and endpoints it affects most. Returns 403 if the caller lacks the error_tracking_read permission or does not have access to the issue's data.

get/api/v2/error-tracking/issues/{issue_id}/impact

Request

  • Base URL
    https://api.datadoghq.com
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code/oauth2/v1/authorize
      Token URL/oauth2/v1/token
      Scopeserror_tracking_read

Path parameters

issue_idstring required

The identifier of the issue.

Query parameters

filter[from]integer required

Start of the time window, in milliseconds since the Unix epoch. Must be before filter[to].

filter[to]integer required

End of the time window, in milliseconds since the Unix epoch. Use the issue's last_seen to end the window at its latest error.

Response

OK

Example response

{
  "data": {
    "attributes": {
      "accounts": {
        "distinct_count": 18,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "logs": 700,
              "rum": 440
            },
            "id": "acc-7",
            "name": "Acme",
            "significant": true
          }
        ]
      },
      "endpoints": {
        "distinct_count": 2,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "logs": 700,
              "rum": 440
            },
            "resource_name": "POST /orders",
            "service": "checkout-api",
            "significant": true
          }
        ]
      },
      "error_counts": {
        "apm": 700,
        "logs": 700,
        "rum": 440
      },
      "sessions": {
        "distinct_count": 540,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "logs": 700,
              "rum": 440
            },
            "id": "8f1c3a52-6b1e-4a5e-9d0e-2c3b4a5d6e7f"
          }
        ]
      },
      "users": {
        "distinct_count": 312,
        "top": [
          {
            "error_counts": {
              "apm": 700,
              "logs": 700,
              "rum": 440
            },
            "id": "u-42",
            "name": "jane@example.com",
            "significant": true
          }
        ]
      },
      "views": {
        "distinct_count": 4,
        "top": [
          {
            "affected": {
              "accounts": 12,
              "sessions": 210,
              "users": 150,
              "views": 480
            },
            "baseline": {
              "accounts": 12,
              "sessions": 210,
              "users": 150,
              "views": 480
            },
            "error_counts": {
              "apm": 700,
              "logs": 700,
              "rum": 440
            },
            "name": "/checkout",
            "significant": true
          }
        ]
      }
    },
    "id": "c1726a66-1f64-11ee-b338-da7ad0900002",
    "type": "error_tracking_issue_impact"
  }
}

Changes