Rozwiązywanie problemów z usługą Azure Stream Analytics przy użyciu dzienników zasobów

Czasem może się zdarzyć, że przetwarzanie zadania usługi Azure Stream Analytics zostanie nieoczekiwanie zatrzymane. Ważne jest, aby było możliwe rozwiązanie problemu z tego rodzaju zdarzeniem. Mogą one być spowodowane przez nieoczekiwany wynik zapytania, problemy z łącznością z urządzeniami lub nieoczekiwaną awarię usługi. Dzienniki zasobów w usłudze Stream Analytics mogą pomóc zidentyfikować przyczynę problemów, gdy wystąpią i skrócić czas odzyskiwania.

Zdecydowanie zaleca się włączenie dzienników zasobów dla wszystkich zadań, ponieważ znacznie ułatwi debugowanie i monitorowanie.

Typy dzienników

Usługa Stream Analytics oferuje dwa typy dzienników:

• Dzienniki aktywności (zawsze włączone), które zapewniają wgląd w operacje wykonywane na zadaniach.

• Dzienniki zasobów (konfigurowalne), które zapewniają bogatszy wgląd w wszystko, co dzieje się z zadaniem. Dzienniki zasobów są uruchamiane po utworzeniu i zakończeniu zadania po usunięciu zadania. Obejmują one zdarzenia, gdy zadanie jest aktualizowane i gdy jest uruchomione.

Uwaga

Możesz użyć usług, takich jak Azure Storage, Azure Event Hubs i Dzienniki usługi Azure Monitor, aby analizować dane niekonformujące. Opłaty są naliczane na podstawie modelu cenowego dla tych usług.

Uwaga

Ten artykuł został niedawno zaktualizowany, aby użyć terminu Dzienniki usługi Azure Monitor zamiast usługi Log Analytics. Dane dziennika są nadal przechowywane w obszarze roboczym usługi Log Analytics i są nadal zbierane i analizowane przez tę samą usługę Log Analytics. Aktualizujemy terminologię, aby lepiej odzwierciedlać rolę dzienników w usłudze Azure Monitor. Aby uzyskać szczegółowe informacje, zobacz Zmiany terminologii usługi Azure Monitor.

Debugowanie przy użyciu dzienników aktywności

Dzienniki aktywności są domyślnie włączone i zapewniają ogólny wgląd w operacje wykonywane przez zadanie usługi Stream Analytics. Informacje obecne w dziennikach aktywności mogą pomóc znaleźć główną przyczynę problemów wpływających na zadanie. Wykonaj następujące kroki, aby użyć dzienników aktywności w usłudze Stream Analytics:

1. Zaloguj się do witryny Azure Portal i wybierz pozycję Dziennik aktywności w obszarze Przegląd.

   

2. Możesz wyświetlić listę wykonanych operacji. Każda operacja, która spowodowała niepowodzenie zadania, ma czerwony bąbelek informacyjny.

3. Wybierz operację, aby wyświetlić jej widok podsumowania. Informacje są często ograniczone. Aby dowiedzieć się więcej na temat operacji, wybierz pozycję JSON.

   

4. Przewiń w dół do sekcji Właściwości pliku JSON, która zawiera szczegółowe informacje o błędzie, który spowodował niepowodzenie operacji. W tym przykładzie awaria była spowodowana błędem środowiska uruchomieniowego z wartości powiązanych szerokości geograficznych. Rozbieżność danych przetwarzanych przez zadanie usługi Stream Analytics powoduje błąd danych. Możesz dowiedzieć się więcej o różnych błędach danych wejściowych i wyjściowych oraz o przyczynach ich wystąpienia.

   

5. Akcje naprawcze można wykonać na podstawie komunikatu o błędzie w formacie JSON. W tym przykładzie sprawdza się, czy wartość szerokości geograficznej wynosi od -90 stopni do 90 stopni, należy dodać do zapytania.

6. Jeśli komunikat o błędzie w dziennikach aktywności nie jest przydatny podczas identyfikowania głównej przyczyny, włącz dzienniki zasobów i użyj dzienników usługi Azure Monitor.

Wysyłanie diagnostyki do dzienników usługi Azure Monitor

Włączenie dzienników zasobów i wysłanie ich do dzienników usługi Azure Monitor jest zdecydowanie zalecane. Są one domyślnie wyłączone. Aby je włączyć, wykonaj następujące kroki:

1. Utwórz obszar roboczy usługi Log Analytics, jeśli jeszcze go nie masz. Zaleca się posiadanie obszaru roboczego usługi Log Analytics w tym samym regionie co zadanie usługi Stream Analytics.

2. Zaloguj się do witryny Azure Portal i przejdź do zadania usługi Stream Analytics. W obszarze Monitorowanie wybierz pozycję Dzienniki diagnostyczne. Następnie wybierz pozycję Włącz diagnostykę.

   

3. Podaj nazwę w polu Nazwa ustawień diagnostycznych i zaznacz pola wykonywania i tworzenia w obszarze dziennika oraz Wszystkie metryki w obszarze metryki. Następnie wybierz pozycję Wyślij do usługi Log Analytics i wybierz swój obszar roboczy. Wybierz pozycję Zapisz.

   

4. Po uruchomieniu zadania usługi Stream Analytics dzienniki zasobów są kierowane do obszaru roboczego usługi Log Analytics. Aby wyświetlić dzienniki zasobów dla zadania, wybierz pozycję Dzienniki w sekcji Monitorowanie .

   

5. Usługa Stream Analytics udostępnia wstępnie zdefiniowane zapytania, które umożliwiają łatwe wyszukiwanie zainteresowanych dzienników. W okienku po lewej stronie możesz wybrać dowolne wstępnie zdefiniowane zapytania, a następnie wybrać pozycję Uruchom. Wyniki zapytania zostaną wyświetlone w dolnym okienku.

   

Kategorie dzienników zasobów

Usługa Azure Stream Analytics przechwytuje dwie kategorie dzienników zasobów:

• Tworzenie: przechwytuje zdarzenia dziennika związane z operacjami tworzenia zadań, takimi jak tworzenie zadań, dodawanie i usuwanie danych wejściowych i wyjściowych, dodawanie i aktualizowanie zapytania oraz uruchamianie lub zatrzymywanie zadania.

• Wykonanie: przechwytuje zdarzenia występujące podczas wykonywania zadania.

  • Błędy łączności
  • Błędy przetwarzania danych, w tym:
    • Zdarzenia, które nie są zgodne z definicją zapytania (niezgodne typy pól i wartości, brakujące pola itd.)
    • Błędy oceny wyrażeń
  • Inne zdarzenia i błędy

Wszystkie dzienniki są przechowywane w formacie JSON. Aby dowiedzieć się więcej o schemacie dzienników zasobów, zobacz Schemat dzienników zasobów.

Następne kroki

• Błędy danych usługi Stream Analytics
• Dokumentacja języka zapytań usługi Stream Analytics