Udostępnij za pośrednictwem

Omówienie interfejsu API usługi Azure Monitor Log Analytics

  • Artykuł

Interfejs API zapytań usługi Log Analytics to interfejs API REST, którego można użyć do wykonywania zapytań dotyczących pełnego zestawu danych zebranych przez dzienniki usługi Azure Monitor. Możesz użyć tego samego języka zapytań, który jest używany w całej usłudze. Ten interfejs API umożliwia pobieranie danych, tworzenie nowych wizualizacji danych i rozszerzanie możliwości usługi Log Analytics.

Uwierzytelnianie interfejsu API usługi Log Analytics

Musisz uwierzytelnić się, aby uzyskać dostęp do interfejsu API usługi Log Analytics:

  • Aby wykonywać zapytania dotyczące obszarów roboczych, należy użyć uwierzytelniania firmy Microsoft Entra.
  • Aby szybko eksplorować interfejs API bez korzystania z uwierzytelniania firmy Microsoft Entra, możesz użyć klucza interfejsu API do wykonywania zapytań dotyczących przykładowych danych w środowisku nieprodukcyjnym.

Uwierzytelnianie entra firmy Microsoft dla danych obszaru roboczego

Interfejs API usługi Log Analytics obsługuje uwierzytelnianie firmy Microsoft Entra z trzema różnymi przepływami protokołu OAuth2 identyfikatora Entra firmy Microsoft:

  • Kod autoryzacji
  • Niejawnie
  • Poświadczenia klienta

Przepływ kodu autoryzacji i niejawny przepływ wymagają co najmniej jednego interakcyjnego logowania użytkownika do aplikacji. Jeśli potrzebujesz przepływu nieinterakcyjnego, użyj przepływu poświadczeń klienta.

Po otrzymaniu tokenu proces wywoływania interfejsu API usługi Log Analytics jest taki sam dla wszystkich przepływów. Żądania wymagają nagłówka Authorization: Bearer wypełnionego tokenem odebranego z przepływu OAuth2.

Uwierzytelnianie klucza interfejsu API dla przykładowych danych

Aby szybko eksplorować interfejs API bez korzystania z uwierzytelniania firmy Microsoft Entra, udostępniamy przykładowy obszar roboczy z przykładowymi danymi. Możesz uwierzytelnić się przy użyciu klucza interfejsu API.

Uwaga

W przypadku korzystania z uwierzytelniania microsoft Entra może upłynąć do 60 minut, aby interfejs API REST aplikacji Szczegółowe informacje rozpoznawał nowe uprawnienia kontroli dostępu opartej na rolach. Podczas propagacji uprawnień wywołania interfejsu API REST mogą zakończyć się niepowodzeniem z kodem błędu 403.

Limity zapytań interfejsu API usługi Log Analytics

Aby uzyskać informacje o limitach zapytań, zobacz sekcję Interfejs API zapytań na tej stronie internetowej.

Wypróbuj interfejs API usługi Log Analytics

Aby wypróbować interfejs API bez pisania kodu, możesz użyć następujących funkcji:

  • Twój ulubiony klient, taki jak Fiddler lub Postman , umożliwia ręczne generowanie zapytań za pomocą interfejsu użytkownika.
  • cURL z wiersza polecenia. Następnie należy przekazać dane wyjściowe do pliku jsonlint , aby uzyskać czytelny kod JSON.

Zamiast bezpośrednio wywoływać interfejs API REST, możesz użyć idiomatycznych bibliotek klienta zapytań usługi Azure Monitor:

Każda biblioteka klienta to otoka interfejsu API REST, która umożliwia pobieranie danych dziennika z obszaru roboczego.