[HDX-4997] Record alert evaluation errors in AlertHistory and add alert detail page

.changeset/alert-detail-page-evaluations.md

@@ -0,0 +1,13 @@
+---
+'@hyperdx/common-utils': minor
+'@hyperdx/api': minor
+'@hyperdx/app': minor
+---
+
+Add an alert detail page (/alerts/:id) with the alert's query charted against
+its threshold, a widened evaluation-history strip, and a paginated evaluation
+event stream (per-group breakdown for group-by alerts, evaluation analytics
+columns, time-range-scoped cursor pagination). Adds the
+GET /alerts/:id/evaluations endpoint and the AlertHistory read-side support
+for ERROR-state rows and evaluation analytics; the alerts page history strip
+renders errored evaluation windows with per-window error details.

.changeset/alert-evaluation-error-persistence.md

@@ -0,0 +1,13 @@
+---
+'@hyperdx/common-utils': minor
+'@hyperdx/api': minor
+---
+
+Persist alert evaluation errors (query errors, timeouts, webhook failures) as
+ERROR-state AlertHistory records instead of only a latest-only snapshot,
+upserted per evaluation window so retries collapse into a single row. Query
+timeouts are classified separately (QUERY_TIMEOUT, including timeouts wrapped
+by the ClickHouse query client) with an actionable message. ERROR rows are
+excluded from scheduling/backfill computations so failed windows are still
+retried and backfilled, and evaluation analytics (query/webhook durations,
+backfilled buckets) are recorded on every history row.

docker-compose.yml

@@ -74,6 +74,8 @@ services:
       # Uncomment the next two lines to enable PromQL (Prometheus-compatible metrics)
       # ENABLE_PROMQL: 'true'
       # NEXT_PUBLIC_ENABLE_PROMQL: 'true'
+      # Uncomment to enable the alert detail page (in development)
+      # NEXT_PUBLIC_ENABLE_ALERT_DETAILS: 'true'
       DEFAULT_CONNECTIONS:
         '[{"name":"Local
         ClickHouse","host":"http://ch-server:8123","username":"default","password":""}]'

packages/api/openapi.json

@@ -118,6 +118,7 @@
         "type": "string",
         "enum": [
           "QUERY_ERROR",
+          "QUERY_TIMEOUT",
           "WEBHOOK_ERROR",
           "INVALID_ALERT",
           "UNKNOWN"