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


Запросы журналов в Azure Monitor

Журналы Azure Monitor основаны на Azure Data Explorer, а запросы журналов пишутся с использованием того же языка запросов Kusto (KQL). Этот богатый язык разработан для легкого чтения и создания контента, так что вы сможете начать писать запросы, следуя простым рекомендациям.

Области в Azure Monitor, в которых вы будете использовать запросы, включают:

  • Log Analytics: используйте это основное средство в портал Azure для редактирования запросов журналов и интерактивного анализа результатов. Даже если вы планируете использовать запрос журнала в другом месте в Azure Monitor, обычно вы напишете и протестируете его в Log Analytics, прежде чем скопировать его в конечное место.
  • Правила настройки оповещений поиска журналов: упреждающее определение проблем из данных в рабочей области. Каждое правило генерации оповещений основано на запросе журнала, который автоматически выполняется через регулярные интервалы. Результаты проверяются, чтобы определить, следует ли создавать оповещение.
  • Рабочие тетради: Включайте результаты запросов журналов, используя различные визуализации в интерактивных визуальных отчетах в портале Azure.
  • Панели мониторинга Azure: Закрепите результаты любого запроса на панели мониторинга Azure, что позволяет визуализировать данные журналов и метрик вместе и, при необходимости, предоставлять общий доступ другим пользователям Azure.
  • Azure Logic Apps: используйте результаты запроса журнала в автоматизированном рабочем процессе с помощью рабочего процесса приложения логики.
  • PowerShell: используйте результаты запроса журнала в скрипте PowerShell из командной строки или рабочей книги в службе автоматизации Azure, которая используетInvoke-AzOperationalInsightsQuery.
  • API запросов Log Analytics: получение данных журнала из рабочей области из любого клиента REST API. Запрос API включает запрос, который выполняется в Azure Monitor, чтобы определить данные для извлечения.

Это важно

Начиная с 1 июля 2025 г. запрос данных журнала и событий требует TLS 1.2 или более поздней версии при использовании конечных точек API запросов для Log Analytics или Application Insights. Дополнительные сведения см. в разделе "Безопасные данные во время передачи".

Клиентские библиотеки запросов Azure Monitor: получение данных журнала из рабочей области с помощью идиоматической клиентской библиотеки для следующих экосистем:

Пример реализации клиентской библиотеки запросов Azure Monitor для Python см. в статье "Анализ данных в журналах Azure Monitor с помощью записной книжки".

Начало работы

Лучший способ начать обучение по написанию запросов к журналам с помощью KQL — использовать доступные учебники и примеры:

  • Руководство по Log Analytics. Руководство по использованию функций Log Analytics, которое является средством, которое вы будете использовать в портал Azure для редактирования и запуска запросов. Он также позволяет создавать простые запросы без непосредственного использования языка запросов. Если вы еще не использовали Log Analytics, запустите здесь, чтобы понять инструмент, который вы будете использовать с другими руководствами и примерами.
  • Руководство по KQL: пошаговое руководство по основным понятиям KQL и общим операторам. Это лучшее место, чтобы быстро освоить язык программирования и разобраться в структуре запросов логов.
  • Примеры запросов. Описание примеров запросов, доступных в Log Analytics. Вы можете использовать запросы без изменений или в качестве примеров для изучения KQL.

Справочная документация

Документация по KQL, включая ссылку для всех команд и операторов, доступна в документации по Azure Data Explorer. Даже освоив использование KQL, вы по-прежнему будете регулярно обращаться к справочнику для изучения новых команд и сценариев, с которыми вы еще не сталкивались.

Различия между языками

Хотя Azure Monitor использует тот же KQL, что и Azure Data Explorer, существуют некоторые различия. В документации по KQL будут указаны операторы, которые не поддерживаются Azure Monitor или которые имеют другую функциональность. Операторы, относящиеся к Azure Monitor, описаны в содержимом для Azure Monitor. В следующих разделах перечислены различия между версиями языка для быстрого получения справки.

Утверждения, которые не поддерживаются в Azure Monitor

Функции, которые не поддерживаются в Azure Monitor:

Оператор не поддерживается в Azure Monitor

соединение между кластерами;

Плагины не поддерживаются в Azure Monitor

Другие операторы в Azure Monitor

Следующие операторы поддерживают определенные функции Azure Monitor и недоступны за пределами Azure Monitor:

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