Wizualizowanie danych z usługi Azure Data Explorer w narzędziu Grafana

Grafana to platforma analityczna, na której można wykonywać zapytania i wizualizować dane, a następnie tworzyć i udostępniać pulpity nawigacyjne na podstawie wizualizacji. Narzędzie Grafana udostępnia wtyczkę usługi Azure Data Explorer, która umożliwia łączenie się z danymi i wizualizowanie ich z usługi Azure Data Explorer. Wtyczka współdziała zarówno z usługą Azure Managed Grafana , jak i z własnym oprogramowaniem Grafana.

Z tego artykułu dowiesz się, jak skonfigurować klaster jako źródło danych dla narzędzia Grafana i wizualizować dane w narzędziu Grafana for Azure Managed Grafana i własnym narzędziu Grafana. Aby postępować zgodnie z przykładami w tym artykule, pozyskując przykładowe dane StormEvents. Przykładowy zestaw danych StormEvents zawiera dane związane z pogodą z National Centers for Environmental Information.

Wymagania wstępne

• W przypadku usługi Azure Managed Grafana konto platformy Azure i wystąpienie usługi Azure Managed Grafana .
• W przypadku własnej aplikacji Grafana Grafana w wersji 5.3.0 lub nowszej dla systemu operacyjnego i wtyczki usługi Azure Data Explorer dla narzędzia Grafana. Do korzystania z konstruktora zapytań Grafana jest potrzebna wtyczka w wersji 3.0.5 lub nowszej.
• Baza danych i klaster usługi Azure Data Explorer. Możesz utworzyć bezpłatny klaster lub utworzyć pełny klaster. Aby zdecydować, co jest dla Ciebie najlepsze, sprawdź porównanie funkcji.

Konfigurowanie źródła danych

Aby skonfigurować usługę Azure Data Explorer jako źródło danych, wykonaj kroki dla środowiska Grafana.

Azure Managed Grafana

Dodawanie tożsamości zarządzanej do roli Osoby przeglądająca

Zarządzana aplikacja Grafana domyślnie tworzy tożsamość zarządzaną przypisaną przez system dla każdego nowego obszaru roboczego. Służy do uzyskiwania dostępu do klastra usługi Azure Data Explorer.

1. W Azure Portal przejdź do klastra usługi Azure Data Explorer.

2. W sekcji Przegląd wybierz bazę danych z przykładowymi danymi StormEvents .

   

3. Wybierz pozycję Uprawnienia>Dodaj>podgląd.

   

4. W polu wyszukiwania wprowadź nazwę zarządzanego obszaru roboczego Grafana.

5. W wynikach wyszukiwania wybierz wynik zgodny z nazwą obszaru roboczego, a następnie wybierz pozycję Wybierz.

   

Konfigurowanie usługi Azure Data Explorer jako źródła danych Grafana

Zarządzane obszary robocze narzędzia Grafana są dostarczane ze wstępnie zainstalowanym wtyczką usługi Azure Data Explorer.

1. W Azure Portal przejdź do obszaru roboczego Zarządzane Grafana.

2. W obszarze Przegląd wybierz link Punkt końcowy , aby otworzyć interfejs użytkownika narzędzia Grafana.

3. W narzędziu Grafana w menu po lewej stronie wybierz ikonę koła zębatego. Następnie wybierz pozycję Źródła danych.

   

4. Wybierz pozycję Azure Data Explorer Datasource.

   

5. W obszarze Szczegóły połączenia wprowadź adres URL klastra usługi Azure Data Explorer.

   

6. Wybierz pozycję Zapisz & Test.

Self-hosted Grafana

Tworzenie nazwy głównej usługi

Jednostkę usługi można utworzyć w Azure Portal lub za pomocą interfejsu wiersza polecenia platformy Azure. Po utworzeniu jednostki usługi uzyskasz wartości czterech właściwości połączenia, które będą używane w kolejnych krokach.

Azure Portal

