---
title: "Get Counter Total"
method: GET
path: "/v1/telemetry/counters/{metric_name}/total"
tags: ["Dome", "Telemetry"]
---

# Get Counter Total

`GET /v1/telemetry/counters/{metric_name}/total`

## Request

- The document declares no server URL.
- Auth: none declared
- TypeScript: <https://skmtc.dev/vijilai/apis/vijil-console-api-combined/docs/v1/telemetry/counters/:metric_name/total/get.ts> (a function with typed inputs; its response is checked against the schema)

Get total counter value.

## Path parameters

- `metric_name` string, required

## Query parameters

- `time_range` '15m' | '30m' | '1h' | '2h' | '6h' | '1d' | '7d' | '30d': Time range: 15m, 30m, 1h, 2h, 6h, 1d, 7d, 30d
- `evaluation_id` string, nullable: Filter by evaluation ID
- `test_id` string, nullable: Filter by test ID
- `probe_id` string, nullable: Filter by probe ID
- `agent_configuration_id` string, nullable: Filter by agent configuration ID

## Response `200`

Successful Response

- CounterTotalResponse: Response model for counter total with metric and label information
  - `metric` string, required: Metric name
  - `total_count` number, required: Total counter value
  - `labels` MetricLabels: Structured metric labels for telemetry data
    - `agent_id` string, nullable: Agent ID (same as agent_configuration_id)
    - `deployment_environment` string, nullable: Deployment environment (e.g., production, staging)
    - `exported_job` string, nullable: Exported job identifier
    - `job` string, nullable: Job name (e.g., otel-collector)
    - `service_name` string, nullable: Service name (e.g., vijil.dome)
    - `service_namespace` string, nullable: Service namespace
    - `service_version` string, nullable: Service version
    - `team_id` string, nullable: Team ID
    - `user_id` string, nullable: User ID
    - `evaluation_id` string, nullable: Evaluation ID filter

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vijilai/apis/vijil-console-api-combined.md) - [All operations](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/llms.txt) - [OpenAPI document](https://skmtc.dev/vijilai/apis/vijil-console-api-combined/revisions/a8b2ee2b2d06?raw)