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

Azure Data Explorer to usługa dzienników i eksploracji danych telemetrycznych. Z tego przewodnika dowiesz się, jak dodać źródło danych usługi Azure Data Explorer do narzędzia Grafana i dowiedzieć się, jak skonfigurować usługę Azure Data Explorer przy użyciu każdej opcji uwierzytelniania dostępnej dla tego źródła danych.

Wymagania wstępne

• Wystąpienie usługi Azure Managed Grafana w planie w warstwie Standardowa.
• Baza danych usługi Azure Data Explorer

Dodawanie źródła danych usługi Azure Data Explorer

Dodaj źródło danych usługi Azure Data Explorer do narzędzia Grafana, wykonując poniższe kroki.

1. Otwórz wystąpienie usługi Azure Managed Grafana w witrynie Azure Portal.

2. W sekcji Przegląd otwórz adres URL punktu końcowego.

3. W portalu Grafana wdróż menu po lewej stronie i wybierz pozycję Połączenie ions> Połączenie dane.

   

4. Wybierz z listy pozycję Źródło danych usługi Azure Data Explorer i dodaj je do narzędzia Grafana, wybierając pozycję Utwórz źródło danych usługi Azure Data Explorer.

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

Wprowadź ustawienia konfiguracji usługi Azure Data Explorer.

1. Na karcie Ustawienia opcjonalnie edytuj nazwę źródła danych.

   

2. W obszarze szczegóły Połączenie ion wprowadź adres URL klastra bazy danych usługi Azure Data Explorer.

3. Wybierz preferowaną opcję uwierzytelniania między tożsamością zarządzaną, rejestracją aplikacji (jednostką usługi) lub bieżącym użytkownikiem (uwierzytelnianie oparte na użytkowniku).

   Tożsamość zarządzana

   Uwierzytelnianie przy użyciu tożsamości zarządzanej bez użycia jawnych poświadczeń.

   Dodawanie nowego uprawnienia

   1. W witrynie Azure Portal otwórz klaster usługi Azure Data Explorer.

   2. W sekcji Przegląd wybierz bazę danych zawierającą dane.

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

      

   4. W polu wyszukiwania wprowadź nazwę obszaru roboczego zarządzanego przez platformę Azure Grafana, wybierz obszar roboczy, a następnie wybierz pozycję Wybierz. Zostanie wyświetlone powiadomienie o powodzeniu.

   Konfigurowanie źródła danych w narzędziu Grafana

   1. Po powrocie do narzędzia Grafana w obszarze Metoda uwierzytelniania wybierz pozycję Tożsamość zarządzana.
   2. Wybierz pozycję Zapisz i przetestuj. Wyświetlone powiadomienie "Powodzenie" wskazuje, że narzędzie Grafana może pobrać dane z bazy danych.

   Rejestracja aplikacji

   Uwierzytelnianie za pomocą rejestracji aplikacji przy użyciu jednostki usługi Microsoft Entra.

   Początkowa konfiguracja

   1. Wykonaj kroki opisane w temacie Rejestrowanie aplikacji przy użyciu identyfikatora Entra firmy Microsoft i utwórz jednostkę usługi.
   2. Przypisz rolę Czytelnik do aplikacji w następnym kroku przewodnika.
   3. Wykonaj trzy pierwsze kroki przewodnika Pobieranie szczegółów aplikacji, aby zebrać identyfikator katalogu (dzierżawy), identyfikator aplikacji (klienta) i identyfikator wpisu tajnego klienta wymagane w następnym kroku.

   Konfigurowanie źródła danych w narzędziu Grafana

   1. W aplikacji Grafana w obszarze Metoda uwierzytelniania wybierz pozycję Rejestracja aplikacji.

   2. W polu Azure Cloud wybierz chmurę platformy Azure. Na przykład platforma Azure.

      

   3. Wprowadź identyfikator katalogu (dzierżawy), identyfikator aplikacji (klienta) i klucz tajny klienta

   4. Opcjonalnie można również edytować sekcje Optymalizacje zapytań, Ustawienia schematu bazy danych i Śledzenie .

   5. Wybierz pozycję Zapisz i przetestuj , aby zweryfikować połączenie. Wyświetlone powiadomienie "Powodzenie" wskazuje, że narzędzie Grafana może nawiązać połączenie z bazą danych.

   Bieżący użytkownik

   Użyj metody uwierzytelniania opartej na użytkowniku, korzystając z bieżących poświadczeń identyfikatora Entra użytkownika Grafana w skonfigurowanym źródle danych.

   Podczas konfigurowania źródła danych usługi Azure Data Explorer przy użyciu metody uwierzytelniania Bieżący użytkownik narzędzie Grafana wysyła zapytanie do usługi Azure Data Explorer przy użyciu poświadczeń użytkownika.

   Uwaga

   Uwierzytelnianie oparte na użytkownikach w źródłach danych narzędzia Grafana jest eksperymentalne.

   Uwaga

   Ta funkcja jest niezgodna z przypadkami użycia, które wymagają zawsze włączonego dostępu komputera do danych, w tym alertów, raportowania, buforowania zapytań i publicznych pulpitów nawigacyjnych. Metoda uwierzytelniania Bieżący użytkownik opiera się na zalogowanym użytkowniku w interakcyjnej sesji, aby aplikacja Grafana dotarła do bazy danych. W przypadku użycia uwierzytelniania opartego na użytkowniku i nie jest zalogowany żaden użytkownik, automatyczne zadania nie mogą być uruchamiane w tle. Aby korzystać z zautomatyzowanych zadań dla usługi Azure Data Explorer, zalecamy skonfigurowanie innego źródła danych usługi Azure Data Explorer przy użyciu innej metody uwierzytelniania.

   Dodawanie nowego uprawnienia

   Dodaj nowe uprawnienie dla konta użytkownika, aby uzyskać dostęp do bazy danych.

   1. W witrynie Azure Portal otwórz zasób usługi Azure Data Explorer Database i wybierz pozycję Uprawnienia>Dodaj>podgląd.

   2. Wprowadź nazwę lub adres e-mail na pasku wyszukiwania, wybierz konto użytkownika i wybierz pozycję Wybierz.

      

   3. Powiadomienie potwierdza, że uprawnienie zostało dodane do bazy danych.

   Konfigurowanie źródła danych w narzędziu Grafana

   1. W aplikacji Grafana w obszarze Metoda uwierzytelniania wybierz pozycję Bieżący użytkownik.
   2. Wybierz pozycję Zapisz i przetestuj. Wyświetlone powiadomienie "Powodzenie" wskazuje, że narzędzie Grafana może pobrać dane z bazy danych.

