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

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

  • Статья

Внимание

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

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

Метрики

Метрики предоставляют сведения о текущем и прошлом состоянии брокера MQTT. Эти метрики создаются в формате OpenTelemetry Protocol (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
    }
  }
}

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

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

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

Связанный контент