# Grafana Loki

LogQL search, aggregation, and stream discovery on Grafana Loki.

Run these through `omni-cli` once a human has connected the platform (`omni-cli loki login`). Full parameter and output schemas come from `omni-cli discovery loki`.

## index

| Command | What it does | Kind |
|---|---|---|
| `omni-cli loki index stats` | Index statistics for a selector — counts of streams, chunks, entries, and bytes. Counts indexed (flushed) data only, so just-ingested logs may report zero until chunks flush. | read |
| `omni-cli loki volume history` | Log volume over a time range as a series of datapoints (requires volume_enabled in the Loki config). | read |
| `omni-cli loki volume list` | Log volume per label/label-value combination at a point in time — finds high-volume streams (requires volume_enabled in the Loki config). | read |

## discovery

| Command | What it does | Kind |
|---|---|---|
| `omni-cli loki label list` | List label names present within a time range — the starting point for building LogQL selectors. | read |
| `omni-cli loki label values` | List the values of one label within a time range (from label.list). | read |
| `omni-cli loki stream list` | List log streams (label sets) matching one or more LogQL selectors. | read |

## query

| Command | What it does | Kind |
|---|---|---|
| `omni-cli loki log aggregate` | Evaluate a metric LogQL query (rate, count_over_time, ...) at a single point in time — a bare log selector is rejected (400); use log.search for log lines. | read |
| `omni-cli loki log search` | Search log lines over a time range with LogQL (also runs range metric queries). | read |
| `omni-cli loki pattern list` | Detected log-line patterns for a selector with per-bucket counts — surfaces dominant or anomalous log shapes during triage (requires the pattern ingester). | read |

## ingest

| Command | What it does | Kind |
|---|---|---|
| `omni-cli loki log push` | Push log entries into Loki (JSON push API) — entry timestamps must be Unix-nanosecond strings. | write |