Loki日志查询

技能标识：loki-query

Query Loki logs via API for debugging and troubleshooting. Use when user needs to: (1) Query logs by traceid or keywords, (2) Filter logs by pod name, namespace, labels, or time range, (3) Debug application issues using structured log queries, (4) Analyze logs from Kubernetes pods. Accepts parameters like traceid, keywords, start_time, end_time, pod, namespace, labels, loki_url.

作者：admin | 来源记录：ClawHub

Loki 日志查询

使用内置脚本从 Grafana Loki 查询日志。

两种访问模式

1. 直接 URL 访问（推荐）

当 Loki 可通过网络访问时使用（云服务、远程服务器等）：

bash

使用远程 Loki URL

python scripts/query_loki.py \
--loki-url https://loki.example.com:3100 \
--query {namespace=\default\} \
--start now-1h \
--limit 50

2. Kubernetes 端口转发

当 Loki 仅可通过 kubectl 访问时使用：

bash

终端 1：端口转发 Loki

kubectl port-forward -n prometheus svc/loki 3100:3100

终端 2：查询日志

python scripts/query_loki.py \ --loki-url http://localhost:3100 \ --query {namespace=\default\}

或使用 kubectl exec 内联端口转发：

bash
kubectl exec -n prometheus -- curl -s http://localhost:3100/loki/api/v1/query_range?query={namespace=\default\}&limit=50

查询脚本

使用 scripts/query_loki.py 查询日志：

bash
python scripts/query_loki.py \
--loki-url http://localhost:3100 \
--query {namespace=default} \
--start now-1h \
--end now \
--limit 100

默认值： 如果未指定 --loki-url，则使用 http://localhost:3100。

常用查询模式

按命名空间

{namespace=}

按 Pod

{namespace=, pod=}

按标签

{namespace=, app=}

搜索关键词

{namespace=} |= ERROR
{namespace=} |= traceid=
{namespace=} |= Exception

时间范围

- 最近 1 小时：now-1h
最近 30 分钟：now-30m
指定范围：2026-03-27T10:00:00Z 至 2026-03-27T11:00:00Z

参数

- loki-url：Loki API 端点（默认：http://localhost:3100）
query：LogQL 查询字符串（必填）
start：开始时间（ISO 8601 或相对时间如 now-1h，默认：now-1h）
end：结束时间（ISO 8601 或相对时间如 now，默认：now）
limit：最大结果数（默认：100）
direction：forward 或 backward（默认：backward）
--json：输出原始 JSON 而非格式化文本

输出

返回格式化的日志行。每条记录显示时间戳和日志内容。

示例

查询过去一小时的错误日志

bash
python scripts/query_loki.py --query {namespace=production} |= ERROR

查询特定追踪 ID

bash
python scripts/query_loki.py --query {namespace=default} |= traceid=abc123

查询 Pod 日志并输出 JSON

bash
python scripts/query_loki.py --query {namespace=default,pod=my-app-0} --json

Loki日志查询