Настройка параметров диагностика брокера MQTT

Статья
11/20/2024

Внимание

Этот параметр требует изменения ресурса брокера и может быть настроен только во время первоначального развертывания с помощью Azure CLI или портала Azure. Новое развертывание требуется, если необходимы изменения конфигурации брокера. Дополнительные сведения см. в разделе "Настройка брокера по умолчанию".

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

Метрики

Метрики предоставляют сведения о текущем и прошлом состоянии брокера MQTT. Эти метрики создаются в формате OpenTelemetry (OTLP). Их можно преобразовать в формат Prometheus с помощью сборщика OpenTelemetry и перенаправляться на панели мониторинга Azure Managed Grafana с помощью управляемой службы Azure Monitor для Prometheus. Дополнительные сведения см. в статье "Настройка наблюдаемости и мониторинга".

Полный список доступных метрик см. в разделе Метрики брокера MQTT.

Журналы

Журналы предоставляют сведения об операциях, выполняемых брокером MQTT. Эти журналы доступны в кластере Kubernetes в качестве журналов контейнеров. Их можно настроить для отправки в журналы Azure Monitor с помощью Container Insights.

Дополнительные сведения см. в статье "Настройка наблюдаемости и мониторинга".

Самостоятельная проверка

Механизм самостоятельной проверки брокера MQTT включен по умолчанию. Он использует диагностика пробы и трассировки OpenTelemetry (OTel) для мониторинга брокера. Проба отправляет тестовые сообщения для проверки поведения и времени системы.

Процесс проверки проверяет, работает ли система правильно, сравнивая результаты теста с ожидаемыми результатами. К этим результатам относятся:

Сообщения путей проходят через систему.
Поведение системы по времени.

Проба диагностика периодически выполняет операции MQTT (PING, CONNECT, PUBLISH, SUBSCRIBE, UNSUBSCRIBE) в брокере MQTT и отслеживает соответствующие пакеты управления доступом и трассировки для проверки задержки, потери сообщений и правильности протокола репликации.

Внимание

Самопроверка диагностика проба публикует сообщения в azedge/dmqtt/selftest разделе. Не публикуйте и не подписывайтесь на разделы проверки диагностики, которые начинаются с azedge/dmqtt/selftest. Публикация или подписка на эти разделы могут повлиять на проверку или самопроверочные проверки, что приводит к недопустимым результатам. Недопустимые результаты могут быть перечислены в журналах диагностики, метрик или панелях мониторинга. Например, может появиться ошибка проверки пути проблемы для события пробы с типом операции "Опубликовать" в журналах проверки диагностика пробы. Дополнительные сведения см. в разделе "Известные проблемы".

Изменение параметров диагностика

В большинстве сценариев достаточно параметров диагностика по умолчанию. Чтобы переопределить параметры диагностика по умолчанию для брокера MQTT, измените diagnostics раздел в ресурсе брокера. В настоящее время изменение параметров поддерживается только с помощью --broker-config-file флага при развертывании операций Интернета вещей Azure с помощью az iot ops create команды.

Чтобы переопределить, сначала подготовьте файл конфигурации брокера после справочника по API BrokerDiagnostics . Например:

{
  "diagnostics": {
    "metrics": {
      "prometheusPort": 9600
    },
      "logs": {
        "level": "debug"
      },
    "traces": {
      "mode": "Enabled",
      "cacheSizeMegabytes": 16,
      "selfTracing": {
        "mode": "Enabled",
        "intervalSeconds": 30
      },
      "spanChannelCapacity": 1000
    },
    "selfCheck": {
      "mode": "Enabled",
      "intervalSeconds": 30,
      "timeoutSeconds": 15
    }
  }
}

Затем разверните операции Интернета вещей Azure с помощью az iot ops create команды с флагом --broker-config-file , например следующую команду (другие параметры, пропущенные для краткости):

az iot ops create ... --broker-config-file <FILE>.json

Дополнительные сведения см. в статье о поддержке Azure CLI для расширенных примеров конфигурации брокера MQTT и брокера.

Следующие шаги

Развертывание ресурсов наблюдаемости и настройка журналов

Поделиться через