1. Postępuj zgodnie z instrukcjami w dokumentacji Azure Portal. Użyj tych konkretnych informacji:

   1. W sekcji Przypisywanie aplikacji do roli przypisz typ roli Czytelnik do klastra usługi Azure Data Explorer.

   2. W sekcji Pobieranie wartości logowania skopiuj wartości dla trzech właściwości opisanych w krokach: Identyfikator katalogu (identyfikator dzierżawy), Identyfikator aplikacji i Hasło.

2. W Azure Portal wybierz pozycję Subskrypcje. Następnie skopiuj identyfikator subskrypcji, w której utworzono jednostkę usługi.

   

Interfejs wiersza polecenia platformy Azure

1. Użyj następującego polecenia, aby utworzyć jednostkę usługi. Ustaw odpowiedni zakres i typ readerroli .

   az ad sp create-for-rbac --name "https://{UrlToYourDashboard}:{PortNumber}" --role "reader" \
                            --scopes /subscriptions/{SubID}/resourceGroups/{ResourceGroupName}
   

   Aby uzyskać więcej informacji, zobacz Tworzenie jednostki usługi platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure.

2. Polecenie zwraca zestaw wyników podobny do poniższego przykładu. Skopiuj wartości właściwości appId, passwordi tenant .

   {
     "appId": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "displayName": "{UrlToYourDashboard}:{PortNumber}",
     "name": "https://{UrlToYourDashboard}:{PortNumber}",
     "password": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
     "tenant": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
   }
   

3. Pobierz listę subskrypcji:

   az account list --output table
   

   Skopiuj odpowiedni identyfikator subskrypcji.

   

Dodawanie jednostki usługi do roli Osoby przeglądająca

Teraz, gdy masz jednostkę usługi, dodaj ją do roli Osoba przeglądająca w bazie danych usługi Azure Data Explorer. To zadanie można wykonać w obszarze Uprawnienia w Azure Portal lub w obszarze Zapytanie przy użyciu polecenia zarządzania.

Azure Portal: Uprawnienia

1. W Azure Portal przejdź do klastra usługi Azure Data Explorer.

2. W sekcji Przegląd wybierz bazę danych z przykładowymi danymi StormEvents.

   

3. Wybierz pozycje Uprawnienia>Dodaj.

   

4. W obszarze Dodaj uprawnienia bazy danych wybierz rolę Osoba przeglądająca , a następnie wybierz pozycję Wybierz podmioty zabezpieczeń.

   

5. Wyszukaj utworzoną jednostkę usługi. Wybierz podmiot zabezpieczeń, a następnie wybierz pozycję Wybierz.

   

6. Wybierz pozycję Zapisz.

   

Polecenie zarządzania: Zapytanie

1. W Azure Portal przejdź do klastra usługi Azure Data Explorer, a następnie wybierz pozycję Zapytanie.

   

2. Uruchom następujące polecenie w oknie zapytania. Użyj identyfikatora aplikacji i identyfikatora dzierżawy z Azure Portal lub interfejsu wiersza polecenia platformy Azure.

   .add database {TestDatabase} viewers ('aadapp={ApplicationID};{TenantID}')
   

   Polecenie zwraca zestaw wyników. W poniższym przykładzie pierwszy wiersz dotyczy istniejącego użytkownika w bazie danych. Drugi wiersz dotyczy właśnie dodanej jednostki usługi.

   

Określanie właściwości i testowanie połączenia

Po przypisaniu jednostki usługi do roli Osoba przeglądająca można teraz określić właściwości w wystąpieniu narzędzia Grafana i przetestować połączenie z usługą Azure Data Explorer.

1. W narzędziu Grafana w menu po lewej stronie wybierz ikonę koła zębatego. Następnie wybierz pozycję Źródła danych.

   

2. Wybierz pozycję Dodaj źródło danych.

3. Na stronie Źródła danych/Nowe wprowadź nazwę źródła danych, a następnie wybierz typ Azure Data Explorer Datasource.

   

