Skip to main content

Deployment Status

The Deployment Status endpoint provides an authenticated, tenant-scoped operational summary for rapid diagnosis.

Get cluster status​

GET /api/deployment-status/cluster

The caller must have permission to view infrastructure. Infrastructure managers also inherit read access.

The response reports:

  • whether application-node registration is available for this deployment;
  • application nodes and their API, worker, and frontend component state when supported;
  • current task-level periodic work status;
  • depth and oldest-item age for evaluation, fleet evaluation, notification, and external-alert durable queues;
  • an overall healthy, degraded, unhealthy, or unknown status.

A component whose latest observation is too old is returned as unreachable. observedStatus preserves the last state that component reported.

Example:

{
  "observedAt": "2026-08-05T12:00:00Z",
  "overallStatus": "healthy",
  "traceId": "f2a37bcb6f8c0da8b1c9c21057b67f16",
  "clusterSupported": true,
  "nodes": [
    {
      "id": "5d6a29de-4f31-4eb0-b11b-9aa9742fb2b4",
      "name": "lumetry-node-1",
      "status": "healthy",
      "lastObservedAt": "2026-08-05T11:59:50Z",
      "components": [
        {
          "kind": "worker",
          "status": "healthy",
          "observedStatus": "healthy",
          "configuredRole": "all",
          "version": "1.0.0",
          "lastObservedAt": "2026-08-05T11:59:50Z"
        }
      ]
    }
  ],
  "periodicTasks": [
    {
      "taskName": "agent-liveness",
      "status": "healthy",
      "nextDueAt": "2026-08-05T12:01:00Z",
      "running": false,
      "lastOutcome": "success"
    }
  ],
  "queues": [
    {
      "jobType": "rule_evaluation",
      "status": "healthy",
      "depth": 0,
      "oldestAgeSeconds": 0,
      "errorCode": null
    }
  ]
}

Application-node registration is deployment-specific. When it is unavailable, clusterSupported is false and nodes is empty; periodic work and queue status remain available.

The Tenant UI groups this view with Collectors and Agents under Deployment Status. Agent hosts, discovered processes, and collection packs remain agent-specific views. Read access uses the infrastructure-view permission; registration and configuration actions require infrastructure-management permission.

This endpoint is a concise troubleshooting surface. Use the deployment's metrics, traces, logs, dashboards, and alert rules for retained operational analysis.