JL
ES
Inicio de documentación
Menú
Guías

Consultar Logs Durables

Descubre archivos SSTable por cuenta usando los endpoints /query.

guide jsonlog

Consultar Logs Durables

Objetivo: descubrir archivos SSTable subidos para una cuenta autenticada.

Precondiciones

  • Las rutas de consulta respaldadas por PostgreSQL están habilitadas en el despliegue de jsonlog.
  • Ten un token Bearer con claim acc para aislamiento por cuenta.
  • Proporciona start_ts y end_ts en cada cuerpo de consulta.

Flujo De API/Script

  1. Consultar archivos en rango de tiempo:
    • POST /query con { start_ts, end_ts }.
  2. Refinar por canal/nivel:
    • Agrega channel, level y limit opcionales.
  3. Revisar agregados:
    • GET /query/stats.

Flujo 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}"

Validación

  • Si falta token devuelve 401.
  • start_ts > end_ts devuelve 400.
  • El éxito devuelve 200 con { files, count }.
  • Cada archivo incluye path para descarga vía media-gate y metadatos de rango temporal.

Documentación Relacionada