INTEGRITY Документация

Метрики

Метрики туннеля показывают пропускную способность и использование ресурсов Cloudflare Tunnel с течением времени. Когда вы запускаете туннель, cloudflared запустит конечную точку метрик Prometheus: HTTP-сервер, который предоставляет метрики в Prometheus формате. Вы можете использовать набор инструментов Prometheus на удалённой машине для сбора метрик из cloudflared сервер.

Адрес сервера метрик по умолчанию

В средах без контейнеризации cloudflared запускает сервер метрик на 127.0.0.1:<PORT>/metrics, где <PORT> является первым доступным портом в диапазоне 20241 к 20245. Если все порты недоступны, cloudflared привязывается к случайному порту. В контейнеризированных средах (Docker, Kubernetes) адрес по умолчанию: 0.0.0.0:<PORT>/metrics.

Чтобы определить порт по умолчанию, проверьте журналы туннеля примерно во время запуска туннеля. Например:

2024-12-19T21:17:58Z INF Starting metrics server on 127.0.0.1:20241/metrics

Настройте адрес сервера метрик

Чтобы отдавать метрики по пользовательскому IP-адресу и порту, выполните следующие действия на cloudflared хост:

  1. Запустите туннель с помощью --metrics флаг. Например,

    cloudflared tunnel --metrics 127.0.0.1:60123 run my-tunnel
  2. Убедитесь, что сервер метрик запущен: перейдите в http://localhost:60123/metrics. Это будет работать только в том случае, если вы настроили localhost IP-адрес (127.0.0.1 или 0.0.0.0).

Теперь метрики можно экспортировать в Prometheus и Grafana для визуализации и запросов к данным. См. Руководство по Grafana с инструкциями по началу работы с этими инструментами.

Доступные метрики

метрики cloudflared

Название Описание Type Метки
build_info Информация о сборке и версии. GAUGE goversion, revision, type, version
cloudflared_config_local_config_pushes Количество локальных отправок конфигурации в Cloudflare. COUNTER
cloudflared_config_local_config_pushes_errors Количество ошибок при локальной отправке конфигурации. COUNTER
cloudflared_orchestration_config_version Версия конфигурации. GAUGE
cloudflared_tcp_active_sessions Количество одновременных TCP-сеансов, проксируемых к любому источнику. GAUGE
cloudflared_tcp_total_sessions Общее количество TCP-сессий, проксированных на любой origin. COUNTER
cloudflared_tunnel_active_streams Общее количество активных потоков. GAUGE
cloudflared_tunnel_concurrent_requests_per_tunnel Количество одновременных запросов, проксируемых через каждый туннель. GAUGE
cloudflared_tunnel_ha_connections Количество активных подключений HA. GAUGE
cloudflared_tunnel_request_errors Количество ошибок при проксировании к источнику. COUNTER
cloudflared_tunnel_server_locations К чему подключен каждый туннель. 1 означает текущее местоположение, 0 означает предыдущие местоположения. GAUGE connection_id, edge_location
cloudflared_tunnel_timer_retries Количество неподтвержденных heartbeat-сообщений. GAUGE
cloudflared_tunnel_total_requests Количество запросов, проксированных через все туннели. COUNTER
cloudflared_tunnel_tunnel_authenticate_success Количество успешных событий аутентификации туннеля. COUNTER
cloudflared_tunnel_tunnel_register_success Количество успешных регистраций туннеля. COUNTER rpcName
cloudflared_udp_active_sessions Количество одновременных UDP-сеансов, проксируемых к любому источнику. GAUGE
cloudflared_udp_total_sessions Общее количество UDP-сессий, проксированных на любой origin. COUNTER
coredns_panics_total Количество паник. COUNTER
quic_client_closed_connections Количество закрытых подключений. COUNTER
quic_client_latest_rtt Последнее измеренное время приёма-передачи (RTT) для соединения. GAUGE conn_index
quic_client_lost_packets Количество пакетов, потерянных в рамках подключения. COUNTER conn_index, reason
quic_client_min_rtt Наименьшее значение RTT, измеренное для соединения, в мс. GAUGE conn_index
quic_client_packet_too_big_dropped Количество пакетов, полученных от источника, которые оказались слишком большими для отправки в Cloudflare и поэтому были отброшены. COUNTER
quic_client_smoothed_rtt Сглаженное значение RTT, рассчитанное для соединения, в мс. GAUGE conn_index
quic_client_total_connections Количество инициированных подключений. Для всех метрик QUIC клиентом считается сторона, инициирующая подключение. COUNTER

Метрики Prometheus

Название Описание Type Метки
promhttp_metric_handler_requests_in_flight Текущее количество обслуживаемых скрейпов. GAUGE
promhttp_metric_handler_requests_total Общее количество scrape-запросов по коду состояния HTTP. COUNTER code

Метрики среды выполнения Go

Название Описание Type Метки
go_gc_duration_seconds Сводка по длительности пауз циклов сборки мусора. СВОДКА
go_goroutines Количество горутин (goroutines), существующих в данный момент. GAUGE
go_info Информация о среде Go. GAUGE version
go_memstats_alloc_bytes Количество выделенных и всё ещё используемых байт. GAUGE
go_memstats_alloc_bytes_total Общее количество выделенных байт, даже если они впоследствии были освобождены. COUNTER
go_memstats_buck_hash_sys_bytes Количество байт, используемых хеш-таблицей блоков профилирования. GAUGE
go_memstats_frees_total Общее количество операций free. COUNTER
go_memstats_gc_sys_bytes Количество байт, используемых для системных метаданных сборки мусора. GAUGE
go_memstats_heap_alloc_bytes Количество байт кучи, выделенных и всё ещё используемых. GAUGE
go_memstats_heap_idle_bytes Количество байт кучи, ожидающих использования. GAUGE
go_memstats_heap_inuse_bytes Количество используемых байт кучи. GAUGE
go_memstats_heap_objects Количество выделенных объектов. GAUGE
go_memstats_heap_released_bytes Количество байт кучи, возвращённых операционной системе. GAUGE
go_memstats_heap_sys_bytes Количество байт кучи, полученных от системы. GAUGE
go_memstats_last_gc_time_seconds Количество секунд, прошедших с 1970 года до последней сборки мусора. GAUGE
go_memstats_lookups_total Общее количество поисков указателей. COUNTER
go_memstats_mallocs_total Общее количество операций malloc. COUNTER
go_memstats_mcache_inuse_bytes Количество байт, используемых структурами mcache. GAUGE
go_memstats_mcache_sys_bytes Количество байт, полученных от системы для структур mcache. GAUGE
go_memstats_mspan_inuse_bytes Количество байт, используемых структурами mspan. GAUGE
go_memstats_mspan_sys_bytes Количество байт, полученных от системы для структур mspan. GAUGE
go_memstats_next_gc_bytes Количество байт кучи, при достижении которого произойдёт следующая сборка мусора. GAUGE
go_memstats_other_sys_bytes Количество байт, используемых для прочих системных выделений памяти. GAUGE
go_memstats_stack_inuse_bytes Количество байт, используемых аллокатором стека. GAUGE