Optimum Gateway Metrics
Gateway Metrics
When telemetry_enable: true, metrics are exposed at http://localhost:48123/metrics.
All gateway metrics include the gateway_id label.
Always Present (at startup)
| Metric | Type | Description |
|---|---|---|
optp2p_gateway_optimum_gateway_app_build_info | Gauge | Build info: version, commit, go, public_ip |
optp2p_gateway_optimum_gateway_opt_peers | Gauge | mump2p peers connected |
optp2p_gateway_optimum_gateway_opt_peer_connected_total | Counter | Cumulative mump2p peer connections |
optp2p_gateway_optimum_gateway_aggregation_included_total | Counter | Messages included in emitted aggregated protobufs |
optp2p_gateway_optimum_gateway_system_cpu_cores | Gauge | Logical CPU cores |
nodes_active_total | Gauge | Active nodes in the proxy (0 when running gateway without proxy) |
optimum_p2p_active_topics | Gauge | Active mump2p topic subscriptions |
With CL Peer Connected
When a CL client connects to the gateway and subscribes to topics, these metrics appear:
| Metric | Type | Labels | Description |
|---|---|---|---|
optp2p_gateway_optimum_gateway_cl_peers | Gauge | — | CL peers connected to gateway |
optp2p_gateway_optimum_gateway_cl_peer_connected_total | Counter | — | Cumulative CL peer connections |
optp2p_gateway_optimum_gateway_cl_peer_disconnected_total | Counter | — | Cumulative CL peer disconnections |
optp2p_gateway_optimum_gateway_cl_peers_per_topic | Gauge | topic | CL peers connected per topic |
optp2p_gateway_optimum_gateway_libp2p_total_messages | Counter | — | Messages delivered into all libp2p topics |
optp2p_gateway_optimum_gateway_libp2p_published_messages_per_topic_total | Counter | topic | Messages published to libp2p per topic |
optp2p_gateway_optimum_gateway_optimum_total_messages | Counter | — | Messages sent to mump2p |
optp2p_gateway_optimum_gateway_optimum_published_messages_per_topic_total | Counter | topic | Messages published to mump2p per topic |
optp2p_gateway_optimum_gateway_opt_peers_per_topic | Gauge | topic | mump2p peers per topic |
optp2p_gateway_optimum_gateway_opt_peer_disconnected_total | Counter | — | Cumulative mump2p peer disconnections |
optp2p_gateway_optimum_gateway_mump2p_messages_from_origin_total | Counter | origin_gateway_id | Messages received from each origin gateway |
optp2p_gateway_optimum_gateway_mump2p_messages_from_upstream_total | Counter | upstream_peer_id | Messages received from each upstream mump2p peer |
optp2p_gateway_optimum_gateway_message_size_bytes | Histogram | topic | Size of messages received over libp2p |
optp2p_gateway_optimum_gateway_message_size_min | Gauge | topic | Minimum message size (bytes) |
optp2p_gateway_optimum_gateway_message_size_mean | Gauge | topic | Mean message size (bytes) |
optp2p_gateway_optimum_gateway_message_size_max | Gauge | topic | Maximum message size (bytes) |
optp2p_gateway_optimum_gateway_processing_time_nanoseconds | Histogram | process | Processing duration; process is cl_processing or opt_processing |
Block Arrival & First-Seen Metrics
When telemetry is enabled and both CL and mump2p paths are active, these metrics track per-block performance:
| Metric | Type | Labels | Description |
|---|---|---|---|
optp2p_gateway_optimum_gateway_block_arrival_mump2p_ms | Histogram | — | Block arrival latency via mump2p relative to slot start (ms) |
optp2p_gateway_optimum_gateway_block_arrival_libp2p_ms | Histogram | — | Block arrival latency via libp2p relative to slot start (ms) |
optp2p_gateway_optimum_gateway_blocks_first_seen_mump2p_total | Counter | — | Blocks where mump2p delivered strictly before libp2p |
optp2p_gateway_optimum_gateway_blocks_first_seen_libp2p_total | Counter | — | Blocks where libp2p delivered before or equal to mump2p |
Geolocation
| Metric | Type | Labels | Description |
|---|---|---|---|
optp2p_gateway_det_coordinates_geo_location | Gauge | country, latitude, longitude | Gateway geolocation coordinates |
Process Metrics
Standard Go and process metrics (go_*, process_*) are exposed for resource monitoring.
Quick Checks
sh
curl -s http://localhost:48123/metrics | grep optp2p_gatewayWith CL connected: cl_peers ≥ 1, libp2p_total_messages increments, optimum_total_messages increments.