EvoHub Docs Sign in

On-Call API › Analytics

Alert analytics

Use with AI
View as MarkdownThis page as plain text, for pasting into an AI tool Open in ClaudeAsk Claude questions about this page Open in ChatGPTAsk ChatGPT questions about this page
Connect to Cursor / VS Code / ClaudeSearch and read these docs from your AI tool (MCP server)

MCP server URL

https://docs-dev.evohub.io/mcp

Add to CursorAdd to VS Code

Claude Code

claude mcp add --transport http evohub-docs-docs https://docs-dev.evohub.io/mcp

Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, and paste the URL above.

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://docs-dev.evohub.io/mcp"
      ]
    }
  }
}

Cursor — ~/.cursor/mcp.json

{
  "mcpServers": {
    "evohub-docs-docs": {
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

VS Code — .vscode/mcp.json

{
  "servers": {
    "evohub-docs-docs": {
      "type": "http",
      "url": "https://docs-dev.evohub.io/mcp"
    }
  }
}

llms.txtllms-full.txt

GET/api/v1/alerts/analytics

Aggregates over the organization's alerts in a time range: MTTA and MTTR (p50, p90, average), counts per severity and per integration, a time series (hourly up to 48 hours, daily beyond), noise (flapping alerts, alerts resolved without anyone acknowledging them, the noisiest fingerprints), an alerts-per- hour heatmap, notification totals and the load on each responder.

The heatmap and off-hours counts use tz, else the timezone most of the organization's schedules use, else UTC; range.tz_source says which.

Permission (API-key scope): oncall:alert:read.

Authorization

Any one of:

Parameters

Query parameters

  • from string
    Start of the range: a date (YYYY-MM-DD, start of that UTC day) or an RFC 3339 instant. Give from and to together, or neither for the last 30 UTC days including today.
    Example: 2026-09-01
  • to string
    End of the range: a date (the last UTC day included) or an RFC 3339 instant (exclusive). At most 366 days after from.
    Example: 2026-09-30
  • severity string
    Comma-separated severities to include.
    Example: critical,high
  • compare string
    Also compute the totals of a comparison period: previous (the same length immediately before) or year (the same dates a year earlier).
    One of: previous year
  • team_id string
    Only this team's alerts.
  • integration_id string
    Comma-separated integration ids.
  • source string
    Comma-separated integration kinds, for example prometheus,grafana.
  • tz string
    IANA timezone for the heatmap and off-hours counts.
    Example: Europe/Istanbul
  • ack_target_seconds integer
    The acknowledgement target acked_within_target counts against, in seconds (1–86400).
    Default: 300 · Minimum: 1 · Maximum: 86400
  • flap_window_minutes integer
    An alert re-opening within this many minutes of being resolved counts as flapping (1–1440).
    Default: 30 · Minimum: 1 · Maximum: 1440

Responses

200

The aggregates.

Content type: application/json

Type: object

  • data AlertAnalytics required
    Show AlertAnalytics properties
    • range AnalyticsRange
      Show AnalyticsRange properties
      • from string (date-time)
      • to string (date-time)
        Exclusive.
      • granularity string
        One of: hour day
      • tz string
      • tz_source string
        One of: param schedules default
    • ack_target_seconds integer
    • totals AlertGroupStats
      Show AlertGroupStats properties
      • alerts integer
      • acknowledged integer
      • resolved integer
      • auto_resolved integer
      • resolved_without_ack integer
      • escalated integer
      • retriggers integer
      • flapping integer
      • suppressed integer
      • closed_before_notify integer
      • acked_within_target integer
      • mtta DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • mttr DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
    • series array of AlertGroupStats & object
      • alerts integer
      • acknowledged integer
      • resolved integer
      • auto_resolved integer
      • resolved_without_ack integer
      • escalated integer
      • retriggers integer
      • flapping integer
      • suppressed integer
      • closed_before_notify integer
      • acked_within_target integer
      • mtta DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • mttr DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • bucket string (date-time)
      • by_severity object
        Other keys: integer
    • by_severity array of AlertGroupStats & object
      • alerts integer
      • acknowledged integer
      • resolved integer
      • auto_resolved integer
      • resolved_without_ack integer
      • escalated integer
      • retriggers integer
      • flapping integer
      • suppressed integer
      • closed_before_notify integer
      • acked_within_target integer
      • mtta DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • mttr DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • severity string
    • by_integration array of AlertIntegrationStats
      Show AlertIntegrationStats properties
      • alerts integer
      • acknowledged integer
      • resolved integer
      • auto_resolved integer
      • resolved_without_ack integer
      • escalated integer
      • retriggers integer
      • flapping integer
      • suppressed integer
      • closed_before_notify integer
      • acked_within_target integer
      • mtta DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • mttr DurationStats
        Show DurationStats properties
        • count integer
          How many were measured.
        • p50_seconds number | null
        • p90_seconds number | null
        • avg_seconds number | null
      • integration_id string
        Empty for alerts raised by hand or by another EvoHub product.
      • integration_name string
      • integration_type string
    • noise object
      • flap_window_minutes integer
      • flapping integer
      • resolved_without_ack integer
      • top_integrations array of AlertIntegrationStats
        Show AlertIntegrationStats properties
        • alerts integer
        • acknowledged integer
        • resolved integer
        • auto_resolved integer
        • resolved_without_ack integer
        • escalated integer
        • retriggers integer
        • flapping integer
        • suppressed integer
        • closed_before_notify integer
        • acked_within_target integer
        • mtta DurationStats
          Show DurationStats properties
          • count integer
            How many were measured.
          • p50_seconds number | null
          • p90_seconds number | null
          • avg_seconds number | null
        • mttr DurationStats
          Show DurationStats properties
          • count integer
            How many were measured.
          • p50_seconds number | null
          • p90_seconds number | null
          • avg_seconds number | null
        • integration_id string
          Empty for alerts raised by hand or by another EvoHub product.
        • integration_name string
        • integration_type string
      • top_fingerprints array of object
        • fingerprint string
        • title string
        • integration_id string
        • alerts integer
        • resolved_without_ack integer
        • retriggers integer
        • flapping integer
    • heatmap array of object
      • weekday integer
        ISO weekday: 1 Monday … 7 Sunday.
        Minimum: 1 · Maximum: 7
      • hour integer
        Minimum: 0 · Maximum: 23
      • alerts integer
    • notifications object
      • total integer
      • voice integer
      • sms integer
      • email integer
      • push integer
      • calls_unanswered integer
      • suppressed integer
    • responders array of object
      • user_id string
      • notifications integer
      • voice integer
      • sms integer
      • email integer
      • push integer
      • calls_unanswered integer
      • alerts_notified integer
      • interruptions integer
      • off_hours_interruptions integer
      • sleep_hours_interruptions integer
      • acknowledged integer
      • resolved integer
      • suppressed integer
        Notifications held back by maintenance or the person's notification schedule.
    • compare AlertGroupStats & object | null

      One of:

      • AlertGroupStats & object
        • alerts integer
        • acknowledged integer
        • resolved integer
        • auto_resolved integer
        • resolved_without_ack integer
        • escalated integer
        • retriggers integer
        • flapping integer
        • suppressed integer
        • closed_before_notify integer
        • acked_within_target integer
        • mtta DurationStats
          Show DurationStats properties
          • count integer
            How many were measured.
          • p50_seconds number | null
          • p90_seconds number | null
          • avg_seconds number | null
        • mttr DurationStats
          Show DurationStats properties
          • count integer
            How many were measured.
          • p50_seconds number | null
          • p90_seconds number | null
          • avg_seconds number | null
        • mode string
        • from string (date-time)
        • to string (date-time)
      • null
  • success boolean required
    Value: true

400

A parameter is invalid; each problem is listed in details (VALIDATION_FAILED).

Content type: application/json

Type: ValidationError

  • error object required
    • code string required
      Value: VALIDATION_FAILED
    • message string required
    • details array of object required
      • field string
      • message string

401

No API key was sent, or it is unknown, revoked or expired (UNAUTHORIZED).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.

403

The key lacks the scope this endpoint needs (FORBIDDEN).

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.

429

Too many requests (RATE_LIMITED). Wait Retry-After seconds.

Headers

  • Retry-After integer
    Seconds to wait.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.

500

Something went wrong on EvoHub's side (INTERNAL_ERROR). Retry later.

Content type: application/json

Type: Error

  • error object required
    • code string required
      Machine-readable code. Branch on this.
    • message string required
      Human-readable explanation.

Example request

curl -X GET 'https://evohub.io/api/v1/alerts/analytics' \
  -H 'Authorization: Bearer <TOKEN>'

Last updated