Observability¶

Logging, monitoring, and telemetry for Echo Agent.

Logging¶

Echo Agent uses Loguru for structured logging.

Log Levels¶

Configure via environment variable:

export ECHO_AGENT_OBSERVABILITY__LOG_LEVEL=DEBUG  # DEBUG, INFO, WARNING, ERROR

Log Locations¶

Console: stderr (foreground mode)
File: ~/.echo-agent/logs/ (when running as service)
Gateway API: GET /api/v1/logs (Dashboard Logs page)

Gateway Health¶

curl http://127.0.0.1:58123/api/v1/health

Returns: status (healthy/degraded/unhealthy), active channels, WebSocket clients, provider status, rate limiter stats.

OpenTelemetry¶

Enable OTLP export:

OTel settings are flat fields under observability prefixed with otel_; there is no nested otlp section:

observability:
  otel_enabled: true                     # default true
  otel_endpoint: "http://localhost:4317" # nothing is exported while empty
  otel_service_name: echo-agent
  otel_export_interval_ms: 5000
  trace_enabled: true

otel_enabled is on by default, but otel_endpoint is empty by default — with no endpoint set, nothing is exported. There are no protocol or headers fields.

Requires the otel extra:

pip install "echo-agent[otel]"

Exports traces and metrics via OTLP gRPC.

Cost Analytics¶

echo-agent cost --days 7
echo-agent cost --days 30 --json

Dashboard Analytics page provides per-model token usage and cost breakdown.

Sensitive Data¶

Warning

Logs may contain conversation metadata. Review observability config for redaction settings before shipping logs to external systems.