Sign in →

Usage Ingestion

Monitor the metering pipeline in real time — pulse KPIs, source health, data quality, and performance — check per-meter health, inspect recent usage events, and bulk-upload event files.

Updated 2026-07-29Suggest edits

Usage Ingestion

Usage Ingestion (Intelligence → Usage Ingestion) is the operational view of your metering pipeline: what's flowing in, how healthy it is, and the ability to inspect or bulk-load events.

ℹ

Renamed from "Ingestion & Billable Units" on 2026-06-16. The old label collided with the Billable Units item under Catalog, where you define meters. This page is where you watch the usage that hits them — the name now reflects that.

Tabs

Overview (monitoring)

A pulse KPI strip — Events/min · Success Rate · Active Sources · Avg Latency — plus per-source metrics grouped by source type:

Source typeLabel
APIAPI Gateway
AGENTAI Agent
MCPMCP Server
FILEFile Upload
AGENTICAgentic

Each source shows event count, success rate, last-event time, and status (HEALTHY, DEGRADED, DOWN, THROTTLED). The Overview also reports data quality (validation pass rate, schema violations, dead letters, top errors) and performance (P99/P95/avg latency, throughput, backlog depth, throttling alerts).

Billable Units (metering health)

Per-meter health for every billable unit — event volume, error rate, latency, and Z-score anomaly detection — so a meter that suddenly stops, spikes, or starts erroring gets caught before it corrupts billing. This is the former standalone "Metering Health" page, folded in here on 2026-06-14; see Metering Health for the full breakdown.

Recent Events

A paginated table of raw usage_events, filterable by customer, metric name, product type (API, AGENTIC_API, AI_AGENT, MCP_SERVER), and time range. Each event shows its status:

StatusMeaning
ACCEPTEDIngested and counted
DUPLICATEIdempotency-key match — not double-counted
REJECTEDFailed validation

Click a row to open the full JSON payload in a detail drawer, or Export events to S3 or email.

File Upload

Drag-drop a CSV, JSON, NDJSON, or XML file (up to 50 MB). The wizard previews the file, maps columns to customerId, metricName, quantity, occurredAt, and idempotencyKey (with default metric/customer overrides), then ingests. Upload jobs track QUEUED → PROCESSING → COMPLETED (or PARTIAL / FAILED) with accepted/failed row counts.

ℹ

For programmatic ingestion patterns (gateway plugins, SDKs, webhooks, batch API), see the Protocols and Gateways docs.