Eseguire query sui dati in monitoraggio di Azure con Esplora dati di Azure (anteprima)Query data in Azure Monitor using Azure Data Explorer (Preview)

Il cluster di Azure Esplora dati proxy (proxy ADX) è un'entità che consente di eseguire query tra prodotti tra Esplora dati di Azure, Application Insights (ai)e log Analytics (la) nel servizio monitoraggio di Azure .The Azure Data Explorer proxy cluster (ADX Proxy) is an entity that enables you to perform cross product queries between Azure Data Explorer, Application Insights (AI), and Log Analytics (LA) in the Azure Monitor service. È possibile mappare le aree di lavoro Log Analytics di monitoraggio di Azure o le app Application Insights come cluster proxy.You can map Azure Monitor Log Analytics workspaces or Application Insights apps as proxy clusters. È quindi possibile eseguire una query sul cluster proxy usando gli strumenti Esplora dati di Azure e farvi riferimento in una query tra cluster.You can then query the proxy cluster using Azure Data Explorer tools and refer to it in a cross cluster query. Questo articolo illustra come connettersi a un cluster proxy, aggiungere un cluster proxy ad Azure Esplora dati interfaccia utente Web ed eseguire query sulle aree di lavoro di intelligenza artificiale o della Esplora dati di Azure.The article shows how to connect to a proxy cluster, add a proxy cluster to Azure Data Explorer Web UI, and run queries against your AI apps or LA workspaces from Azure Data Explorer.

Il flusso del proxy del Esplora dati di Azure:The Azure Data Explorer proxy flow:

Flusso proxy ADX

PrerequisitiPrerequisites

Nota

Il proxy ADX è in modalità di anteprima.The ADX Proxy is in preview mode. Connettersi al proxy per abilitare la funzionalità proxy ADX per i cluster.Connect to the proxy to enable the ADX proxy feature for your clusters. Contattare il team di ADXProxy per qualsiasi domanda.Contact the ADXProxy team with any questions.

Connettersi al proxyConnect to the proxy

  1. Verificare che il cluster nativo di Azure Esplora dati, ad esempio cluster della Guida , sia visualizzato nel menu a sinistra prima di connettersi al cluster Log Analytics o Application Insights.Verify your Azure Data Explorer native cluster (such as help cluster) appears on the left menu before you connect to your Log Analytics or Application Insights cluster.

    Cluster nativo ADX

  2. Nell'interfaccia utente di Esplora dati di Azure https://dataexplorer.azure.com/clusters) , selezionare Aggiungi cluster.In the Azure Data Explorer UI (https://dataexplorer.azure.com/clusters), select Add Cluster.

  3. Nella finestra Aggiungi cluster aggiungere l'URL del cluster la o di intelligenza artificiale.In the Add Cluster window, add the URL of the LA or AI cluster.

    • Per LA: https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>For LA: https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>

    • Per intelligenza artificiale: https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>For AI: https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>

    • Selezionare Aggiungi.Select Add.

    Aggiungere cluster

    Nota

    Se si aggiunge una connessione a più di un cluster proxy, assegnare a ognuno un nome diverso.If you add a connection to more than one proxy cluster, give each a different name. In caso contrario, avranno lo stesso nome nel riquadro sinistro.Otherwise they'll all have the same name in the left pane.

  4. Una volta stabilita la connessione, il cluster di LA o di intelligenza artificiale verrà visualizzato nel riquadro sinistro con il cluster ADX nativo.After the connection is established, your LA or AI cluster will appear in the left pane with your native ADX cluster.

    Log Analytics e cluster di Azure Esplora dati

Nota

Il numero di aree di lavoro di monitoraggio di Azure di cui è possibile eseguire il mapping è limitato a 100.The number of Azure Monitor workspaces that can be mapped is limited to 100.

Eseguire le queryRun queries

È possibile eseguire le query usando gli strumenti client che supportano le query kusto, ad esempio: kusto Explorer, interfaccia utente Web di ADXri, Jupyter Kqlmagic, Flow, PowerQuery, PowerShell, Jarvis, Lens, API REST.You can run the queries using client tools that support Kusto queries, such as: Kusto Explorer, ADX Web UI, Jupyter Kqlmagic, Flow, PowerQuery, PowerShell, Jarvis, Lens, REST API.

Nota

La funzionalità proxy ADX viene utilizzata solo per il recupero dei dati.The ADX Proxy feature is used for data retrieval only. Per altre informazioni, vedere supporto della funzione.For more information, see Function supportability.

