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. Mogą one być spowodowane przez nieoczekiwany wynik zapytania, problemy z łącznością z urządzeniami lub nieoczekiwaną awarię usługi. Dzienniki zasobów w Azure Stream Analytics mogą pomóc w zidentyfikowaniu przyczyny tych awarii i skróceniu czasu odzyskiwania.

Włącz dzienniki zasobów dla wszystkich zadań usługi Stream Analytics, aby ułatwić debugowanie i monitorowanie.

Typy dzienników usługi Stream Analytics

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 rozpoczynają się w momencie utworzenia zadania i kończą się w momencie usunięcia zadania. Obejmują zdarzenia występujące, kiedy zadanie jest aktualizowane i podczas jego działania.

Debugowanie zadań usługi Stream Analytics 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. Aby użyć dzienników aktywności w usłudze Stream Analytics, wykonaj następujące kroki:

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 w tym miejscu 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 błąd był spowodowany błędem czasu wykonywania wynikającym z wartości szerokości geograficznej wykraczających poza dozwolony zakres. Rozbieżność danych, które przetwarza 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. Wykonaj akcje naprawcze na podstawie komunikatu o błędzie w formacie JSON. W tym przykładzie dodaj kontrole, aby upewnić się, że wartość szerokości geograficznej mieści się między -90 stopni i 90 stopni.

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 Azure Monitor.

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

Włącz dzienniki zasobów i wysyłaj je do Azure Monitor Logs. Dzienniki zasobów są domyślnie wyłączone .

1. Utwórz obszar roboczy usługi Log Analytics, jeśli jeszcze go nie masz. Umieść obszar roboczy 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 wyboru Wykonywanie i Tworzenie w obszarze dziennika oraz AllMetrics 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ługi Stream Analytics

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