Skip to main content

Query Logs

Search logs across the platform via voice, chat, or Grafana.

Via Voice or Chat​

You: "Show me errors from norns-agent in the last hour"

Norns: "Found 3 errors in the last hour:

  1. 10:23 - ConnectionError: Redis connection refused
  2. 10:45 - TimeoutError: Tool execution timed out
  3. 11:02 - ValidationError: Invalid task ID format"

Via Grafana/Loki​

  1. Go to grafana.ravenhelm.dev
  2. Click Explore
  3. Select Loki data source
  4. Use LogQL:
{container="norns-agent"} |= "error" | json

Tool Reference​

query_logs​

{
  "name": "query_logs",
  "domain": "observability",
  "input_schema": {
    "container": "string (required)",
    "level": "error|warn|info|debug",
    "since": "1h, 30m, 1d",
    "query": "text to search for",
    "limit": "number (default 50)"
  }
}

Common Log Queries​

WhatLogQL
All errors{container=~".+"} |= "error"
Specific container{container="norns-agent"}
HTTP 500s{container="traefik"} |= "500"
Slow queries{container="postgres"} |= "duration"

See Also​

  • [[Debug-Failing-Service]] - Troubleshooting
  • [[View-LLM-Traces]] - AI debugging
  • [[../Observability/Loki]] - Loki setup