Suggerimento

  • Il nome del database deve avere lo stesso nome della risorsa specificata nel cluster proxy.Database name should have the same name as the resource specified in the proxy cluster. I nomi fanno distinzione tra maiuscole e minuscole.Names are case sensitive.
  • In query tra cluster assicurarsi che la denominazione delle app Application Insights e delle aree di lavoro Log Analytics sia corretta.In cross cluster queries, make sure that the naming of Application Insights apps and Log Analytics workspaces is correct.
  • Se i nomi contengono caratteri speciali, questi vengono sostituiti dalla codifica URL nel nome del cluster proxy.If names contain special characters, they're replaced by URL encoding in the proxy cluster name.
  • Se i nomi includono caratteri che non soddisfano le regole del nome dell'identificatore KQL, vengono sostituiti dal carattere di tratteggio - .If names include characters that don't meet KQL identifier name rules, they are replaced by the dash - character.

Eseguire LA query diretta dal cluster del proxy di ADX o di intelligenza artificialeDirect query from your LA or AI ADX Proxy cluster

Eseguire query sul cluster LA o per intelligenza artificiale.Run queries on your LA or AI cluster. Verificare che il cluster sia selezionato nel riquadro sinistro.Verify that your cluster is selected in the left pane.

Perf | take 10 // Demonstrate query through the proxy on the LA workspace

Area di lavoro di query

Query incrociata del cluster proxy di ADX o di intelligenza artificiale e del cluster nativo ADXCross query of your LA or AI ADX Proxy cluster and the ADX native cluster

Quando si eseguono query tra cluster dal proxy, verificare che il cluster nativo di ADX sia selezionato nel riquadro sinistro.When you run cross cluster queries from the proxy, verify your ADX native cluster is selected in the left pane. Negli esempi seguenti viene illustrata la combinazione di tabelle del cluster ADX (tramite union ) con l'area di lavoro.The following examples demonstrate combining ADX cluster tables (using union) with LA workspace.

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>

Cross query dal proxy di Esplora dati di Azure Cross query from the Azure Data Explorer proxy

L'uso dell' join operatore, anziché Union, può richiedere un hint per eseguirlo in un cluster nativo di Azure Esplora dati (e non nel proxy).Using the join operator, instead of union, may require a hint to run it on an Azure Data Explorer native cluster (and not on the proxy).

Supporto della funzioneFunction supportability

Il cluster proxy di Azure Esplora dati supporta le funzioni sia per Application Insights che per Log Analytics.The Azure Data Explorer proxy cluster supports functions for both Application Insights and Log Analytics. Questa funzionalità consente alle query tra cluster di fare riferimento direttamente a una funzione tabulare di monitoraggio di Azure.This capability enables cross-cluster queries to reference an Azure Monitor tabular function directly. Il proxy supporta i comandi seguenti:The following commands are supported by the proxy:

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

Nell'immagine seguente viene illustrato un esempio di esecuzione di query su una funzione tabulare dall'interfaccia utente Web di Azure Esplora dati.The following image depicts an example of querying a tabular function from the Azure Data Explorer Web UI. Per usare la funzione, eseguire il nome nella finestra query.To use the function, run the name in the Query window.

Eseguire query in una funzione tabulare da Azure Esplora dati interfaccia utente Web Query a tabular function from Azure Data Explorer Web UI

Esempi di sintassi aggiuntiviAdditional syntax examples

Quando si chiamano i cluster Application Insights (AI) o Log Analytics (LA) sono disponibili le opzioni di sintassi seguenti:The following syntax options are available when calling the Application Insights (AI) or Log Analytics (LA) clusters:

Descrizione della sintassiSyntax Description Application InsightsApplication Insights Log AnalyticsLog Analytics
Database all'interno di un cluster che contiene solo la risorsa definita in questa sottoscrizione (scelta consigliata per le query tra cluster)Database within a cluster that contains only the defined resource in this subscription (recommended for cross cluster queries) cluster ( https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>').database('<ai-app-name> )cluster(https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>').database('<ai-app-name>) cluster ( https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>').database('<workspace-name> )cluster(https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>').database('<workspace-name>)
Cluster che contiene tutte le app e le aree di lavoro in questa sottoscrizioneCluster that contains all apps/workspaces in this subscription cluster ( https://ade.applicationinsights.io/subscriptions/<subscription-id> )cluster(https://ade.applicationinsights.io/subscriptions/<subscription-id>) cluster ( https://ade.loganalytics.io/subscriptions/<subscription-id> )cluster(https://ade.loganalytics.io/subscriptions/<subscription-id>)
Cluster che contiene tutte le app e le aree di lavoro nella sottoscrizione e che sono membri di questo gruppo di risorseCluster that contains all apps/workspaces in the subscription and are members of this resource group cluster ( https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name> )cluster(https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>) cluster ( https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name> )cluster(https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>)
Cluster che contiene solo la risorsa definita in questa sottoscrizioneCluster that contains only the defined resource in this subscription cluster ( https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name> )cluster(https://ade.applicationinsights.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.insights/components/<ai-app-name>) cluster ( https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name> )cluster(https://ade.loganalytics.io/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>)

Passaggi successiviNext steps

Scrivere queryWrite queries