Documentation / API Server Health and Metrics / Metrics Troubleshooting

Metrics Troubleshooting

Diagnose empty metrics, stale health checks, missing services, and advisor result issues.

Diagnose empty metrics, stale health checks, missing services, and advisor result issues.

Coverage

ItemStatus
Check table existenceUse deployed route documentation
Check cron/worker stateUse deployed route documentation
Check token roleUse deployed route documentation
Check polling frequencyUse deployed route documentation

Workflow

  1. Confirm each route against the deployed route documentation.
  2. Test with a staging token first.
  3. Use read endpoints to inspect current state before any write operation.
  4. Record the external workflow ID in your own system.
  5. Review jobs, request logs, and audit logs after the workflow runs.

Notes

  • Do not create production automation around undocumented routes.
  • Use idempotency keys for write endpoints.
  • Keep rollback steps documented with the integration runbook.

Diagram

flowchart TD
    A[External System] --> B[Read Current State]
    B --> C{Expected State?}
    C -- No --> D[Stop and Alert]
    C -- Yes --> E[Run Approved Workflow]
    E --> F[Read Jobs and Logs]
    F --> G[Operator Review]
← Metrics and Alerting Concepts