Other languages logs installation

PostHog logs works with any OpenTelemetry-compatible client. Check the OpenTelemetry documentation for your specific language or framework.

  1. Install OpenTelemetry packages

    Required

    The key requirements are:

    • Use OTLP (OpenTelemetry Protocol) for log export over HTTP
    • Send logs to your PostHog logs endpoint (see configuration step below)
    • Include your project token in the Authorization header or as a ?token= query parameter

    Find the OpenTelemetry SDK for your language in the official registry.

  2. Get your project token

    Required

    You'll need your PostHog project token to authenticate log requests. This is the same key you use for capturing events and exceptions with the PostHog SDK.

    Important: Use your project token which starts with phc_. Do not use a personal API key (which starts with phx_).

    You can find your project token in Project Settings.

  3. Configure the SDK

    Required

    Configure your OpenTelemetry SDK to send logs to PostHog.

    Endpoint:

    https://us.i.posthog.com/i/v1/logs

    Authentication: Include your project token either as an Authorization header:

    Authorization: Bearer <ph_project_token>

    Or as a query parameter on the endpoint:

    https://us.i.posthog.com/i/v1/logs?token=<ph_project_token>

  4. Test your setup

    Recommended

    Once everything is configured, test that logs are flowing into PostHog:

    1. Send a test log from your application
    2. Check the PostHog logs interface for your log entries
    3. Verify the logs appear in your project
    View your logs in PostHog

  5. Next steps

    Checkpoint
    What you can do with your logs

    ActionDescription
    Search logsUse the search interface to find specific log entries
    Filter by levelFilter by INFO, WARN, ERROR, etc.
    Link session replayConnect logs to users and session replays by passing posthogDistinctId and sessionId
    Logging best practicesLearn what to log, how to structure logs, and patterns that make logs useful in production

    Troubleshoot common issues

Community questions

Was this page useful?

Questions about this page? or post a community question.