Logfire Read Skill

Use this skill to read Logfire records with JSONL output using the repo’s reader utilities.

Quick Start

1. Load .env from the repo root:

set -a
. ./.env
set +a

2. Run the JSONL reader:

python scripts/logfire-fetch.py

Or use the bundled script:

./.codex/skills/logfire-read/scripts/read_logs.sh --message-like "Processing failed" --limit 10

Agent-Friendly CLI

Use the agent helper for targeted queries:

python scripts/logfire-read-agent.py --since 2026-01-11T00:00:00Z --message-like "Processing failed" --limit 10

Module API

Use query_logfire() for programmatic access:

from logger import query_logfire

rows = query_logfire(jsonl=True, level=21, message_like="Processing failed", limit=10)
for row in rows:
    print(row)

Environment Variables

Required:

• LOGFIRE_READ_URL (e.g., https://logfire-us.pydantic.dev/v1/query)
• LOGFIRE_READ_TOKEN

Optional filters:

• LOGFIRE_READ_COLUMNS
• LOGFIRE_READ_LIMIT
• LOGFIRE_READ_SINCE
• LOGFIRE_READ_LEVEL
• LOGFIRE_READ_MESSAGE_LIKE
• LOGFIRE_READ_TRACE_ID
• LOGFIRE_READ_SPAN_ID
• LOGFIRE_READ_JSONL=true

Output Format

• JSONL output returns one JSON object per record.
• level is converted to severity strings (trace, debug, info, warn, error, fatal).