Consultar dados no Azure Monitor usando o Azure Data Explorer

O Azure Data Explorer dá suporte a consultas entre serviços, como o Azure Data Explorer, o recurso do Application Insights (AI) e o workspace do Log Analytics (LA). Você pode consultar o seu workspace do Log Analytics ou recurso do Application Insights usando as ferramentas de consulta do Azure Data Explorer e em uma consulta entre serviços. O artigo mostra como criar uma consulta entre serviços e adicionar o workspace do Log Analytics ou o recurso do Application Insights à interface do usuário da Web do Azure Data Explorer.

O fluxo de consultas entre serviços do Azure Data Explorer:

Adicionar um workspace do Log Analytics/recurso do Application Insights às ferramentas de cliente do Azure Data Explorer

Adicione um workspace do Log Analytics ou recurso do Application Insights às ferramentas de cliente do Azure Data Explorer para habilitar consultas entre serviços nos seus clusters.

1. Verifique se o seu cluster nativo do Azure Data Explorer (como o cluster help) aparece no menu à esquerda antes de se conectar ao workspace do Log Analytics ou recurso do Application Insights.

   

2. Na Interface do Usuário do Azure Data Explorer, selecione + Adicionar e Conexão.

3. Na janela Adicionar Conexão, adicione a URL e o nome de exibição do workspace do Log Analytics (LA) ou do recurso do Application Insights (AI).

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

   Observação

   Especifique https://ade.applicationinsights.io/subscriptions/<subscription-id> para ver todos os bancos de dados na assinatura. Essa sintaxe também funciona nos clusters de workspace do Log Analytics.

4. Selecione Adicionar.

   

   Observação

   • Há pontos de extremidade diferentes para o seguinte:
   • Azure Government – adx.monitor.azure.us/
   • Azure China – adx.monitor.azure.cn/
   • Se você adicionar uma conexão a mais de um workspace do Log Analytics/recurso do Application Insights, atribua um nome diferente a cada um. Caso contrário, eles terão o mesmo nome no painel esquerdo.

5. Depois que a conexão for estabelecida, o seu workspace do Log Analytics ou recurso do Application Insights aparecerá no painel esquerdo com o seu cluster do Azure Data Explorer nativo.

   

Observação

As consultas executadas no Azure Data Explorer em dados no Azure Monitor estão sujeitas a limites de consulta entre recursos.

Executar consultas

É possível executar as consultas usando ferramentas de cliente que dão suporte a consultas Kusto, como as seguintes: Kusto Explorer, IU da Web do Azure Data Explorer, Jupyter Kqlmagic, Flow, PowerQuery, PowerShell, Lens, API REST.

Observação

A consulta entre serviços é usada apenas para recuperação de dados. Para obter mais informações, confira Capacidade de suporte da função.

Dica

• O banco de dados deve ter o mesmo nome do recurso especificado na consulta entre serviços. Os nomes diferenciam minúsculas e maiúsculas.
• Em consultas entre serviços, verifique se os nomes do recurso do Application Insights e do workspace do Log Analytics estão corretos.
• Se os nomes contiverem caracteres especiais, eles serão substituídos pela codificação de URL na consulta entre serviços.
• Se os nomes incluírem caracteres que não atendem às regras de nome do identificador KQL, eles serão substituídos pelo caractere de traço -.

Consulta direta no seu workspace do Log Analytics ou recursos do Application Insights com as ferramentas de cliente do Azure Data Explorer

Você pode executar consultas no seu workspace do Log Analytics ou recursos do Application Insights com as ferramentas de cliente do Azure Data Explorer.

1. Verifique se o workspace está selecionado no painel esquerdo.

2. Execute a seguinte consulta:

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

Consulta cruzada do seu workspace do Log Analytics ou recursos do Application Insights e o cluster nativo do Azure Data Explorer

