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

Устранение неполадок в Azure Stream Analytics с помощью журналов ресурсов

  • Статья

В некоторых случаях обработка задания Azure Stream Analytics неожиданно прекращается. Очень важно иметь возможность устранения подобных проблем. Сбои могут случиться из-за непредвиденного результата запроса, подключения к устройствам или неожиданного сбоя службы. Журналы ресурсов в Stream Analytics могут помочь определить причину проблемы и ускорить восстановление.

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

Типы журналов

Stream Analytics предоставляет журналы двух типов:

  • журналы действий (всегда включены), содержащие ценные сведения об операциях, выполняемых в заданиях;

  • журналы ресурсов (настраиваемые) с подробными сведениями обо всех событиях в задании. Журналы ресурсов начинают регистрировать данные при создании задания и прекращают при его удалении. Они фиксируют события при обновлении и выполнении задания.

Примечание.

Для анализа несоответствующих данных можно использовать службу хранилища Azure, Центры событий Azure и журналы Azure Monitor. Плата за использование служб взимается с учетом модели ценообразования.

Примечание.

Сведения из данной статьи были недавно обновлены. Теперь вместо термина "Log Analytics" используется термин "журналы Azure Monitor". Данные журнала по-прежнему хранятся в рабочей области Log Analytics, собираются и анализируются той же службой Log Analytics. Целью обновления терминологии является лучшее отражение роли журналов в Azure Monitor. Дополнительные сведения см. в статье Изменения фирменной символики Azure Monitor.

Отладка с помощью журналов действий

Журналы действий включены по умолчанию и содержат аналитические сведения высокого уровня об операциях, выполняемых заданием Stream Analytics. Данные, находящиеся в журналах действий, могут помочь найти причину проблемы, влияющей на ваше задание. Выполните следующие действия, чтобы использовать журналы действий в Stream Analytics.

  1. Войдите на портал Azure в разделе Обзор и выберите Журнал действий.

    Журнал действий Stream Analytics

  2. Отобразится список выполненных операций. Рядом с любой операцией, которая вызвала сбой вашего задания, есть красный информационный пузырек.

  3. Выберите операцию, чтобы просмотреть его сводное представление. Информация здесь часто ограничена. Чтобы узнать больше об операции, выберите JSON.

    Сводка операции журнала действий Stream Analytics

  4. Прокрутите вниз до раздела Свойства в JSON, который предоставляет сведения об ошибке, вызвавшей неудавшуюся операцию. В этом примере ошибка произошла из-за ошибки времени выполнения и превышения значений широты. Несоответствие данных, обрабатываемых заданием Stream Analytics, приводит к ошибке данных. Вы можете узнать о различных ошибках входных и выходных данных и о причинах их возникновения.

    Сведения об ошибке JSON

  5. Вы можете предпринять корректирующие действия, основываясь на сообщении ошибки в JSON. В этом примере в запрос необходимо добавить проверку значения широты в диапазоне от –90 до 90 градусов.

  6. Если сообщение об ошибке в журнале действий не помогает идентифицировать первопричину, включите журналы ресурсов и используйте журналы Azure Monitor.

Отправка диагностических сведений в журналы Azure Monitor

Настоятельно рекомендуется включить журналы ресурсов и настроить их отправку в журналы Azure Monitor. Они отключены по умолчанию. Чтобы их включить, выполните следующие действия.

  1. Создайте рабочую область Log Analytics, если она еще не создана. Рекомендуется использовать рабочую область Log Analytics в том же регионе, что и задание Stream Analytics.

  2. Войдите на портал Azure и перейдите к заданию Stream Analytics. В разделе Мониторингвыберите Журналы диагностики. Затем выберите Turn on diagnostics (Включить диагностику).

    Переход к группе ресурсов по колонке

  3. Укажите имя в поле Имя параметров диагностики и установите флажки Выполнение и Разработка в разделе журналов, а также флажок Все показатели в разделе метрик. Затем выберите Отправить в Log Analytics и укажите рабочую область. Выберите Сохранить.

    Параметры для журналов ресурсов

  4. При запуске задания Stream Analytics журналы ресурсов направляются в рабочую область Log Analytics. Чтобы просмотреть журналы ресурсов для задания, выберите Журналы в разделе Мониторинг.

    На снимке экрана показано меню “Общие” с выбранным пунктом “Журналы”.

  5. Stream Analytics предоставляет предопределенные запросы, которые позволяют легко искать нужные журналы. Вы можете выбрать все предопределенные запросы на левой панели, а затем нажать кнопку "Выполнить". Результаты запроса отображаются на нижней панели.

    На снимке экрана показаны журналы для задания Stream Analytics.

Категории журналов ресурсов

Azure Stream Analytics захватывает две категории журналов ресурсов:

  • Разработка — записывает в журналы события, связанные с операциями разработки заданий, такими как создание задания, добавление и удаление входных и выходных данных, добавление и обновление запроса, запуск и остановка задания.

  • Выполнение — записывает в журнал события, происходящие во время выполнения задания:

    • Ошибки подключения.
    • Ошибки обработки данных, в том числе:
      • события, которые не соответствуют определению запроса (несовпадение типов полей и значений, отсутствие полей и т. п.);
      • ошибки оценки выражений.
    • Другие события и ошибки.

Все журналы хранятся в формате JSON. Дополнительные сведения о схеме журналов ресурсов см. в схеме журналов ресурсов.

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