---
title: "Get Logs"
method: GET
path: "/v1/telemetry/logs"
tags: ["Dome", "Telemetry"]
---

# Get Logs

`GET /v1/telemetry/logs`

Get logs.

## Query parameters

- `time_range` '15m' | '30m' | '1h' | '2h' | '6h' | '1d' | '7d' | '30d' — Window to pull logs for
- `service_name` string, nullable — Filter by service_name label
- `level` string, nullable — Filter by level label
- `job` string, nullable — Filter by job label
- `exporter` string, nullable — Filter by exporter label
- `agent_configuration_id` string, nullable — Restrict to a specific agent configuration id
- `evaluation_id` string, nullable — Restrict logs to an evaluation id
- `test_id` string, nullable — Restrict logs to a test id
- `probe_id` string, nullable — Restrict logs to a probe id
- `search` string, nullable — Substring search applied via LogQL pipeline
- `logql` string, nullable — Advanced LogQL expression (overrides generated selector when provided)
- `limit` integer — Maximum log lines to return
- `direction` 'forward' | 'backward' — Return order for log entries

## Response `200`

Successful Response

- LogsQueryResponse
  - `query` string, required — Executed LogQL query
  - `direction` 'forward' | 'backward', required — Result ordering
  - `start_ns` integer, required — Start window in nanoseconds
  - `end_ns` integer, required — End window in nanoseconds
  - `streams` LogStreamResponse[]
    - `labels` object
    - `entries` LogEntryResponse[]
      - `timestamp` integer, required — Unix timestamp in nanoseconds
      - `line` string, required — Log message
  - `next_timestamp` integer, nullable — Bookmark timestamp for pagination

## 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/versions/a8b2ee2b2d06/schema)