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

Общие сведения об API Log Analytics для Azure Monitor

  • Статья

API запросов Log Analytics — это REST API, который можно использовать для запроса полного набора данных, собранных журналами Azure Monitor. Вы можете использовать тот же язык запросов, который используется во всей службе. Используйте этот API для получения данных, создания новых визуализаций данных и расширения возможностей Log Analytics.

Проверка подлинности API Log Analytics

Для доступа к API Log Analytics необходимо пройти проверку подлинности:

  • Для запроса рабочих областей необходимо использовать проверку подлинности Microsoft Entra.
  • Чтобы быстро изучить API без проверки подлинности Microsoft Entra, можно использовать ключ API для запроса примеров данных в нерабокой среде.

Проверка подлинности Microsoft Entra для данных рабочей области

API Log Analytics поддерживает проверку подлинности Microsoft Entra с тремя различными потоками OAuth2 идентификатора Microsoft.

  • Код авторизации
  • Неявный
  • Учетные данные клиента

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

После получения маркера процесс вызова API Log Analytics одинаков для всех потоков. Для запросов требуется заголовок Authorization: Bearer, содержащий полученный из потока OAuth2 маркер.

Проверка подлинности по ключу API для демонстрационных данных

Чтобы быстро изучить API без проверки подлинности Microsoft Entra, мы предоставляем демонстрационную рабочую область с примерами данных. Вы можете пройти проверку подлинности с помощью ключа API.

Примечание.

При использовании проверки подлинности Microsoft Entra может потребоваться до 60 минут, чтобы приложение Аналитика REST API распознал новые разрешения управления доступом на основе ролей. Во время распространения разрешений вызовы REST API могут завершиться ошибкой с кодом ошибки 403.

Ограничения запросов API Log Analytics

Сведения об ограничениях запросов см. в разделе API запросов этой веб-страницы.

Попробуйте использовать API Log Analytics

Чтобы изучить этот API без написания кода, можно использовать следующие средства.

  • Ваш любимый клиент, позволяющий создавать запросы вручную с помощью пользовательского интерфейса, например Fiddler или POST.
  • cURL из командной строки. Затем передайте выходные данные в jsonlint , чтобы получить доступный для чтения JSON.

Вместо прямого вызова REST API можно использовать идиоматические клиентские библиотеки запросов Azure Monitor:

Каждая клиентская библиотека выполняет роль оболочки для REST API и позволяет получать данные журналов из рабочей области.