Wykonywanie zapytań o dane w usłudze Azure Monitor przy użyciu usługi Azure Data Explorer

Usługa Azure Data Explorer obsługuje zapytania między usługami między usługami azure Data Explorer, Application Insights (AI) i Log Analytics (LA). Możesz wykonywać zapytania dotyczące obszaru roboczego usługi Application Insights lub Log Analytics przy użyciu narzędzi do zapytań usługi Azure Data Explorer i zapytań obejmujących wiele usług. W tym artykule pokazano, jak utworzyć zapytanie obejmujące wiele usług i dodać obszar roboczy usługi Log Analytics lub Application Insights do internetowego interfejsu użytkownika usługi Azure Data Explorer.

Przepływ zapytań między usługami platformy Azure Data Explorer:

Diagram przedstawiający przepływ serwera proxy usługi Azure Data Explorer.

Dodawanie obszaru roboczego usługi Log Analytics/Application Insights do narzędzi klienckich usługi Azure Data Explorer

Dodaj obszar roboczy usługi Log Analytics lub Application Insights do narzędzi klienckich usługi Azure Data Explorer, aby umożliwić wykonywanie zapytań między usługami dla klastrów.

  1. Przed nawiązaniem połączenia z klastrem usługi Log Analytics lub Application Insights sprawdź, czy klaster natywny platformy Azure Data Explorer (np. klaster pomocy) jest wyświetlany w menu po lewej stronie.

    Zrzut ekranu przedstawiający menu po lewej stronie z klastrem pomocy wybranym jako klaster natywny usługi Azure Data Explorer.

  2. W interfejsie użytkownika usługi Azure Data Explorer (https://dataexplorer.azure.com/clusters) wybierz pozycję Dodaj klaster.

  3. W oknie Dodawanie klastra dodaj adres URL klastra usługi Log Analytics (LA) lub klastra usługi Application Insights (AI).

    • W przypadku usługi Log Analytics (LA): https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>
    • W przypadku usługi Application Insights (AI): https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>

    Uwaga

    Określ https://ade.applicationinsights.io/subscriptions/<subscription-id> , aby wyświetlić wszystkie bazy danych w subskrypcji. Ta składnia działa również w przypadku klastrów usługi Log Analytics.

  4. Wybierz pozycję Dodaj.

    Zrzut ekranu przedstawiający okno dodawania klastra.

    Uwaga

    • Istnieją różne punkty końcowe dla następujących elementów:
    • Azure Government-adx.monitor.azure.us/
    • Azure (Chiny) — adx.monitor.azure.cn/
    • Jeśli dodasz połączenie do więcej niż jednego obszaru roboczego usługi Log Analytics/Application Insights, nadaj każdej innej nazwie. W przeciwnym razie wszystkie będą miały taką samą nazwę w okienku po lewej stronie.
  5. Po nawiązaniu połączenia obszar roboczy usługi Log Analytics lub Application Insights pojawi się w okienku po lewej stronie z natywnym klastrem usługi Azure Data Explorer.

    Zrzut ekranu przedstawiający klastry usługi Log Analytics i usługi Azure Data Explorer.

Uwaga

Zapytania uruchamiane z usługi Azure Data Explorer dotyczące danych w usłudze Azure Monitor podlegają limitom zapytań obejmujących wiele zasobów.

Uruchamianie zapytań

Zapytania można uruchamiać przy użyciu narzędzi klienckich, które obsługują zapytania Kusto, takie jak: Kusto Explorer, Azure Data Explorer internetowy interfejs użytkownika, Jupyter Kqlmagic, Flow, PowerQuery, PowerShell, Lens, interfejs API REST.

Uwaga

Możliwość wykonywania zapytań między usługami jest używana tylko do pobierania danych. Aby uzyskać więcej informacji, zobacz Obsługa funkcji.

Porada

  • Baza danych powinna mieć taką samą nazwę jak zasób określony w zapytaniu między usługami. W nazwach jest uwzględniana wielkość liter.
  • W zapytaniach między usługami upewnij się, że nazewnictwo aplikacji usługi Application Insights i obszarów roboczych usługi Log Analytics jest poprawne.
  • Jeśli nazwy zawierają znaki specjalne, są zastępowane kodowaniem adresu URL w zapytaniu między usługami.
  • Jeśli nazwy zawierają znaki, które nie spełniają reguł nazw identyfikatorów KQL, są zastępowane znakiem kreski - .

Zapytanie bezpośrednie w obszarach roboczych usługi Log Analytics lub Application Insights z poziomu narzędzi klienckich usługi Azure Data Explorer

Zapytania można uruchamiać w obszarach roboczych usługi Log Analytics lub Application Insights z poziomu narzędzi klienckich usługi Azure Data Explorer.

  1. Sprawdź, czy obszar roboczy został wybrany w okienku po lewej stronie.

  2. Uruchom poniższe zapytanie:

Perf | take 10 // Demonstrate cross-service query on the Log Analytics workspace

Zrzut ekranu przedstawiający obszar roboczy usługi Log Analytics zapytań.

Wykonywanie zapytań krzyżowych w obszarze roboczym usługi Log Analytics lub Application Insights oraz klastrze natywnym usługi Azure Data Explorer

Po uruchomieniu zapytań między usługami klastra sprawdź, czy w okienku po lewej stronie wybrano klaster macierzysty usługi Azure Data Explorer natywny. W poniższych przykładach pokazano łączenie tabel klastra usługi Azure Data Explorer (przy użyciu ) unionz obszarem roboczym usługi Log Analytics.

Uruchom następujące zapytania:

union StormEvents, cluster('https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>').database('<workspace-name>').Perf
| take 10
let CL1 = 'https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>';
union <ADX table>, cluster(CL1).database(<workspace-name>).<table name>

Zrzut ekranu przedstawiający zapytanie między usługami z internetowego interfejsu użytkownika usługi Azure Data Explorer.

Porada

join Użycie operatora zamiast unii może wymagać hint uruchomienia go w klastrze natywnym usługi Azure Data Explorer.

Dołączanie danych z klastra usługi Azure Data Explorer w jednej dzierżawie przy użyciu zasobu usługi Azure Monitor w innej

Zapytania między dzierżawami między usługami nie są obsługiwane. Zalogowaliśmy się do jednej dzierżawy na potrzeby uruchomienia zapytania obejmującego oba zasoby.

Jeśli zasób usługi Azure Data Explorer znajduje się w dzierżawie "A", a obszar roboczy usługi Log Analytics znajduje się w dzierżawie "B", użyj jednej z następujących dwóch metod:

  1. Usługa Azure Data Explorer umożliwia dodawanie ról dla podmiotów zabezpieczeń w różnych dzierżawach. Dodaj identyfikator użytkownika w dzierżawie "B" jako autoryzowany użytkownik w klastrze usługi Azure Data Explorer. Sprawdź, czy właściwość "TrustedExternalTenant" w klastrze usługi Azure Data Explorer zawiera dzierżawę "B". Uruchom w pełni zapytanie krzyżowe w dzierżawie "B".

  2. Użyj usługi Lighthouse , aby projektować zasób usługi Azure Monitor w dzierżawie "A".

Nawiązywanie połączenia z klastrami usługi Azure Data Explorer z różnych dzierżaw

Program Kusto Explorer automatycznie loguje Cię do dzierżawy, do której pierwotnie należy konto użytkownika. Aby uzyskać dostęp do zasobów w innych dzierżawach przy użyciu tego samego konta użytkownika, tenantId należy je jawnie określić w parametry połączenia: Data Source=https://ade.applicationinsights.io/subscriptions/SubscriptionId/resourcegroups/ResourceGroupName;Initial Catalog=NetDefaultDB;AAD Federated Security=True;Authority ID=TenantId

Możliwość obsługi funkcji

Zapytania między usługami platformy Azure Data Explorer obsługują funkcje zarówno dla usług Application Insights, jak i Log Analytics. Ta funkcja umożliwia bezpośrednie odwoływanie się do funkcji tabelarycznej usługi Azure Monitor między klastrami. Następujące polecenia są obsługiwane w przypadku zapytania obejmującego wiele usług:

  • .show functions
  • .show function {FunctionName}
  • .show database {DatabaseName} schema as json

Na poniższej ilustracji przedstawiono przykład wykonywania zapytań dotyczących funkcji tabelarycznej z internetowego interfejsu użytkownika usługi Azure Data Explorer. Aby użyć funkcji, uruchom nazwę w oknie Zapytanie.

Zrzut ekranu przedstawiający zapytanie dotyczące funkcji tabelarycznej z usługi Azure Data Explorer internetowego interfejsu użytkownika.

Dodatkowe przykłady składni

Podczas wywoływania klastrów usługi Application Insights lub Log Analytics dostępne są następujące opcje składni:

Opis składni Application Insights Log Analytics
Baza danych w klastrze, która zawiera tylko zdefiniowany zasób w tej subskrypcji (zalecane w przypadku zapytań między klastrami) cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>').database('<ai-app-name>') cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>').database('<workspace-name>')
Klaster, który zawiera wszystkie aplikacje/obszary robocze w tej subskrypcji cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>') cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>')
Klaster, który zawiera wszystkie aplikacje/obszary robocze w subskrypcji i jest członkami tej grupy zasobów cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>') cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>')
Klaster, który zawiera tylko zdefiniowany zasób w tej subskrypcji cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>') cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>')
W przypadku punktów końcowych w usgov cluster('https://adx.monitor.azure.us/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>')
W przypadku punktów końcowych w Chinach 21Vianet cluster('https://adx.monitor.azure.cn/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>')