Włączanie rejestrowania diagnostycznego dla usług Azure AI

Ten przewodnik zawiera instrukcje krok po kroku dotyczące włączania rejestrowania diagnostycznego dla usługi Azure AI. Te dzienniki zawierają bogate, częste dane dotyczące działania zasobu używanego do identyfikacji i debugowania problemów. Przed kontynuowaniem musisz mieć konto platformy Azure z subskrypcją co najmniej jednej usługi Azure AI, takiej jak usługi Mowa.

Wymagania wstępne

Aby włączyć rejestrowanie diagnostyczne, musisz gdzieś przechowywać dane dziennika. W tym samouczku są używane usługi Azure Storage i Log Analytics.

  • Azure Storage — zachowuje dzienniki diagnostyczne na potrzeby inspekcji zasad, analizy statycznej lub kopii zapasowej. Konto magazynu nie musi znajdować się w tej samej subskrypcji co zasób emitujący dzienniki, o ile użytkownik konfigurujący to ustawienie ma odpowiedni dostęp RBAC platformy Azure do obu subskrypcji.
  • Log Analytics — elastyczne narzędzie do wyszukiwania dzienników i analizy, które umożliwia analizę nieprzetworzonych dzienników generowanych przez zasób platformy Azure.

Uwaga

Włączanie zbierania dzienników diagnostycznych

Zacznijmy od włączenia rejestrowania diagnostycznego przy użyciu witryny Azure Portal.

Uwaga

Aby włączyć tę funkcję przy użyciu programu PowerShell lub interfejsu wiersza polecenia platformy Azure, skorzystaj z instrukcji podanych w temacie Zbieranie i używanie danych dziennika z zasobów platformy Azure.

  1. Przejdź do witryny Azure Portal. Następnie znajdź i wybierz zasób usług Azure AI. Na przykład twoja subskrypcja usług Speech Services.
  2. Następnie w menu nawigacji po lewej stronie znajdź pozycję Monitorowanie i wybierz pozycję Ustawienia diagnostyczne. Ten ekran zawiera wszystkie wcześniej utworzone ustawienia diagnostyczne dla tego zasobu.
  3. Jeśli istnieje wcześniej utworzony zasób, którego chcesz użyć, możesz wybrać go teraz. W przeciwnym razie wybierz pozycję + Dodaj ustawienie diagnostyczne.
  4. Wprowadź nazwę ustawienia. Następnie wybierz pozycję Archiwum na koncie magazynu i pozycję Wyślij do usługi Log Analytics.
  5. Po wyświetleniu monitu o skonfigurowanie wybierz konto magazynu i obszar roboczy pakietu OMS, którego chcesz użyć do przechowywania dzienników diagnostycznych. Uwaga: jeśli nie masz konta magazynu ani obszaru roboczego pakietu OMS, postępuj zgodnie z monitami, aby je utworzyć.
  6. Wybierz kolejno pozycje Inspekcja, RequestResponse i AllMetrics. Następnie ustaw okres przechowywania danych dziennika diagnostycznego. Jeśli zasady przechowywania są ustawione na zero, zdarzenia dla tej kategorii dziennika są przechowywane w nieskończoność.
  7. Wybierz pozycję Zapisz.

Zanim dane rejestrowania będą dostępne do wykonywania zapytań i analizowania, może upłynąć do dwóch godzin. Więc nie martw się, jeśli nie widzisz niczego od razu.

Wyświetlanie i eksportowanie danych diagnostycznych z usługi Azure Storage

Usługa Azure Storage to niezawodne rozwiązanie magazynu obiektów zoptymalizowane pod kątem przechowywania dużych ilości danych bez struktury. W tej sekcji dowiesz się, jak wykonywać zapytania dotyczące konta magazynu pod kątem łącznej liczby transakcji w ciągu 30-dniowego przedziału czasu i wyeksportować dane do programu Excel.

  1. W witrynie Azure Portal znajdź zasób usługi Azure Storage utworzony w ostatniej sekcji.
  2. W menu nawigacji po lewej stronie znajdź pozycję Monitorowanie i wybierz pozycję Metryki.
  3. Użyj dostępnych list rozwijanych, aby skonfigurować zapytanie. W tym przykładzie ustawmy zakres czasu na Ostatnie 30 dni , a metryka na Transaction (Transakcja).
  4. Po zakończeniu zapytania zobaczysz wizualizację transakcji w ciągu ostatnich 30 dni. Aby wyeksportować te dane, użyj przycisku Eksportuj do programu Excel znajdującego się w górnej części strony.

Dowiedz się więcej o tym, co można zrobić z danymi diagnostycznymi w usłudze Azure Storage.

Wyświetlanie dzienników w usłudze Log Analytics

Postępuj zgodnie z tymi instrukcjami, aby eksplorować dane analizy dzienników dla zasobu.

  1. W witrynie Azure Portal znajdź i wybierz pozycję Log Analytics z menu nawigacji po lewej stronie.
  2. Znajdź i wybierz zasób utworzony podczas włączania diagnostyki.
  3. W obszarze Ogólne znajdź i wybierz pozycję Dzienniki. Na tej stronie można uruchamiać zapytania względem dzienników.

Przykładowe zapytania

Poniżej przedstawiono kilka podstawowych zapytań Kusto, których można użyć do eksplorowania danych dziennika.

Uruchom to zapytanie dla wszystkich dzienników diagnostycznych z usług Azure AI w określonym przedziale czasu:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"

Uruchom to zapytanie, aby wyświetlić 10 najnowszych dzienników:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| take 10

Uruchom to zapytanie, aby grupować operacje według zasobu:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES" |
summarize count() by Resource

Uruchom to zapytanie, aby znaleźć średni czas potrzebny do wykonania operacji:

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize avg(DurationMs)
by OperationName

Uruchom to zapytanie, aby wyświetlić liczbę operacji w czasie podzieloną przez operację OperationName z liczbą binned dla każdej 10s.

AzureDiagnostics
| where ResourceProvider == "MICROSOFT.COGNITIVESERVICES"
| summarize count()
by bin(TimeGenerated, 10s), OperationName
| render areachart kind=unstacked

Następne kroki