---
title: "QueryIngestionAnalytics returns total counts of events ingested into the cluster."
method: POST
path: "/v1.1/analytics/event_ingestion"
tags: ["ControlService"]
---

# QueryIngestionAnalytics returns total counts of events ingested into the cluster.

`POST /v1.1/analytics/event_ingestion`

Returns success and error counts over the requested time range, grouped by the
 requested dimensions. Dimensions are optional; an empty list returns a single
 ungrouped total.
 Rate limited to 10 requests per minute (burst of 5), shared with QueryDeliveryAnalytics;
 exceeding the limit returns ResourceExhausted (HTTP 429).

## Request body

- ProtobufControlpbV1QueryIngestionAnalyticsRequest
  - `dimensions` string[], nullable — Dimensions group the results. Optional; an empty list returns a single ungrouped total. Duplicates are ignored. Each count in the response carries one dimensions entry per requested dimension. Events that fail ingestion before parsing may lack a write_key and event_name; their counts group under empty values. Allowed dimensions: - write_key (pipeline) - event_name (normalized, e.g. order_completed) - reason (populated for error counts; empty for successes)
  - `end` string, date-time, nullable — End of query range (exclusive)
  - `filters` union — Optional filters to narrow results. Filter fields combine with AND; values within a field with OR.
    - object, nullable
    - ProtobufStreamingpbV1IngestionStatFilters
      - `eventNames` string[], nullable — Normalized event names, e.g. order_completed.
      - `writeKeys` string[], nullable — Pipeline write keys.
  - `options` string[], nullable — Optional behaviors. INGESTION_ANALYTICS_OPTION_ACTIVE_PIPELINES: automatically filter to currently deployed pipeline write keys (mutually exclusive with write key filters).
  - `start` string, date-time, nullable — Start of query range (inclusive)

## Response `200`

OK

- ProtobufControlpbV1QueryIngestionAnalyticsResponse
  - `counts` union[], nullable
    - union
      - object, nullable
      - ProtobufStreamingpbV1IngestionStatCount
        - `dimensions` object, nullable — Dimension name to value for this group, one entry per requested dimension.
        - `errors` string — Events that failed ingestion and will not be processed. Unexpected data loss.
        - `success` string — Events successfully ingested to be processed by the system.
  - `end` string, date-time, nullable — End of query range (exclusive)
  - `start` string, date-time, nullable — Start of query range (inclusive)
  - `totalDelivered` string — Total number of events successfully ingested to be processed by the system.
  - `totalErrors` string — Total number of events that failed ingestion and will not be processed. Unexpected data loss.

## Other responses

- `4XX` — Something is wrong with your request such as missing or invalid data. Correct your request and try again.
- `5XX` — Internal server error. Try again later or reach out to MetaRouter support.

---

[API](https://skmtc.net/metarouter/apis/control-api.md) · [All operations](https://skmtc.net/metarouter/apis/control-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metarouter/control-api/versions/5afc05bfaaa2/schema)