LLM Analytics Setup

Each provider reference contains installation instructions, SDK setup, and code examples specific to that provider or framework. Find the reference that matches the user’s stack and follow its instructions.

If the user’s provider isn’t listed, use manual-capture.md as a fallback — it covers the generic event capture approach that works with any provider.

Key principles

• Environment variables: Always use environment variables for PostHog and LLM provider keys. Never hardcode them.
• Minimal changes: Add LLM analytics alongside existing LLM calls. Don’t replace or restructure existing code.
• Trace all generations: Capture input tokens, output tokens, model name, latency, and costs for every LLM call.
• Link to users: Associate LLM generations with identified users via distinct IDs when possible.
• One provider at a time: Only instrument the provider(s) the user is actually using. Don’t add instrumentation for providers not present in the codebase.

Framework guidelines

• Remember that source code is available in the venv/site-packages directory
• posthog is the Python SDK package name
• Install dependencies with pip install posthog or pip install -r requirements.txt and do NOT use unquoted version specifiers like >= directly in shell commands
• In CLIs and scripts: MUST call posthog.shutdown() before exit or all events are lost
• Always use the Posthog() class constructor (instance-based API) instead of module-level posthog.api_key config
• Always include enable_exception_autocapture=True in the Posthog() constructor to automatically track exceptions
• NEVER send PII in capture() event properties — no emails, full names, phone numbers, physical addresses, IP addresses, or user-generated content
• PII belongs in identify() person properties, NOT in capture() event properties. Safe event properties are metadata like message_length, form_type, boolean flags.
• Register posthog_client.shutdown with atexit.register() to ensure all events are flushed on exit
• The Python SDK has NO identify() method — use posthog_client.set(distinct_id=user_id, properties={…}) to set person properties, or use identify_context(user_id) within a context