Ao executar consultas de serviço entre clusters, verifique se o cluster nativo do Azure Data Explorer está selecionado no painel esquerdo. Os exemplos a seguir demonstram a combinação de tabelas de cluster do Azure Data Explorer (usando union) com o workspace do Log Analytics.

Execute as seguintes consultas:

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>

Dica

Usar o operador join, em vez do union, pode exigir que um hint execute-o em um cluster nativo do Azure Data Explorer.

Unir dados de um cluster do Azure Data Explorer em um locatário com um recurso do Azure Monitor em outro locatário

Não há suporte para consultas entre locatários entre os serviços. Você está conectado a um único locatário para executar a consulta que abrange os dois recursos.

Se o recurso do Azure Data Explorer estiver no tenant-name-a e o workspace do Log Analytics estiver no tenant-name-b, use um dos dois seguintes métodos:

1. O Azure Data Explorer permite que você adicione funções para entidades de segurança em locatários diferentes. Insira sua ID de usuário no tenant-name-b como um usuário autorizado no cluster do Azure Data Explorer. Valide a propriedade 'TrustedExternalTenant' no cluster do Azure Data Explorer que contém o tenant-name-b. Execute a consulta cruzada totalmente no tenant-name-b.

2. Use o Lighthouse para projetar o recurso do Azure Monitor no tenant-name-a.

Conectar-se aos clusters do Azure Data Explorer de diferentes locatários

O Azure Data Explorer o conecta automaticamente no locatário no qual a conta de usuário pertence originalmente. Para acessar os recursos em outros locatários com a mesma conta de usuário, o tenantId precisa ser especificado explicitamente na cadeia de conexão: Data Source=https://ade.applicationinsights.io/subscriptions/SubscriptionId/resourcegroups/ResourceGroupName;Initial Catalog=NetDefaultDB;AAD Federated Security=True;Authority ID=<TenantId>

Capacidade de suporte da função

As consultas entre serviços do Azure Data Explorer são compatíveis com as funções do recurso do Application Insights e workspace do Log Analytics. Essa funcionalidade permite que as consultas entre clusters façam referência a uma função tabular do Azure Monitor diretamente. Há suporte para os seguintes comandos na consulta entre serviços:

• .show functions
• .show function [FunctionName]
• .show database [DatabaseName] schema as json

Limitações

• As consultas entre serviços dão suporte apenas a .show functions. Essa funcionalidade permite que as consultas entre clusters façam referência a uma função tabular do Azure Monitor, Azure Data Explorer ou do Azure Resource Graph diretamente. Há suporte para os seguintes comandos na consulta entre serviços:

  • .show functions
  • .show function [FunctionName]
  • .show database [DatabaseName] schema as json

• Link Privado (pontos de extremidade privados) e restrições de IP não dão suporte a consultas entre serviços.

Exemplos de sintaxe adicionais

As seguintes opções de sintaxe estão disponíveis ao chamar ou recurso do Application Insights ou workspaces do Log Analytics:

Descrição da sintaxe	Recurso do Application Insights	Espaço de Trabalho do Log Analytics
O banco de dados em um cluster que contém apenas o recurso definido nesta assinatura (recomendado para consultas entre clusters)	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>')
O cluster que contém todos os aplicativos/workspaces nesta assinatura	cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>')	cluster('https://adx.monitor.azure.com/subscriptions/<subscription-id>')
O cluster que contém todos os aplicativos/workspaces na assinatura e que são membros deste grupo de recursos	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>')
O cluster que contém apenas o recurso definido nesta assinatura	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>')
Para pontos de extremidade em UsGov	cluster('https://adx.monitor.azure.us/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>')
Para pontos de extremidade em 21Vianet na China	cluster('https://adx.monitor.azure.cn/subscriptions/<subscription-id>/resourcegroups/<resource-group-name>/providers/microsoft.operationalinsights/workspaces/<workspace-name>')

Conteúdo relacionado

• Gravar consultas