Loki 日志查询

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

两种访问模式

1. 直接 URL 访问（推荐）

适用于 Loki 可通过网络访问的场景（例如云服务、远程服务器等）：

# 使用远程 Loki URL
python scripts/query_loki.py 
  --loki-url "https://loki.example.com:3100" 
  --query "{namespace=\"default\"}" 
  --start "now-1h" 
  --limit 50

2. Kubernetes port-forward

适用于仅能通过 kubectl 访问 Loki 的场景：

# 终端 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 进行端口转发：

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

查询脚本

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

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 格式输出，而非格式化文本

输出格式

返回格式化的日志条目，每条记录包含时间戳和日志内容。

使用示例

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

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

查询特定 trace ID 的日志

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

查询某 Pod 日志并以 JSON 格式输出

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