4. W obszarze Ustawienia>Szczegóły połączenia wprowadź nazwę klastra w formularzu https://{ClusterName}.{Region}.kusto.windows.net. Wprowadź inne wartości z Azure Portal lub interfejsu wiersza polecenia platformy Azure. Skorzystaj z poniższych informacji o mapowaniu jako przewodniku.

   Interfejs użytkownika narzędzia Grafana	Azure Portal	Interfejs wiersza polecenia platformy Azure
   Identyfikator subskrypcji	IDENTYFIKATOR SUBSKRYPCJI	SubscriptionId
   Identyfikator dzierżawy	Identyfikator katalogu	tenant
   Identyfikator klienta	Identyfikator aplikacji	appId
   Wpis tajny klienta	Password (Hasło)	password

   

5. Wybierz pozycję Zapisz & Test.

   Jeśli test zakończy się pomyślnie, przejdź do następnej sekcji. Jeśli masz jakiekolwiek problemy, sprawdź wartości określone w narzędziu Grafana i przejrzyj poprzednie kroki.

Optymalizowanie zapytań

Do optymalizacji zapytań można użyć dwóch funkcji:

• Optymalizowanie wydajności renderowania zapytań pulpitu nawigacyjnego
• Włącz słabą spójność

Aby przeprowadzić optymalizację, w obszarze Ustawienia źródeł> danychOptymalizacje>zapytań wprowadź wymagane zmiany.

Optymalizowanie wydajności renderowania zapytań pulpitu nawigacyjnego

Gdy pulpit nawigacyjny lub wizualizacja jest renderowana więcej niż raz przez co najmniej jednego użytkownika, narzędzie Grafana domyślnie wysyła co najmniej jedno zapytanie do usługi Azure Data Explorer. Włącz buforowanie wyników zapytań, aby zwiększyć wydajność renderowania pulpitu nawigacyjnego i zmniejszyć obciążenie klastra usługi Azure Data Explorer.

W określonym zakresie czasu usługa Azure Data Explorer użyje pamięci podręcznej wyników do pobrania poprzednich wyników i nie uruchomi niepotrzebnego zapytania. Ta funkcja jest szczególnie skuteczna w zmniejszaniu obciążenia zasobów i poprawianiu wydajności, gdy wielu użytkowników korzysta z tego samego pulpitu nawigacyjnego.

Aby włączyć renderowanie pamięci podręcznej wyników, wykonaj następujące czynności w okienku Optymalizacje zapytań :

1. Wyłącz opcję Użyj dynamicznego buforowania.
2. W obszarze Maksymalny wiek pamięci podręcznej wprowadź liczbę minut, w których chcesz używać buforowanych wyników.

Włącz słabą spójność

Klastry są konfigurowane z silną spójnością. Ta domyślna konfiguracja gwarantuje, że wyniki zapytania są aktualne ze wszystkimi zmianami w klastrze.

Po włączeniu słabej spójności wyniki zapytania mogą mieć opóźnienie od 1 do 2 minut po zmianie klastra. Jednak słaba spójność może zwiększyć czas renderowania wizualizacji. Jeśli natychmiastowa spójność nie jest krytyczna, a wydajność jest marginalna, włącz słabą spójność w celu zwiększenia wydajności. Aby uzyskać więcej informacji, zobacz Spójność zapytań.

Aby włączyć słabą spójność, w okienku Optymalizacje zapytań wybierz pozycję Spójność> danychSłaba.

Wizualizowanie danych

Zakończono konfigurowanie usługi Azure Data Explorer jako źródła danych dla narzędzia Grafana. Teraz nadszedł czas na wizualizację danych.

W poniższym przykładzie podstawowym użyto trybu konstruktora zapytań i trybu pierwotnego edytora zapytań. Zalecamy wyświetlenie zapytań zapisu dla usługi Azure Data Explorer, aby zapoznać się z przykładami innych zapytań do uruchamiania względem zestawu danych.

1. W aplikacji Grafana w menu po lewej stronie wybierz ikonę znaku plus. Następnie wybierz pozycję Pulpit nawigacyjny.

   

2. Na karcie Dodaj wybierz pozycję Graph.

   

3. W okienku grafu wybierz pozycję Panel Tytuł>edycji.

   

