cx-dashboards

cx-dashboards builds and deploys a Coralogix observability dashboard for a target service, driven by the service's own telemetry — logs, spans, metrics, and service specs. It solves the tedious and error-prone work of authoring correct Coralogix dashboard JSON: it discovers the service's real metric names, log fields, and span attributes (only using ones it can cite from code, README, config, or a live query result rather than inventing them), emits importable Coralogix JSON, and verifies every PromQL and DataPrime query live through the cx CLI before deploying.

The workflow is a strict multi-phase checklist: discover telemetry and business meaning, gather dashboard specifications from the user, draft an internal plan of sections and widgets, generate the JSON, live-verify every query, self-verify structure, run a server-side validation via `cx dashboards check`, deploy with `cx dashboards create`, and finally share a clickable dashboard link. It ships reference material on DataPrime and PromQL syntax, log and span field discovery, dashboard query gotchas, and widget JSON templates. Supporting cx commands let it list the dashboard catalog, fetch an existing dashboard as a template, manage folders, and replace or duplicate dashboards.

It targets observability engineers, SREs, and developers using Coralogix who want a repeatable, verified path from a service to a working monitoring dashboard. The cx CLI operations involved are read-only telemetry queries plus dashboard create/replace calls against the user's own Coralogix account; there is no destructive or offensive behavior, and the emphasis on live-verifying queries and never fabricating field names makes it a careful, benign authoring tool.