← Cloudflare Privacy Gateway / privacy-gateway / reference

Метрики Privacy Gateway

Privacy Gateway теперь поддерживает расширенный мониторинг через наш GraphQL API, предоставляя детальную информацию о трафике и производительности вашего шлюза. Для доступа к этим метрикам убедитесь, что у вас есть:

• Реализация ретрансляционного прокси-шлюза, в которой Cloudflare выступает в роли стороны ретрансляции oblivious relay.
• API-токен с разрешением Analytics Read. Мы предлагаем два узла GraphQL для получения метрик: ohttpMetricsAdaptive и ohttpMetricsAdaptiveGroups. Первый узел предоставляет полные данные о запросах, а второй обеспечивает группированную аналитику.

ohttpMetricsAdaptive узел предназначен для детального анализа отдельных запросов OHTTP с адаптивной выборкой. Этот узел помогает понять производительность и нагрузку на конфигурацию сервера и клиента.

• filter обязательно
  • Примените фильтры, чтобы сузить набор данных. accountTag является обязательным фильтром.
• limit необязательно
  • Укажите максимальное количество возвращаемых записей.
• orderBy необязательный
  • Выберите способ сортировки данных: доступны варианты по различным измерениям и метрикам.

• bytesToClient int необязательно
  • Количество байт, возвращённых клиенту.
• bytesToGateway int необязательно
  • Всего байт, полученных от клиента.
• colo string необязательно
  • Код аэропорта дата-центра Cloudflare, обработавшего запрос.
• datetime Time необязательно
  • Дата и время записи события.
• gatewayStatusCode int необязательно
  • Код состояния, возвращаемый шлюзом.
• relayStatusCode int необязательно
  • Код состояния, возвращаемый ретранслятором.

Этот узел полезен для детального анализа трафика: он помогает выявлять закономерности, проблемы производительности и аномалии в потоке данных.

ohttpMetricsAdaptiveGroups узел позволяет выполнять агрегированный анализ метрик запросов OHTTP с адаптивной выборкой. Этот узел особенно полезен для выявления тенденций и закономерностей по различным аспектам вашего трафика и операций.

• filter обязательно
  • Примените фильтры, чтобы сузить набор данных. accountTag является обязательным фильтром.
• limit необязательно
  • Укажите максимальное количество возвращаемых записей.
• orderBy необязательный
  • Выберите способ сортировки данных: доступны варианты по различным измерениям и метрикам.

• count int необязательно
  • Количество записей, соответствующих критериям.
• dimensions необязательный
  • Определяет измерения группировки для ваших данных.
• sum необязательный
  • Агрегированные итоговые значения различных метрик по измерениям.

Измерения

Вы можете группировать метрики по различным измерениям, чтобы получить более детализированное представление о данных:

• colo string необязательно
  • Код аэропорта дата-центра Cloudflare.
• date Date необязательно
  • Дата метрик запросов OHTTP.
• datetimeFifteenMinutes Time необязательно
  • Временная метка, округлённая до пятнадцати минут.
• datetimeFiveMinutes Time необязательно
  • Временная метка, округлённая до пяти минут.
• datetimeHour Time необязательно
  • Метка времени, округленная до часа.
• datetimeMinute Time необязательно
  • Метка времени, округленная до минуты.
• endpoint string необязательно
  • appId, сгенерировавший трафик.
• gatewayStatusCode int необязательно
  • Код состояния, возвращаемый шлюзом.
• relayStatusCode int необязательно
  • Код состояния, возвращаемый ретранслятором.

Суммарные поля

Суммарные поля дают накопительное представление о различных метриках за выбранный период времени:

• bytesToClient int необязательно
  • Всего байт, отправленных от шлюза клиенту.
• bytesToGateway int необязательно
  • Всего байт от клиента к шлюзу.
• clientRequestErrors int необязательно
  • Общее количество ошибок запросов клиента.
• gatewayResponseErrors int необязательно
  • Общее количество ошибок ответов шлюза.

Используйте узел ohttpMetricsAdaptiveGroups, чтобы получить полное агрегированное представление о характере трафика и оптимизировать производительность и удобство работы пользователей.