查詢持久日誌

查詢持久日誌

目的：為已驗證帳戶探索已上傳的 SSTable 檔案。

前置條件

• jsonlog 部署已啟用 PostgreSQL 後端查詢路由。
• 需有帶 acc 聲明的 Bearer 權杖以做帳戶隔離。
• 每個查詢請求本文都要提供 start_ts 與 end_ts。

API/Script 流程

1. 依時間範圍查詢檔案：
   • 以 { start_ts, end_ts } 呼叫 POST /query。
2. 依頻道/等級細化：
   • 增加可選的 channel、level、limit。
3. 查看聚合：
   • GET /query/stats。

HTTP/curl 流程

JSONLOG_BASE_URL="http://localhost:3002"
ACCESS_TOKEN="<account_scoped_token>"
START_TS="$(($(date +%s) * 1000 - 3600000))"
END_TS="$(($(date +%s) * 1000))"

curl -sS -X POST "${JSONLOG_BASE_URL}/query" \
  -H "authorization: Bearer ${ACCESS_TOKEN}" \
  -H "content-type: application/json" \
  --data "{\"start_ts\":${START_TS},\"end_ts\":${END_TS},\"channel\":\"svc-api\",\"limit\":100}"

curl -sS "${JSONLOG_BASE_URL}/query/stats" \
  -H "authorization: Bearer ${ACCESS_TOKEN}"

驗證

• 權杖缺失回傳 401。
• start_ts > end_ts 回傳 400。
• 成功回傳 200，內容含 { files, count }。
• 每個檔案都包含 media-gate 擷取用 path 與時間邊界中繼資料。

相關文件

• 查詢
• SSTableFile
• ProblemDetails