This page is the authoritative per-metric reference for the GET /prometheus endpoint exposed by the Colony monitor process. Every row corresponds to one metric family emitted by formatPrometheus() in packages/monitor/src/prometheus.ts.
The parity test at packages/monitor/src/__tests__/prometheus-doc-parity.test.ts asserts that this table exactly matches the rendered output. If you add, rename, or remove a metric in prometheus.ts, update this table and the test will pass; if you forget, the test fails.
| Metric name | Type | Description |
|---|
colony_agent_up | gauge | Whether the agent health endpoint is reachable (1=up, 0=down). |
colony_agent_poll_count_total | counter | Total poll count reported by the agent. |
colony_agent_consecutive_failures | gauge | Consecutive poll failures reported by the agent. |
colony_agent_cost_usd_total | counter | Cumulative cost in USD reported by the agent. |
colony_agent_uptime_seconds | gauge | Agent uptime in seconds. |
colony_agent_response_time_ms | gauge | Response time of the last health poll in milliseconds. |
colony_agent_in_flight_issues | gauge | Number of in-flight issues for the agent. |
| Metric name | Type | Description |
|---|
colony_alerts_active | gauge | Number of active alerts by detector and severity. |
| Metric name | Type | Description |
|---|
colony_pipeline_issues_by_state | gauge | Current issues per pipeline state and repo. |
colony_pipeline_paused_issues | gauge | Number of currently-paused issues per repo. |
colony_intelligence_items | gauge | Intelligence items by repo and promotion state (pending awaiting review, auto_promoted by retrospector). |
colony_tenant_spend_usd | gauge | Current month spend per tenant in USD. |
| Metric name | Type | Description |
|---|
colony_pipeline_throughput_per_day | gauge | Issues processed per day by repo. |
colony_pipeline_median_cycle_time_ms | gauge | Median issue cycle time in milliseconds. |
colony_pipeline_avg_cost_per_issue_usd | gauge | Average cost per issue in USD. |
colony_pipeline_review_pass_rate | gauge | Review pass rate (0-1). |
colony_pipeline_median_time_to_first_pr_ms | gauge | Median time from issue open to first PR in ms. |
colony_pipeline_median_pr_cycle_time_ms | gauge | Median time from PR open to merge in ms. |
colony_pipeline_avg_review_cycles_per_pr | gauge | Average review cycles per PR. |
colony_pipeline_pr_revert_rate | gauge | PR revert rate (0-1). |
| Metric name | Type | Description |
|---|
colony_queue_depth | gauge | Pending task count by repo and task type. |
colony_worker_idle | gauge | Number of idle workers by repo. |
colony_worker_busy | gauge | Number of busy workers by repo. |
colony_worker_offline | gauge | Number of offline workers by repo. |
colony_worker_draining | gauge | Number of draining workers by repo. |
colony_worker_degraded | gauge | Number of degraded workers by repo. |
colony_worker_error | gauge | Number of workers in error state by repo. |
colony_worker_paused | gauge | Number of paused workers by repo. |
colony_stale_leases | gauge | Current count of claimed tasks with stale heartbeats by repo. |
colony_stalled_leases | gauge | Current count of claimed tasks whose executor has stopped making progress, by repo. |
colony_projection_queue_depth | gauge | Pending VCS write projections awaiting retry by repo. |
colony_worker_build_skew | gauge | Whether a worker build_id differs from the declared COLONY_EXPECTED_BUILD (1=skewed, 0=matches). |
colony_github_provider_available | gauge | Whether the GitHub provider is available for the repo, based on worker pause state (1=available, 0=rate-limited). |
| Metric name | Type | Description |
|---|
colony_nomad_pool_expected | gauge | Expected nomad replica count per tenant (from pool_size config). |
colony_nomad_pool_actual | gauge | Actual heartbeat-fresh nomad replica count per tenant. |
colony_nomad_replica_status | gauge | Nomad replica count by tenant and status. |
| Metric name | Type | Description |
|---|
colony_projections_failed_total | gauge | VCS projections that permanently failed after exhausting all retries. |
colony_dependency_resolution_failures_total | gauge | Unresolved dependency-resolution failures recorded as dead letters after syncIssueState retries were exhausted. |
| Metric name | Type | Description |
|---|
colony_task_duration_seconds | summary | Task execution duration in seconds by agent, repo, and outcome. |
colony_task_lifecycle_total | gauge | Count of task lifecycle events by type. |
colony_worker_heartbeat_age_seconds | gauge | Seconds since the last worker heartbeat. |
| Metric name | Type | Description |
|---|
colony_sprint_master_poll_cycle_seconds | gauge | Duration of the last sprint-master poll cycle in seconds. |
| Metric name | Type | Description |
|---|
colony_cache_hits_per_cycle | gauge | ETag cache hits in the last sprint-master poll cycle (ops GitHub client). |
colony_cache_misses_per_cycle | gauge | ETag cache misses in the last sprint-master poll cycle (ops GitHub client). |
colony_full_sync_count_total | counter | Cumulative number of full GitHub syncs performed by sprint-master. |
colony_full_sync_discrepancies_total | counter | Cumulative issue discrepancies found in full syncs by sprint-master. |
colony_webhook_events_received_total | counter | Cumulative webhook events routed to the sprint-master cache. |
colony_github_rate_limit_remaining | gauge | GitHub API rate-limit remaining calls for the repo ops client after the last sprint-master poll cycle. |
| Metric name | Type | Description |
|---|
colony_issues_stalled_total | gauge | Number of stalled issues by repo and state. |
| Metric name | Type | Description |
|---|
colony_task_queue_depth | gauge | Current number of pending and claimed tasks by repo, task type, and status. |
colony_task_queue_wait_seconds | histogram | Wait time in seconds from task creation to now for pending tasks, by repo and task type. |
| Metric name | Type | Description |
|---|
colony_consistency_findings | gauge | Consistency findings detected by kind and repo. |
colony_consistency_repairs_total | counter | Consistency repairs applied by kind and source (manual or auto). |
| Metric name | Type | Description |
|---|
colony_health_kpi_current | gauge | Current KPI value over the evaluation window. |
colony_health_kpi_baseline | gauge | Baseline KPI value over the reference window. |
colony_health_kpi_relative_delta | gauge | Relative delta between current and baseline KPI values ((current-baseline)/|baseline|). |
colony_health_kpi_regressed | gauge | Whether the KPI has regressed beyond the configured threshold (1=regressed, 0=ok). |
colony_health_kpi_sample_size | gauge | Sample size of the current evaluation window. |
| Metric name | Type | Description |
|---|
colony_scope_drift_ratio | gauge | Average drift ratio (unplanned + missed planned files / total) per repo over the scrape window. |
colony_scope_drift_unplanned_files_total | gauge | Total unplanned files touched across PRs in the scrape window. |
colony_scope_drift_prs_total | gauge | Number of PRs exhibiting scope drift in the scrape window. |
