← Privacy Proxy / privacy-proxy / reference / metriky

OpenTelemetry

Privacy Proxy exportuje telemetrická data pomocí OpenTelemetry Protocol (OTLP) ↗. Můžete nakonfigurovat endpoint, který tato data přijme a přepošle na vaši platformu pro observabilitu.

Konfigurace exportu telemetrie

Během onboardingu poskytněte Cloudflare endpoint svého kolektoru OpenTelemetry:

URL endpointu: HTTPS endpoint, na který se mají odesílat telemetrická data.
Ověřování: hlavičky nebo přihlašovací údaje potřebné k autentizaci vůči vašemu kolektoru. Podporované typy autentizace zahrnují hlavičky s bearer tokenem, vlastní autentizaci založenou na hlavičkách a vzájemné TLS (mTLS).

Cloudflare nakonfiguruje vaši instanci Privacy Proxy tak, aby exportovala telemetrii na tento endpoint.

Podporované signály

Privacy Proxy exportuje následující telemetrické signály:

Signal	Popis
Metriky	Počty připojení, četnost požadavků, histogramy latence, chybovost
Trasování	Trasování jednotlivých požadavků zobrazující dobu zpracování v proxy. Trasy se vzorkují přibližně u 1 % požadavků.

Metriky

Privacy Proxy exportuje metriky, které vám pomáhají porozumět vzorům používání a výkonu.

Metriky připojení

Metrika	Popis
`privacy_proxy_connections_total`	Celkový počet spojení proxy
`privacy_proxy_connections_active`	Aktuálně aktivní připojení
`privacy_proxy_connections_duration_seconds`	Histogram doby trvání připojení

Metriky požadavků

Metrika	Popis
`privacy_proxy_requests_total`	Celkový počet zpracovaných požadavků CONNECT
`privacy_proxy_requests_by_status`	Požadavky seskupené podle stavového kódu odpovědi
`privacy_proxy_bytes_sent_total`	Celkový počet bajtů odeslaných do cílů
`privacy_proxy_bytes_received_total`	Celkový počet bajtů přijatých od cílů

Metriky latence

Metrika	Popis
`privacy_proxy_connect_latency_seconds`	Doba navázání spojení s cílem
`privacy_proxy_first_byte_latency_seconds`	Doba do prvního bajtu od cíle

`Server-Timing` hlavička

Privacy Proxy obsahuje Server-Timing hlavička v odpovědích pomáhá měřit latenci zpracování z pohledu klienta. Úplné podrobnosti o formátu hlavičky najdete v HTTP hlavičky.

Server-Timing: proxy;dur=12.5

dur hodnota představuje dobu zpracování v milisekundách, kterou přidává proxy. Tuto hlavičku použijte jako SLI (Service Level Indicator) na straně klienta ke sledování výkonu proxy.

Příklad: Prometheus a Grafana

Chcete-li vizualizovat metriky Privacy Proxy v Grafaně:

Nakonfigurujte kolektor OpenTelemetry pro příjem dat z Privacy Proxy.
Exportujte metriky z kolektoru do nástroje Prometheus.
Vytvářejte dashboardy Grafana s nástrojem Prometheus jako zdrojem dat.

Příklady dotazů Prometheus

# Request rate over time
rate(privacy_proxy_requests_total[5m])

# 95th percentile connection latency
histogram_quantile(0.95, rate(privacy_proxy_connect_latency_seconds_bucket[5m]))

# Error rate
sum(rate(privacy_proxy_requests_by_status{status=~"5.."}[5m])) / sum(rate(privacy_proxy_requests_total[5m]))

Dokumentace OpenTelemetry ↗ : další informace o konceptech a konfiguraci OpenTelemetry.
GraphQL Analytics API : dotazuje se na metriky programově prostřednictvím GraphQL API od Cloudflare.