← Cloudflare Workers / workers / observability / exporting-opentelemetry-data

Export do PostHog

PostHog je platforma pro produktovou analytiku, která vám pomáhá porozumět chování uživatelů a odhalovat chyby. Exportem telemetrie vaší aplikace Cloudflare Workers do PostHog můžete:

• Propojte logy s uživatelskými relacemi, událostmi a daty pro sledování chyb
• Dotazujte a filtrujte logy podle závažnosti, atributů a vlastních vlastností
• Propojte logy aplikace se záznamy relací (session replays) pro úplný kontext při ladění

Tento průvodce vás provede konfigurací vaší aplikace Cloudflare Worker tak, aby exportovala protokoly kompatibilní s OpenTelemetry do PostHog.

Než začnete, ujistěte se, že máte:

• Aktivní účet PostHog ↗ (k dispozici je bezplatná úroveň)
• Nasazený Worker, který chcete sledovat
• API klíč projektu PostHog

1. Přihlaste se ke svému účet PostHog ↗
2. Přejděte na Nastavení projektu ↗
3. Najděte svůj Klíč API projektu v sekci podrobností o projektu
4. Zkopírujte API klíč, jde o stejný klíč, který se používá pro zachytávání událostí a výjimek

Klíč API by měl vypadat nějak takto: phc_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

PostHog má různé koncové body v závislosti na vaší datové oblasti:

Svůj region najdete v nastavení projektu PostHog nebo podle adresy URL po přihlášení do PostHog (buď us.posthog.com nebo eu.posthog.com).

Nyní v Cloudflare dashboardu vytvoříte cíl, který směřuje do PostHog.

1. Přejděte do svého účtu Cloudflare Workers Observability ↗ sekce
2. Klikněte na Přidat cíl
3. Nakonfigurujte cíl svých logů:
   • Název cíle: posthog-logs (nebo jakýkoli popisný název)
   • Typ cíle: Vyberte Protokoly
   • OTLP Endpoint: Váš koncový bod protokolů PostHog (např. https://us.i.posthog.com/i/v1/logs nebo https://eu.i.posthog.com/i/v1/logs)
   • Vlastní hlavičky: Přidejte autentizační hlavičku:
     • Název hlavičky: Authorization
     • Hodnota hlavičky: Bearer <your-project-api-key> (např. Bearer phc_xxxxx...)
4. Klikněte na Save

Jakmile máte v Cloudflare dashboardu vytvořený destination, upravte konfiguraci svého Workeru tak, aby povolila export logů.

{
  "observability": {
    "logs": {
      "enabled": true,
      // Must match the destination name in the dashboard
      "destinations": ["posthog-logs"]
    }
  }
}

[observability.logs]
enabled = true
destinations = [ "posthog-logs" ]

Po úpravě konfigurace nasaďte Worker, aby se změny projevily.

Jakmile je váš Worker nasazený a přijímá provoz:

1. Přihlaste se ke svému účet PostHog ↗
2. Přejděte na Protokoly sekci v levém postranním panelu
3. Logy vašeho Workeru se zobrazí s úrovněmi závažnosti, časovými razítky a atributy

Protokoly můžete filtrovat podle:

• Úroveň závažnosti (trace, debug, info, warn, error, fatal)
• Časové rozmezí
• Vlastní atributy přidáno do vašich záznamů protokolu
• Klíčová slova ve zprávách protokolu

Do logů můžete přidat vlastní atributy pomocí standardních console metody se strukturovanými daty:

export default {
  async fetch(request, env) {
    // Basic logging
    console.log("Processing request");

    // Logs with additional context
    console.info("User action", {
      userId: "user_123",
      action: "api_call",
      path: new URL(request.url).pathname
    });

    // Error logging with details
    console.error("Request failed", {
      error: "Connection timeout",
      retryCount: 3
    });

    return new Response("OK");
  }
};

Tyto atributy bude možné v rozhraní PostHog logs vyhledávat a filtrovat.

1. Ověřte svůj klíč API: Ujistěte se, že používáte API klíč projektu (začíná na phc_), nikoli osobní API klíč
2. Zkontrolujte region endpointu: Ověřte, že používáte správný regionální endpoint (US nebo EU) odpovídající vaší instanci PostHog
3. Potvrďte stav cíle: V Cloudflare dashboardu ověřte, že vaše cílové místo zobrazuje nedávné úspěšné doručení
4. Kontrola vzorkovací frekvence: Pokud máte nastavenou vzorkovací frekvenci (sampling rate), nemusí se odeslat všechny protokoly

Pokud se ve stavu cíle zobrazují chyby ověřování:

• Zajistěte, že hodnota hlavičky Authorization obsahuje Bearer prefix následovaný vaším API klíčem
• Ověřte, že klíč API nebyl v PostHogu zrušen nebo znovu vygenerován
• Alternativně můžete token předat jako parametr dotazu pomocí https://us.i.posthog.com/i/v1/logs?token=<your-project-api-key> jako váš endpoint

• Dokumentace k protokolům PostHog ↗
• Začínáme s protokoly PostHog ↗
• specifikace OpenTelemetry Logs ↗