---
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`

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.net/vijilai/apis/vijil-console-api-combined.md) · [All operations](https://skmtc.net/vijilai/apis/vijil-console-api-combined/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vijilai/vijil-console-api-combined/revisions/a8b2ee2b2d06/schema)