Observability & Metrics

# Expose the /metrics endpoint
export FERAL_METRICS_ENDPOINT=1

# Start FERAL
feral serve

scrape_configs:
  - job_name: feral
    static_configs:
      - targets: ["localhost:9090"]
    metrics_path: /metrics

pip install feral-ai[observability]

export OTEL_EXPORTER_OTLP_ENDPOINT=https://otlp.example.com:4318

# Optional: also log metrics to console
export FERAL_METRICS_CONSOLE=1

from observability.metrics import increment, observe, measure, in_memory_snapshot

# Counter
increment("my_custom.counter", attributes={"env": "prod"})

# Histogram
observe("my_custom.latency_ms", 42.5)

# Context manager (auto-records duration)
with measure("my_custom.operation"):
    do_work()

# Debug snapshot
print(in_memory_snapshot())