Tworzenie źródła danych usługi Azure Data Explorer

W interfejsie wiersza polecenia platformy Azure dodaj i skonfiguruj źródło danych usługi Azure Data Explorer, uruchamiając polecenie az grafana data-source create . Wybierz preferowaną metodę uwierzytelniania i zapoznaj się z odpowiednią kartą poniżej, aby uzyskać szczegółowe informacje.

Podczas uruchamiania tych poleceń zastąp wszystkie symbole zastępcze własnymi informacjami.

Tożsamość zarządzana

Uwierzytelnianie przy użyciu tożsamości zarządzanej bez użycia jawnych poświadczeń.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "msi"
    }
  }
}'

Rejestracja aplikacji

Uwierzytelnianie za pomocą rejestracji aplikacji przy użyciu jednostki usługi Microsoft Entra.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "azureCredentials": {
      "authType": "clientsecret",
      "azureCloud": "AzureCloud",
      "tenantId": "<tenant-id>",
      "clientId": "<client-id>"
    }
  },
  "secureJsonData": { "azureClientSecret": "verySecret" }
}'

Bieżący użytkownik

Uwierzytelnij się przy użyciu bieżącej metody użytkownika. Ta metoda wykorzystuje poświadczenia microsoft Entra ID bieżącego użytkownika narzędzia Grafana w skonfigurowanym źródle danych.

Podczas konfigurowania źródła danych usługi Azure Data Explorer przy użyciu metody uwierzytelniania Bieżący użytkownik narzędzie Grafana wysyła zapytanie do usługi Azure Data Explorer przy użyciu poświadczeń użytkownika.

Uwaga

Wdrażanie uwierzytelniania opartego na użytkownikach w narzędziu Azure Managed Grafana jest w toku i zostanie ukończone we wszystkich regionach do końca 2023 roku.

Uwaga

Uwierzytelnianie oparte na użytkownikach w źródłach danych narzędzia Grafana jest eksperymentalne.

Uwaga

Ta funkcja jest niezgodna z przypadkami użycia, które wymagają zawsze włączonego dostępu komputera do danych, w tym alertów, raportowania, buforowania zapytań i publicznych pulpitów nawigacyjnych. Metoda uwierzytelniania Bieżący użytkownik opiera się na zalogowanym użytkowniku w interakcyjnej sesji, aby aplikacja Grafana dotarła do bazy danych. W przypadku użycia uwierzytelniania opartego na użytkowniku i nie jest zalogowany żaden użytkownik, automatyczne zadania nie mogą być uruchamiane w tle. Aby korzystać z zautomatyzowanych zadań dla usługi Azure Data Explorer, zalecamy skonfigurowanie innego źródła danych usługi Azure Data Explorer przy użyciu innej metody uwierzytelniania.

az grafana data-source create --name <azure-managed-grafana-workspace> --definition '{
  "name": "<data-source-name>",
  "type": "grafana-azure-data-explorer-datasource",
  "access": "proxy",
  "jsonData": {
    "clusterUrl": "<cluster-url>",
    "dataConsistency": "strongconsistency",
    "azureCredentials": {
      "authType": "currentuser"
    }
  }
}'

Aktualizowanie źródła danych usługi Azure Data Explorer

Aby zaktualizować źródło danych usługi Azure Data Explorer, wykonaj poniższe kroki. Podczas uruchamiania tych poleceń zastąp wszystkie symbole zastępcze własnymi informacjami.

1. Pobierz identyfikator źródła danych usługi Azure Data Explorer, aby zaktualizować za pomocą polecenia az grafana data-source list.

   az grafana data-source list --resource-group <azure-managed-grafana-resource-group> --name <azure-managed-grafana-workspace> --query "[?type=='grafana-azure-data-explorer-datasource'].id"
   

2. Uruchom polecenie az grafana data-source update, aby zaktualizować źródło danych.

   Na przykład zaktualizuj nazwę i adres URL klastra źródła danych usługi Azure Data Explorer za pomocą następującego polecenia.

   az grafana data-source update --resource-group <azure-managed-grafana-workspace-resource-group> --name <azure-managed-grafana-workspace> --data-source-id <data-source-id> --set name="<new-name>" url="<new-url>
   

Następny krok

Utwórz pulpit nawigacyjny