Module Metrics

AirLibrary

Module Metrics 

Source
Expand description

§Metrics Collection and Export Module

Provides Prometheus-compatible metrics collection and export for the Air daemon. Includes request latency histograms, resource usage metrics, error rate tracking, thread-safe metric updates with overflow protection, and aggregation validation.

§Responsibilities

§Request Metrics

  • Total request count tracking with counter overflow protection
  • Success/failure rate calculation
  • Latency histogram with bucket aggregation
  • Request throughput measurement

§Error Metrics

  • Total error count with classification
  • Error rate calculation by type
  • Error aggregation and validation
  • Error threshold alerting

§Resource Metrics

  • Memory usage monitoring with allocation tracking
  • CPU utilization percentage
  • Active connection count
  • Thread activity monitoring
  • Resource pool utilization

§Service-Specific Metrics

  • Authentication success/failure tracking
  • Download completion rates
  • Indexing operation metrics
  • Update deployment statistics

§Integration with Mountain

Metrics flow directly to Mountain’s telemetry UI:

  • Prometheus exposition format endpoint
  • Real-time metric streaming
  • Historical data retention
  • Custom dashboards and alerting

§VSCode Telemetry References

Similar telemetry patterns used in VSCode for:

  • Performance monitoring and profiling
  • Usage statistics and feature adoption
  • Error tracking and crash reporting
  • Extension marketplace analytics

Reference: vs/workbench/services/telemetry

§Thread Safety

All metric updates are thread-safe using:

  • Arc for shared ownership across threads
  • Atomic operations where possible
  • Mutex locks for complex aggregations
  • Lock-free counters for high-frequency updates

§TODOs

  • [DISTRIBUTED TRACING] Integrate with OpenTelemetry for distributed tracing metrics
  • [CUSTOM METRICS] Add custom metric types for business KPIs
  • ALERTING: Implement metric-based alerting thresholds
  • AGGREGATION: Add time-windowed aggregations (1m, 5m, 15m)
  • EXPORT: Add support for external monitoring systems (Datadog, New Relic)

§Sensitive Data Handling

Metrics aggregation ensures sensitive data is excluded:

  • No request payloads in metrics
  • No authentication tokens in labels
  • No user-identifiable information in error classifications
  • IP addresses and PII are aggregated, not logged individually

Structs§

AggregationValidator 🔒
Aggregation validation for metric integrity
MetricGuard 🔒
Overflow-protected metric update helper
MetricsCollector
MetricsCollector for collecting and exporting Prometheus metrics with thread safety
MetricsData
Structured metrics data for serialization

Statics§

METRICS_INSTANCE 🔒
Global metrics collector instance

Functions§

GetMetrics
Get or initialize the global metrics collector
InitializeMetrics
Initialize the global metrics collector
MinMaxUpdate 🔒
Helper function to update min/max values atomically