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 poziomu usługi Azure Data Explorer. Wtyczka współdziała zarówno z usługą Azure Managed Grafana , jak i z własnymi aplikacjami 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 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 zarządzane przez platformę Azure Grafana .
• W przypadku self-hosted 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 potrzebna jest 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 najlepsze dla Ciebie, 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 Osoba 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 witrynie Azure Portal przejdź do klastra usługi Azure Data Explorer.

2. W sekcji Przegląd wybierz bazę danych zawierającą przykładowe dane StormEvents.

   

3. Wybierz pozycję Uprawnienia>Dodaj>przeglądarkę.

   

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 zainstalowaną wtyczką usługi Azure Data Explorer.

1. W witrynie 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ę Źródło danych usługi Azure Data Explorer.

   

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

   

6. Wybierz pozycję Zapisz i testuj.

Self-hosted Grafana

Tworzenie jednostki usługi

Jednostkę usługi można utworzyć w witrynie 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 witryny 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 witrynie 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 Osoba 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 witrynie Azure Portal lub w obszarze Zapytanie przy użyciu polecenia zarządzania.

Witryna Azure Portal: uprawnienia

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

2. W sekcji Przegląd wybierz bazę danych zawierającą przykładowe dane StormEvents.

   

3. Wybierz pozycję 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 witrynie 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 witryny 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 Dodaj źródła danych.

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

   

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

   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
   Klucz tajny klienta	Hasło	password

   

5. Wybierz pozycję Zapisz i testuj.

   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 Optymalizacje zapytań ustawień>źródeł>danych 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 buforowania dynamicznego.
2. W polu Maksymalny wiek pamięci podręcznej wprowadź liczbę minut, w których chcesz użyć 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 spójność natychmiastowa nie jest krytyczna, a wydajność jest marginalna, włącz słabą spójność, aby zwiększyć wydajność. Aby uzyskać więcej informacji, zobacz Spójność zapytań.

Aby włączyć słabą spójność, w okienku Optymalizacje zapytań wybierz pozycję Spójność>danych Sł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.

Poniższy podstawowy przykład używa zarówno trybu konstruktora zapytań, jak i trybu nieprzetworzonego edytora zapytań. Zalecamy wyświetlanie zapytań zapisu dla usługi Azure Data Explorer , aby zapoznać się z przykładami innych zapytań do uruchamiania względem zestawu danych.

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

   

2. Na karcie Dodaj wybierz pozycję Graf.

   

3. W okienku grafu wybierz pozycję Panel Title Edit (Edytuj tytuł>panelu).

   

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ę Z i wybierz tabelę z listy rozwijanej.

   

3. Po zdefiniowaniu tabeli przefiltruj dane:

   1. Wybierz + z prawej strony 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życia 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.

   

   Napiwek

   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 nieprzetworzonego. Edytuj zapytanie, korzystając z elastyczności i możliwości język zapytań Kusto.

Tryb nieprzetworzone

Użyj trybu nieprzetworzonego, 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) jest ustawiony na dane 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 pozycję Zastosuj.

   

   Teraz wykres przedstawia dane z 2007 r. z przedziału 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.

Powiązana zawartość

• Pisanie zapytań dla usługi Azure Data Explorer