Skip to content

docs: add missing Prometheus metrics to documentation#19

Draft
Copilot wants to merge 3 commits intodocs/prometheus-docsfrom
copilot/sub-pr-18
Draft

docs: add missing Prometheus metrics to documentation#19
Copilot wants to merge 3 commits intodocs/prometheus-docsfrom
copilot/sub-pr-18

Conversation

Copy link

Copilot AI commented Jan 30, 2026

Eight metrics exported by prom_export.py were undocumented in the Prometheus integration guide.

Added Metrics Documentation

Connection Health & Performance:

  • meshmon_grpc_connection_errors_total - Error counter by type
  • meshmon_grpc_connection_duration_seconds - Connection lifetime histogram
  • meshmon_grpc_link_utilization_ratio - Link saturation gauge (0-1)
  • meshmon_grpc_queue_depth - Outbound message backlog

Timing & Updates:

  • meshmon_heartbeat_latency_seconds - Heartbeat RTT histogram
  • meshmon_store_update_size_bytes - Update payload size histogram

System Inventory:

  • meshmon_info - Version/build metadata
  • meshmon_networks_active - Active network count
  • meshmon_monitors_active - Per-network monitor count

Supporting Content

Each metric includes:

  • PromQL query examples for common use cases
  • Alert rules for connection errors, link saturation, and queue backlog
  • Recording rules for pre-aggregated metrics
  • Grafana dashboard panel suggestions

Fixes

Corrected existing histogram_quantile() queries to use rate() aggregation over histogram buckets:

# Before (incorrect)
histogram_quantile(0.99, meshmon_heartbeat_latency_seconds)

# After (correct)
histogram_quantile(0.99, rate(meshmon_heartbeat_latency_seconds_bucket[5m]))

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits January 30, 2026 03:55
Co-authored-by: S33G <655807+S33G@users.noreply.github.com>
Co-authored-by: S33G <655807+S33G@users.noreply.github.com>
Copilot AI changed the title [WIP] Fix missing stats in Prometheus documentation docs: add missing Prometheus metrics to documentation Jan 30, 2026
Copilot AI requested a review from S33G January 30, 2026 04:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants