Skip to content

Latest commit

 

History

History
90 lines (60 loc) · 1.21 KB

24-monitoring-usage.md

File metadata and controls

90 lines (60 loc) · 1.21 KB

Monitoring and Usage

Reflect tracks token usage, costs, and session activity for monitoring and debugging.


Usage Tracking

Token usage is tracked per session and aggregated.

View Usage

reflect usage
reflect doctor    # Full health report

Usage shows:

  • Input/output tokens per model
  • Total cost estimate
  • Session count

Telemetry

Reflect can send anonymous usage telemetry.

Enable/Disable

// ~/.reflect/settings.json
{
  "telemetry": {
    "enabled": false
  }
}

Or:

reflect --telemetry    # Enable
haw --no-telemetry  # Disable

OpenTelemetry Export

Export usage to your own OTEL collector:

{
  "telemetry": {
    "otel_enabled": true,
    "otel_endpoint": "https://collector.example.com:4318"
  }
}

Set OTEL_EXPORTER_OTLP_HEADERS for authentication.


Session Metrics

Per-session metrics include:

  • Turn count
  • Tool call count
  • Token totals
  • Duration

Accessible via /ecosystem in TUI.


Cloud Integration

Reflect Cloud provides managed usage tracking:

  • Organization-level metrics
  • Budget alerts
  • Entitlement management

See graycode-cloud documentation for details.


© 2026 GrayCode AI. All rights reserved.