4. W dolnej części okienka wybierz pozycję Źródło danych, a następnie wybierz skonfigurowane źródło danych.

   

Tryb konstruktora zapytań

Użyj trybu konstruktora zapytań, aby zdefiniować zapytanie.

1. Poniżej źródła danych wybierz pozycję Baza danych i wybierz bazę danych z listy rozwijanej.

2. Wybierz pozycję Od i wybierz tabelę z listy rozwijanej.

   

3. Teraz, gdy tabela jest zdefiniowana, przefiltruj dane:

   1. Wybierz + po prawej stronie pozycji Gdzie (filtr), aby wybrać co najmniej jedną kolumnę w tabeli.
   2. Dla każdego filtru zdefiniuj wartości przy użyciu odpowiedniego operatora. Ten wybór jest podobny do używania operatora where w język zapytań Kusto.

4. Wybierz wartości, które mają być obecne w tabeli:

   1. Wybierz + z prawej strony kolumn Wartość, aby wybrać kolumny wartości, które będą wyświetlane w okienku.

   2. Dla każdej kolumny wartości ustaw typ agregacji.

      Można ustawić co najmniej jedną kolumnę wartości. To zaznaczenie jest równoważne użyciu operatora podsumowania.

5. Wybierz + po prawej stronie pozycji Grupuj według (podsumowanie), aby wybrać co najmniej jedną kolumnę, która będzie używana do rozmieszczania wartości w grupach. To zaznaczenie jest równoważne wyrażeniu grupy w operatorze summarize .

6. Wybierz pozycję Uruchom zapytanie.

   

   Porada

   Podczas finalizowania ustawień w konstruktorze zapytań zostanie utworzone zapytanie język zapytań Kusto. To zapytanie pokazuje logikę utworzoną przy użyciu graficznego edytora zapytań.

7. Wybierz pozycję Edytuj KQL , aby przejść do trybu pierwotnego. Edytuj zapytanie, korzystając z elastyczności i możliwości język zapytań Kusto.

Tryb nieprzetworzone

Użyj trybu pierwotnego, aby edytować zapytanie.

1. W okienku zapytania wklej następujące zapytanie, a następnie wybierz pozycję Uruchom. Zapytanie zasobnikuje liczbę zdarzeń według dnia dla przykładowego zestawu danych.

   StormEvents
   | summarize event_count=count() by bin(StartTime, 1d)
   

   

2. Wykres nie pokazuje żadnych wyników, ponieważ zakres (domyślnie) do danych z ostatnich sześciu godzin. W górnym menu wybierz pozycję Ostatnie 6 godzin.

   

3. Określ zakres niestandardowy obejmujący 2007 rok uwzględniony w przykładowym zestawie danych StormEvents. Następnie wybierz przycisk Zastosuj.

   

   Teraz wykres przedstawia dane z 2007 r. w przedziałach według dnia.

   

4. W górnym menu wybierz ikonę zapisywania: .

Aby przełączyć się do trybu konstruktora zapytań, wybierz pozycję Przełącz do konstruktora. Narzędzie Grafana przekonwertuje zapytanie na dostępną logikę w konstruktorze zapytań. Logika konstruktora zapytań jest ograniczona, więc możesz utracić ręczne zmiany wprowadzone w zapytaniu.

Tworzenie alertów

1. Na pulpicie nawigacyjnym strony głównej wybierz pozycjęKanały powiadomieńalertów>, aby utworzyć nowy kanał powiadomień.

   

2. Wprowadź nazwę i wpisz w obszarze Nowy kanał powiadomień, a następnie wybierz pozycję Zapisz.

   

3. Na pulpicie nawigacyjnym wybierz pozycję Edytuj z listy rozwijanej.

   

4. Wybierz ikonę dzwonka alertu, aby otworzyć okienko Alert . Wybierz pozycję Utwórz alert, a następnie wypełnij właściwości alertu.

   

5. Wybierz ikonę Zapisz pulpit nawigacyjny , aby zapisać zmiany.

Zawartość pokrewna

• Pisanie zapytań dotyczących usługi Azure Data Explorer