← Cloudflare One / cloudflare-one / networks / connectors / cloudflare-tunnel / monitor-tunnels

Proudy protokolů

Protokoly tunelu zaznamenávají veškerou aktivitu mezi cloudflared instancí a globální sítí Cloudflare, stejně jako veškerou aktivitu mezi cloudflared a vaším origin serverem. Tyto protokoly vám umožňují prošetřit problémy s připojením nebo výkonem tunelu Cloudflare Tunnel. Server můžete nakonfigurovat tak, aby ukládal trvalé protokoly, nebo můžete protokoly streamovat v reálném čase z libovolného klientského zařízení.

Zobrazit protokoly na serveru

Pokud máte přístup k origin serveru, můžete použít --loglevel příznak povolit protokolování při spuštění tunelu. Ve výchozím nastavení cloudflared vypisuje protokoly do stdout a neukládá je na serveru. Volitelně můžete použít --logfile příznak k zápisu protokolů do souboru.

Chcete-li povolit protokoly, spusťte tunel pomocí --loglevel info a --logfile <PATH> příznaky. Například,

cloudflared tunnel --loglevel info --logfile cloudflared.log run <UUID>

Zobrazit protokoly na místním počítači

Protokoly Cloudflare Tunnel v reálném čase můžete zobrazit přes dashboard nebo z libovolného počítače, na kterém je cloudflared nainstalováno. Díky vzdáleným streamům protokolů se nemusíte přihlašovat přes SSH k serveru, na kterém tunel běží. Aby bylo možné získávat vzdálené protokoly, musí být tunel aktivní a schopný přijímat požadavky.

Dashboard

Chcete-li streamovat protokoly tunelu z dashboardu:

V Cloudflare dashboardu přejděte na Sítě > Tunnels a vyberte svůj tunel.
Přejděte na Tunnels ↗
Přejděte na Protokoly v reálném čase kartě.
Vyberte Naživo ke spuštění streamování.

Zobrazit protokoly pro repliku

Pokud používáte více cloudflared instance pro stejný tunel (známé také jako repliky), protokoly ze všech připojených replik se streamují automaticky a seskupují podle hostname, což usnadňuje identifikaci, který hostitelský počítač vytvořil danou položku protokolu.

Chcete-li omezit datový proud na konkrétní repliky, vyberte Filtr ikonu a rozbalte Repliky sekce. Můžete také filtrovat podle Úroveň protokolu a Typ události.

CLI

cloudflared démon dokáže streamovat protokoly libovolného tunelu ve vašem účtu do místního příkazového řádku. cloudflared musí být nainstalováno jak na vašem místním počítači, tak na origin serveru.

Na svém lokálním počítači ověřte cloudflared do vašeho účtu Cloudflare:
```
cloudflared tunnel login
```
Spustit cloudflared tail pro konkrétní tunel:
```
cloudflared tail <UUID>
```
Pro přehlednější zobrazení zprávy JSON můžete výstup přesměrovat do nástrojů, jako je jq ↗:
```
cloudflared tail --output=json <UUID> | jq .
```

Filtrovat protokoly

Protokoly můžete filtrovat podle typu události (--event), úroveň události (--level), nebo vzorkovací frekvence (-sampling) ke snížení objemu protokolů streamovaných z origin serveru. To pomáhá zmírnit dopad na výkon origin serveru, zejména když je origin server běžně vysoce vytížený. Například:

cloudflared tail --level debug <UUID>

Příznak	Popis	Povolené hodnoty	Výchozí hodnota
`--event`	Filtrujte podle typu události nebo požadavku.	`cloudflared`, `http`, `tcp`, `udp`	Všechny události
`--level`	Vrací protokoly na této úrovni a vyšší. Funguje nezávisle na `--loglevel` nastavení na serveru.	`debug`, `info`, `warn`, `error`, `fatal`	`debug`
`--sampling`	Vzorkuje zlomek z celkových protokolů.	Číslo od `0.0` na `1.0`	`1.0`

Zobrazit protokoly pro repliku

Pokud používáte více cloudflared instance pro stejný tunel (známé také jako repliky), musíte zadat konkrétní instanci, ze které se mají streamovat protokoly:

V Cloudflare dashboardu přejděte na Sítě > Tunnels a vyberte svůj tunel.
Přejděte na Tunnels ↗
Najděte ID Connectoru pro cloudflared instance, kterou chcete zobrazit.

Zadejte ID konektoru v cloudflared tail:

cloudflared tail --connector-id <CONNECTOR ID> <UUID>

Úvahy o výkonu

Relace protokolování zůstane otevřená pouze jednu hodinu. Všechny systémy protokolování do jisté míry zatěžují výkon a tento limit pomáhá zabránit dlouhodobému dopadu na latenci tunelu z jednoho konce na druhý.
Při streamování protokolů pro tunel s vysokou propustností Cloudflare záměrně upřednostňuje stabilitu služby před doručováním protokolů. Chcete-li snížit počet zahozených protokolů, zkuste vyžádání menšího počtu protokolů. Abyste měli jistotu, že vidíte všechny protokoly, zobrazit protokoly na serveru místo vzdáleného streamování protokolů.