← Privacy Proxy / privacy-proxy / reference / metrics

OpenTelemetry

Privacy Proxy экспортирует данные телеметрии с использованием Протокол OpenTelemetry (OTLP) ↗. Вы можете настроить конечную точку для получения этих данных и их пересылки на вашу платформу наблюдаемости.

Настройка экспорта телеметрии

На этапе подключения укажите Cloudflare конечную точку вашего коллектора OpenTelemetry:

Endpoint URL: конечная точка HTTPS, на которую должны отправляться данные телеметрии.
Аутентификация: заголовки или учётные данные, необходимые для аутентификации на вашем коллекторе. Поддерживаемые типы аутентификации включают заголовки с bearer токеном, аутентификацию на основе пользовательских заголовков и взаимную аутентификацию TLS (mTLS).

Cloudflare настраивает ваш экземпляр Privacy Proxy для экспорта телеметрии на эту конечную точку.

Поддерживаемые сигналы

Privacy Proxy экспортирует следующие сигналы телеметрии:

Сигнал	Описание
Метрики	Количество соединений, частота запросов, гистограммы задержек, частота ошибок
Трассировки	Трассировки для каждого запроса показывают время обработки на прокси. Данные собираются выборочно, примерно для 1% запросов.

Метрики

Privacy Proxy экспортирует метрики, которые помогают понять характер использования и производительность.

Метрики соединений

Метрика	Описание
`privacy_proxy_connections_total`	Общее количество соединений прокси
`privacy_proxy_connections_active`	Текущие активные соединения
`privacy_proxy_connections_duration_seconds`	Гистограмма длительности соединений

Метрики запросов

Метрика	Описание
`privacy_proxy_requests_total`	Всего обработано запросов CONNECT
`privacy_proxy_requests_by_status`	Запросы, сгруппированные по коду статуса ответа
`privacy_proxy_bytes_sent_total`	Всего байт отправлено узлам назначения
`privacy_proxy_bytes_received_total`	Всего байт получено от узлов назначения

Метрики задержки

Метрика	Описание
`privacy_proxy_connect_latency_seconds`	Время установления соединения с узлом назначения
`privacy_proxy_first_byte_latency_seconds`	Время до первого байта от узла назначения

`Server-Timing` заголовок

Privacy Proxy включает Server-Timing заголовок в ответах, чтобы клиент мог измерять задержку обработки. Полное описание формата заголовка см. в Заголовки HTTP.

Server-Timing: proxy;dur=12.5

dur значение представляет собой время обработки в миллисекундах, добавленное прокси. Используйте этот заголовок как клиентский SLI (Service Level Indicator, индикатор уровня обслуживания) для мониторинга производительности прокси.

Пример: Prometheus и Grafana

Чтобы визуализировать метрики Privacy Proxy в Grafana:

Настройте коллектор OpenTelemetry для приёма данных от Privacy Proxy.
Экспортируйте метрики из коллектора в Prometheus.
Создавайте дашборды Grafana, используя Prometheus в качестве источника данных.

Примеры запросов 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]))

Документация OpenTelemetry ↗ : подробнее о концепциях и настройке OpenTelemetry.
GraphQL Analytics API : запрашивает метрики программно через GraphQL API от Cloudflare.