Migrar para recursos baseados em espaço de trabalho do Application Insights
Este artigo explicará o processo de migração de um recurso clássico do Application Insights para um recurso baseado em espaço de trabalho.
Recursos baseados em workspace:
- Dão suporte à integração completa entre o Application Insights e o Log Analytics.
- Enviam telemetria do Application Insights para um workspace do Log Analytics comum.
- Permitem que você acesse os recursos mais recentes do Azure Monitor enquanto mantém os logs de aplicativo, infraestrutura e plataforma em um local consolidado.
- Habilitam o controle de acesso comum baseado em função do Azure em seus recursos.
- Eliminam a necessidade de consultas entre aplicativos/workspaces.
- Estão disponíveis em todas as regiões comerciais e no Azure US Government.
- Não exigem a alteração das chaves de instrumentação após a migração de um recurso clássico.
Novos recursos
Os recursos do Application Insights baseados em workspace permitem que você aproveite as funcionalidades mais recentes do Azure Monitor e do Log Analytics:
- As chaves gerenciadas pelo cliente (CMK) fornecem criptografia em repouso para os dados com chaves de criptografia às quais só você tem acesso.
- O Link Privado do Azure permite que você vincule com segurança os serviços PaaS (plataforma como serviço) do Azure à sua rede virtual usando pontos de extremidade privados.
- O Profiler e Depurador de Instantâneos da ferramenta BYOS (traga seu próprio armazenamento) oferecem controle total sobre:
- Tipo de criptografia em repouso.
- Política de gerenciamento de tempo de vida.
- Acesso à rede para todos os dados associados a Application Insights Profiler e Depurador de Instantâneos.
- Os níveis de compromisso permitem que você economize até 30% em comparação com o preço do pagamento conforme o uso. Caso contrário, a cobrança pela ingestão de dados paga conforme o uso e a retenção de dados no Log Analytics são semelhantes à cobrança no Application Insights.
- Os dados são ingeridos mais rapidamente por meio da ingestão de streaming do Log Analytics.
Observação
Após a migração para um recurso do Application Insights baseado em espaço de trabalho, a telemetria de vários recursos do Application Insights pode ser armazenada em um workspace comum do Log Analytics. Você ainda pode efetuar pull de dados de um recurso específico do Application Insights, conforme descrito em Entender consultas de log.
Processo de migração
Quando você migra para um recurso baseado em espaço de trabalho, nenhum dado é transferido do armazenamento do recurso clássico para o novo armazenamento. Optar por migrar altera o local em que os novos dados serão gravados em um workspace do Log Analytics enquanto preserva o acesso aos dados do recurso clássico.
Os dados de recursos clássicos serão mantidos e estarão sujeitos às configurações de retenção no recurso clássico do Application Insights. Todos os novos dados ingeridos após a migração estarão sujeitos às configurações de retençãodo workspace do Log Analytics associado, que também oferece suporte a diferentes configurações de retenção por tipo de dados.
O processo de migração é permanente e não pode ser revertido. Depois de migrar um recurso para o Application Insights baseado em espaço de trabalho, ele sempre será um recurso baseado em espaço de trabalho. Depois de migrar, você poderá alterar o espaço de trabalho de destino sempre que necessário.
Se você não precisar migrar um recurso existente e, em vez disso, quiser criar um novo recurso baseado em espaço de trabalho do Application Insights, use o guia de criação de recursos baseados em espaço de trabalho.
Observação
O processo de migração não deve introduzir nenhum tempo de inatividade ou reinicialização do aplicativo nem alterar sua chave de instrumentação ou cadeia de conexão existente.
Pré-requisitos
Um workspace do Log Analytics com o modo de controle de acesso definido para a configuração "Usar permissões do recurso ou do workspace":
- Os recursos baseados em espaço de trabalho do Application Insights não são compatíveis com os espaços de trabalho definidos para a configuração de permissões baseadas em espaço de trabalho dedicada. Para saber mais sobre o controle de acesso do workspace do Log Analytics, veja as diretrizes do modo de controle de acesso.
- Se você ainda não tiver um workspace do Log Analytics, confira a documentação de criação de workspace do Log Analytics.
A exportação contínua não está disponível para recursos baseados em workspace, e deve ser desabilitada. Quando a migração for concluída, você poderá usar as configurações de diagnóstico para configurar o arquivamento de dados em uma conta de armazenamento ou streaming dos Hubs de Eventos do Azure.
Cuidado
- A configuração de diagnóstico usa um esquema/formato de exportação diferente da exportação contínua. A migração interrompe qualquer integração existente com o Azure Stream Analytics.
- A exportação de configurações de diagnóstico pode aumentar os custos. Para obter mais informações, confira Exportar telemetria do Application Insights.
Verifique as configurações de retenção atuais em Configurações>Uso e custos estimados>Retenção de Dados do workspace do Log Analytics. Essa configuração afeta por quanto tempo todos os novos dados ingeridos serão armazenados depois que você migrar o recurso do Application Insights.
Observação
- Se atualmente você armazena dados do Application Insights por mais tempo do que o padrão de 90 dias e deseja manter esse período de retenção maior, ajuste as configurações de retenção do workspace.
- Se você tiver selecionado a retenção de dados com mais de 90 dias nos dados ingeridos no recurso clássico do Application Insights antes da migração, a retenção de dados continuará sendo cobrada por meio desse recurso do Application Insights até que os dados excedam o período de retenção.
- Se a configuração de retenção para a instância do Application Insights em Configurar>Uso e custos estimados>Retenção de Dados estiver habilitada, use essa configuração para controlar os dias de retenção dos dados de telemetria que ainda estiverem salvos no armazenamento do recurso clássico.
Entenda o uso e os custos do Application Insights baseado em espaço de trabalho.
Encontre os recursos clássicos do Application Insights
Você pode usar um dos métodos a seguir para encontrar recursos clássicos do Application Insights na sua assinatura:
Recursos do Application Insights no portal do Azure
Na visão geral de um recurso do Application Insights, os recursos clássicos não possuem um workspace vinculado e exibem uma faixa de aviso sobre a desativação do Application Insights Clássico. Os recursos baseados em workspace possuem um workspace vinculado na seção de visão geral
Recurso clássico: 
Recursos baseados em workspace: 
Gráfico de Recursos do Azure
Você pode usar o Explorer do Azure Resource Graph (ARG) e rodar uma consulta na tabela"recursos" para efetuar pull dessas informações:
resources
| where subscriptionId == 'Replace with your own subscription ID'
| where type contains 'microsoft.insights/components'
| distinct resourceGroup, name, tostring(properties['IngestionMode']), tostring(properties['WorkspaceResourceId'])
Observação
Os recursos clássicos são identificados pelos valores "ApplicationInsights", "N/A'"ou Vazio.
CLI do Azure:
Execute o script a seguir no Cloud Shell do portal, que já está integrado para autenticação, ou em outro lugar depois de se autenticar usando az login:
$resources = az resource list --resource-type 'microsoft.insights/components' | ConvertFrom-Json
$resources | Sort-Object -Property Name | Format-Table -Property @{Label="App Insights Resource"; Expression={$_.name}; width = 35}, @{Label="Ingestion Mode"; Expression={$mode = az resource show --name $_.name --resource-group $_.resourceGroup --resource-type microsoft.insights/components --query "properties.IngestionMode" -o tsv; $mode}; width = 45}
Observação
Os recursos clássicos são identificados pelos valores "ApplicationInsights", "N/A'"ou Vazio. O seguinte script do PowerShell pode ser executado na CLI do Azure:
$subscription = "SUBSCRIPTION ID GOES HERE"
$token = (Get-AZAccessToken).Token
$header = @{Authorization = "Bearer $token"}
$uri = "https://management.azure.com/subscriptions/$subscription/providers/Microsoft.Insights/components?api-version=2015-05-01"
$RestResult=""
$RestResult = Invoke-RestMethod -Method GET -Uri $uri -Headers $header -ContentType "application/json" -ErrorAction Stop -Verbose
$list=@()
$ClassicList=@()
foreach ($app in $RestResult.value)
{
#"processing: " + $app.properties.WorkspaceResourceId ## Classic Application Insights do not have a workspace.
if ($app.properties.WorkspaceResourceId)
{
$Obj = New-Object -TypeName PSObject
#$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$Obj | Add-Member -Type NoteProperty -Name WorkspaceResourceId -Value $app.properties.WorkspaceResourceId
$list += $Obj
}
else
{
$Obj = New-Object -TypeName PSObject
$app.properties.WorkspaceResourceId
$Obj | Add-Member -Type NoteProperty -Name Name -Value $app.name
$ClassicList += $Obj
}
}
$list |Format-Table -Property Name, WorkspaceResourceId -Wrap
"";"Classic:"
$ClassicList | FT
Migrar o recurso
Para migrar um recurso clássico do Application Insights para um recurso baseado em espaço de trabalho:
No recurso do Application Insights, selecione "Propriedades" no cabeçalho "Configurar" no menu à esquerda.
Selecione Migrar para baseado em espaço de trabalho.
Selecione o workspace do Log Analytics onde você deseja que todas as telemetrias do Application Insights ingeridas futuramente sejam armazenadas. Ele pode ser um workspace do Log Analytics na mesma assinatura ou uma assinatura diferente que compartilha o mesmo locatário do Microsoft Entra. O workspace do Log Analytics não precisa estar no mesmo grupo de recursos do recurso do Application Insights.
Observação
A migração para um recurso baseado em workspace pode levar até 24 horas, mas o processo geralmente é mais rápido. Conte com o acesso aos dados por meio do recurso do Application Insights enquanto aguarda a conclusão do processo de migração. Após a conclusão, você verá novos dados armazenados nas tabelas do workspace do Log Analytics.
Depois que o recurso for migrado, você verá as informações do workspace correspondente no painel Visão Geral.
Clique no texto do link azul para ir para o workspace do Log Analytics associado, onde você poderá aproveitar o novo ambiente unificado de consulta de espaço de trabalho.
Dica
Depois de migrar para um recurso do Application Insights baseado no workspace, use o limite diário do workspace para limitar a ingestão e os custos em vez do limite no Application Insights.
Noções básicas de consultas de log
Fornecemos compatibilidade total com versões anteriores para as consultas de recursos clássicos, as pastas de trabalho e os alertas baseados em log do Application Insights na experiência do Application Insights.
Para criar consultas relativas ao novo esquema/estrutura de tabela baseado em espaço de trabalho, você deverá primeiro navegar para workspace do Log Analytics.
Para garantir que as consultas sejam executadas com êxito, valide se os campos da consulta se alinham com os novos campos de esquema.
Talvez você tenha vários recursos do Application Insights que armazenam telemetria em um workspace do Log Analytics, mas queira consultar dados de um recurso específico do Application Insights. Você tem duas opções:
- Acesse o recurso do Application Insights e abra a guia Logs. Todas as consultas dessa guia efetuarão pull automaticamente dos dados do recurso selecionado do Application Insights.
- Acesse o workspace do Log Analytics que você configurou como o destino da telemetria do Application Insights e abra a guia Logs. Para consultar dados de um recurso específico do Application Insights, filtre a propriedade interna
_ResourceIdque está disponível em todas as tabelas específicas do aplicativo.
Se você fizer uma consulta diretamente a partir do workspace do Log Analytics você verá apenas os dados que foram ingeridos após a migração. Para ver os dados clássicos do Application Insights e os novos dados ingeridos após a migração em uma experiência de consulta unificada, use a guia Logs do recurso migrado do Application Insights.
Observação
Se você renomear o recurso de Application Insights após a migração para o modelo baseado em workspace, a guia Logs do Application Insights não mostrará mais a telemetria coletada antes de renomear. Você poderá ver todos os dados (antigos e novos) na guia Logs do recurso do Log Analytics associado.
Como identificar os recursos do Application Insights por tipo de ingestão
Use o script a seguir para identificar seus recursos do Application Insights por tipo de ingestão.
Exemplo
Get-AzApplicationInsights -SubscriptionId 'Your Subscription ID' | Format-Table -Property Name, IngestionMode, Id, @{label='Type';expression={
if ([string]::IsNullOrEmpty($_.IngestionMode)) {
'Unknown'
} elseif ($_.IngestionMode -eq 'LogAnalytics') {
'Workspace-based'
} elseif ($_.IngestionMode -eq 'ApplicationInsights' -or $_.IngestionMode -eq 'ApplicationInsightsWithDiagnosticSettings') {
'Classic'
} else {
'Unknown'
}
}}
Migração programática de recursos
Esta seção ajuda você a migrar seus recursos.
CLI do Azure
Para acessar a versão prévia dos comandos da CLI do Azure do Application Insights, primeiro você precisa executar:
az extension add -n application-insights
Se você não executar o comando az extension add, verá a mensagem de erro que diz az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.
Agora você pode executar o seguinte código para criar o recurso do Application Insights:
az monitor app-insights component update --app
--resource-group
[--ingestion-access {Disabled, Enabled}]
[--kind]
[--query-access {Disabled, Enabled}]
[--retention-time]
[--workspace]
Exemplo
az monitor app-insights component update --app your-app-insights-resource-name -g your_resource_group --workspace "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/test1234/providers/microsoft.operationalinsights/workspaces/test1234555"
Para obter a documentação completa da CLI do Azure para este comando, confira a documentação da CLI do Azure.
Azure PowerShell
A partir da versão 8.0 ou superior de Azure PowerShell, você pode usar o Update-AzApplicationInsightscomando do PowerShell para migrar um recurso clássico do Application Insights para o baseado em workspace.
Para usar esse cmdlet, você precisa especificar o nome e o grupo de recursos do recurso Application Insights que deseja atualizar. Use os parâmetros IngestionMode e WorkspaceResoruceId para migrar sua instância clássica para baseada em workspace. Para obter mais informações sobre os parâmetros e a sintaxe desse cmdlet, consulte Update-AzApplicationInsights.
Exemplo
# Get the resource ID of the Log Analytics workspace
$workspaceResourceId = (Get-AzOperationalInsightsWorkspace -ResourceGroupName "rgName" -Name "laName").ResourceId
# Update the Application Insights resource with the workspace parameter
Update-AzApplicationInsights -Name "aiName" -ResourceGroupName "rgName" -IngestionMode LogAnalytics -WorkspaceResourceId $workspaceResourceId
Modelos do Azure Resource Manager
Esta seção fornece modelos.
Cuidado
Verifique se você removeu todas as configurações de Exportação Contínua do recurso antes de executar os modelos de migração. Confira Pré-requisitos
Arquivo de modelo
{
"$schema": "http://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"name": {
"type": "string"
},
"type": {
"type": "string"
},
"regionId": {
"type": "string"
},
"tagsArray": {
"type": "object"
},
"requestSource": {
"type": "string"
},
"workspaceResourceId": {
"type": "string"
}
},
"resources": [
{
"name": "[parameters('name')]",
"type": "microsoft.insights/components",
"location": "[parameters('regionId')]",
"tags": "[parameters('tagsArray')]",
"apiVersion": "2020-02-02-preview",
"properties": {
"ApplicationId": "[parameters('name')]",
"Application_Type": "[parameters('type')]",
"Flow_Type": "Redfield",
"Request_Source": "[parameters('requestSource')]",
"WorkspaceResourceId": "[parameters('workspaceResourceId')]"
}
}
]
}
Arquivo de parâmetros
{
"$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
"contentVersion": "1.0.0.0",
"parameters": {
"type": {
"value": "web"
},
"name": {
"value": "customresourcename"
},
"regionId": {
"value": "eastus"
},
"tagsArray": {
"value": {}
},
"requestSource": {
"value": "Custom"
},
"workspaceResourceId": {
"value": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/my_resource_group/providers/microsoft.operationalinsights/workspaces/myworkspacename"
}
}
}
Modificar o workspace associado
Depois de criar um recurso do Application Insights baseado em workspace, você poderá modificar o workspace do Log Analytics associado.
No painel de recursos do Application Insights, selecione Propriedades>Alterar Espaço de Trabalho>Espaços de Trabalho do Log Analytics.
Perguntas frequentes
Esta seção fornece respostas para perguntas comuns.
O que acontecerá se eu não migrar o meu recurso clássico do Application Insights para um recurso baseado em workspace?
A Microsoft começou uma migração em fases dos recursos clássicos para recursos baseados em workspace em maio de 2024, e essa migração vai continuar por alguns meses. Não podemos fornecer datas exatas para a migração de recurso, assinaturas ou regiões específicos.
Recomendamos fortemente que você faça a migração manual para recursos baseados em workspace. Esse processo começando quando você seleciona a faixa de aviso de desativação. Você vai encontrá-lo no painel de Visão Geral do recurso clássico do Application Insights no portal do Azure. Esse processo normalmente envolve apenas uma etapa de escolha de qual workspace do Log Analytics será usado para armazenar os dados do aplicativo. Se você usar a exportação contínua, precisará migrar adicionalmente para as configurações de diagnóstico ou desabilitar o recurso primeiro.
Se você não quiser que seu recurso clássico seja migrado automaticamente para um recurso baseado em workspace, você poderá excluir ou migrar manualmente o recurso.
Há alguma implicação no custo da migração?
Geralmente não há diferença, com duas exceções.
- Os recursos do Application Insights que estavam recebendo 1 GB por mês gratuitamente por meio do modelo de preços herdado do Application Insights não recebem mais os dados gratuitos.
- Os recursos do Application Insights que estavam no tipo de preço básico antes de abril de 2018 continuam sendo cobrados no mesmo ponto de preço não regional que era aplicado antes de abril de 2018. Os recursos do Application Insights criados após esse período, ou aqueles convertidos para serem baseados em workspace, receberão os preços regionais atuais. Para preços atuais em sua moeda e região, consulte Preços do Application Insights.
A migração para o Application Insights baseado em workspace oferece muitas opções para otimizar ainda mais os custos, incluindo níveis de compromisso do Log Analytics, clusters dedicados e Logs básicos e auxiliares.
Como a utilização do limite de telemetria funcionará?
Você pode definir um limite diário no workspace do Log Analytics.
Não há limite de cobrança estrito disponível.
Como funcionará a amostragem baseada em ingestão?
Não há alterações na amostragem baseada em ingestão.
Há lacunas nos dados coletados durante a migração?
Não. Mesclamos dados durante o tempo de consulta.
Minhas consultas de logs antigos continuarão funcionando?
Sim, elas continuarão funcionando.
Meus painéis com gráficos de métrica e log fixados continuarão funcionando após a migração?
Sim, elas continuarão funcionando.
A migração afetará o acesso aos dados pela API do AppInsights?
Não. A migração não afetará o acesso existente da API aos dados. Após a migração, você poderá acessar dados diretamente de um workspace usando um esquema um pouco diferente.
Haverá algum impacto no Live Metrics ou em outras experiências de monitoramento?
Não. Não há nenhum impacto nas Métricas em Tempo Real ou em outras experiências de monitoramento.
O que acontece com a exportação contínua após a migração?
Para continuar com as exportações automatizadas, você precisará migrar para configurações de diagnóstico antes de migrar para o recurso baseado em workspace. A configuração de diagnóstico é transferida na migração para o Application Insights baseado em workspace.
Como fazer para garantir uma migração bem-sucedida do meu recurso do App Insights usando o Terraform?
Se você estiver usando o Terraform para gerenciar seus recursos do Azure, é importante usar a versão mais recente do provedor Terraform azurerm antes de tentar atualizar o recurso do App Insights. O uso de uma versão mais antiga do provedor, como a versão 3.12, pode resultar na exclusão do componente clássico antes de criar o recurso do Application Insights baseado em workspace de substituição. Isso pode causar a perda de dados anteriores e exigir a atualização das configurações em seus aplicativos monitorados com novos valores de cadeia de conexão e chave de instrumentação.
Para evitar problemas, use a versão mais recente do Terraform azurerm provider, versão 3.89 ou superior. Essa versão realiza as etapas de migração adequadas, emitindo a chamada apropriada do ARM (Azure Resource Manager) para atualizar o recurso clássico do App Insights para um recurso baseado em workspace, preservando todos os dados antigos e os valores de cadeia de conexão/chave de instrumentação.
Ainda posso usar a API antiga para criar recursos do Application Insights programaticamente?
Para compatibilidade com versões anteriores, as chamadas à API antiga para criar recursos do Application Insights continuarão funcionando. Cada uma dessas chamadas criam um recurso do Application Insights baseado em workspace e um workspace do Log Analytics para armazenar os dados.
Incentivamos fortemente a atualização para a nova API para um melhor controle sobre a criação de recursos.
Devo migrar as configurações de diagnóstico no Application Insights clássico antes de migrar para uma IA baseada em workspace?
Sim, recomendamos a migração para configurações de diagnóstico em recursos clássicos do Application Insights antes de fazer a transição para um Application Insights baseado em workspace. Isso garante a continuidade e a compatibilidade das configurações de diagnóstico.
Solução de problemas
Esta seção fornece dicas de solução de problemas.
Modo de acesso
Mensagem de erro: "O workspace selecionado está configurado com o modo de acesso baseado em workspace. Alguns recursos do APM (Monitoramento de Desempenho de Aplicativos) podem ser afetados. Selecione outro workspace ou permita o acesso baseado em recursos nas configurações do workspace. Você pode desprezar esse erro usando a CLI."
Para que o recurso baseado em espaço de trabalho do Application Insights opere corretamente, você precisa alterar o modo de controle de acesso do workspace do Log Analytics de destino para a configuração de permissões de recurso ou de espaço de trabalho. Essa configuração está localizada na interface do usuário do espaço de trabalho do Log Analytics em Propriedades>Modo de controle de acesso. Para obter instruções, veja as diretrizes de como o Log Analytics configura o modo de controle de acesso. Se o modo de controle de acesso for definido como a configuração exclusiva Exigir permissões de workspace, a migração por meio da experiência de migração do portal permanecerá bloqueada.
Se você não puder alterar o modo de controle de acesso por motivos de segurança para o workspace de destino atual, crie um novo workspace do Log Analytics para usar para a migração.
Exportação contínua
Mensagem de erro: “É necessário desabilitar a exportação contínua para continuar. Após a migração, use as Configurações de Diagnóstico para exportar."
A funcionalidade de exportação contínua herdada não tem suporte para recursos baseados em espaço de trabalho. Antes de migrar, você precisa habilitar as configurações de diagnóstico e desabilitar a exportação contínua.
Habilitar as configurações de diagnóstico no recurso clássico do Application Insights.
Na exibição do recurso do Application Insights, no cabeçalho "Configurar", selecione "Exportação contínua".
Selecione Desabilitar.
Depois de selecionar Desabilitar, você poderá voltar para a interface do usuário de migração. Se a página Editar exportação contínua informar que suas configurações não serão salvas, selecione OK. Esse prompt não se refere a desabilitar ou habilitar a exportação contínua.
Depois de migrar o recurso do Application Insights, você pode usar as configurações de diagnóstico para substituir as funcionalidades que a exportação contínua oferecia. Selecione Configurações de diagnóstico>Adicionar configurações de diagnóstico no recurso do Application Insights. Você pode selecionar todas as tabelas ou um subconjunto de tabelas para arquivar em uma conta de armazenamento ou transmitir para um Hubs de Eventos do Azure. Para obter mais informações sobre as configurações de diagnóstico, consulte as diretrizes de configurações de diagnóstico do Azure Monitor.
Configurações de retenção
Mensagem de aviso: "as configurações de retenção personalizadas do Application Insights não serão aplicadas aos dados enviados para o workspace. Você precisa reconfigurá-las separadamente."
Você não precisa fazer nenhuma alteração antes da migração. Essa mensagem alerta você de que as configurações de retenção Insights aplicativo atual não estão definidas para o período de retenção padrão de 90 dias. Essa mensagem de aviso significa que talvez você queira modificar as configurações de retenção do workspace do Log Analytics antes de migrar e começar a ingerir novos dados.
É possível verificar as configurações de retenção atuais do Log Analytics em Configurações>Uso e custos estimados>Retenção de Dados na interface do usuário do Log Analytics. Essa configuração afeta por quanto tempo todos os novos dados ingeridos serão armazenados depois que você migrar o recurso do Application Insights.
Alterações dos recursos com base no espaço de trabalho
Antes da introdução dos recursos do Application Insights baseados em espaço de trabalho, os dados do Application Insights eram armazenados separadamente de outros dados de log no Azure Monitor. Ambos são baseados no Azure Data Explorer e usam a mesma linguagem de consulta do Kusto (KQL). Os dados de recursos baseados no workspace do Application Insights são armazenados em um workspace do Log Analytics com outros dados de monitoramento e dados de aplicativos. Essa organização simplifica sua configuração. Você pode analisar dados entre várias soluções com mais facilidade e usar as funcionalidades dos workspaces.
Estrutura de dados clássica
A estrutura de um workspace do Log Analytics é descrita em Visão geral do workspace do Log Analytics. Para um aplicativo clássico, os dados não são armazenados em um workspace do Log Analytics. Ele usa a mesma linguagem de consulta. Você cria e executa consultas usando a mesma ferramenta do Log Analytics no portal do Azure. Os itens de dados para aplicativos clássicos são armazenados separadamente uns dos outros. A estrutura geral é igual a aplicativos baseados em workspace, embora os nomes de tabela e coluna sejam diferentes.
Observação
A experiência clássica do Application Insights inclui compatibilidade com versões anteriores para consultas de recursos, pastas de trabalho e alertas baseados em log. Para consultar/exibir em relação à nova estrutura/esquema de tabela baseada em workspace, primeiro vá para seu workspace do Log Analytics. Durante a visualização, selecione Logs no painel do Application Insights para ter acesso à experiência clássica de consulta do Application Insights. Para obter mais informações, confira Escopo da consulta.
Estrutura da tabela
| Nome da tabela herdada | Nome da nova tabela | Descrição |
|---|---|---|
| availabilityResults | AppAvailabilityResults | Dados de resumo dos testes de disponibilidade. |
| browserTimings | AppBrowserTimings | Dados sobre o desempenho do cliente, como o tempo necessário para processar os dados de entrada. |
| dependencies | AppDependencies | Chamada do aplicativo para outros componentes (inclusive componentes externos) registrados por meio de TrackDependency(). Os exemplos são as chamadas à API REST ou a um banco de dados ou a um sistema de arquivos. |
| customEvents | AppEvents | Eventos personalizados criados pelo seu aplicativo. |
| customMetrics | AppMetrics | Métricas personalizadas criadas pelo seu aplicativo. |
| pageViews | AppPageViews | Dados sobre cada exibição do site com informações do navegador. |
| performanceCounters | AppPerformanceCounters | Medidas de desempenho dos recursos de computação que dão suporte ao aplicativo. Um exemplo são os contadores de desempenho do Windows. |
| solicitações | AppRequests | Solicitações recebidas pelo seu aplicativo. Por exemplo, um registro de solicitação separado é registrado para cada solicitação HTTP que o aplicativo Web recebe. |
| exceptions | AppExceptions | Exceções geradas pelo runtime do aplicativo. Captura exceções do lado do servidor e do lado do cliente (navegadores). |
| traces | AppTraces | Logs detalhados (rastreamentos) emitidos por meio de estruturas de log/código do aplicativo gravados por meio de TrackTrace(). |
Cuidado
Aguarde a nova telemetria no Log Analytics antes de confiar nela. Depois de iniciar a migração, a telemetria vai primeiro para o Application Insights Clássico. A ingestão de telemetria é transferida para o Log Analytics em 24 horas. Uma vez feito isso, o Log Analytics captura apenas a nova telemetria.
Esquemas de tabela
As seções a seguir mostram o mapeamento entre os nomes de propriedade clássica e os novos nomes de propriedade do Application Insights com base no espaço de trabalho. Use essas informações para converter as consultas que usam tabelas herdadas.
A maioria das colunas tem o mesmo nome com capitalização diferente. O KQL diferencia maiúsculas de minúsculas, então será necessário alterar cada nome de coluna junto com os nomes de tabela nas consultas existentes. Colunas com alterações além de maiúsculas e minúsculas são realçadas. Você ainda pode usar suas consultas clássicas do Application Insights dentro do painel Logs do seu recurso Application insights, mesmo que ele seja um recurso baseado no workspace. Os novos nomes de propriedades são necessários quando você consulta no contexto da experiência do workspace do Log Analytics.
AppAvailabilityResults
Tabela herdada: availabilityResults
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
| duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | String |
| local | string | Local | string |
| message | string | Message | string |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| tamanho | real | Tamanho | real |
| sucesso | string | Êxito | Bool |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppBrowserTimings
Tabela herdada: browserTimings
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| name | string | Nome | DATETIME |
| networkDuration | real | NetworkDurationMs | real |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| processingDuration | real | ProcessingDurationMs | real |
| receiveDuration | real | ReceiveDurationMs | real |
| sdkVersion | string | SDKVersion | string |
| sendDuration | real | SendDurationMs | real |
| session_Id | string | SessionId | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| totalDuration | real | TotalDurationMs | real |
| url | string | Url | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppDependencies
Tabela herdada: dependências
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
| data | string | Dados | string |
| duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | String |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| resultCode | string | ResultCode | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| sucesso | string | Êxito | Bool |
| destino | string | Destino | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| type | string | DependencyType | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppEvents
Tabela herdada: customEvents
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppMetrics
Tabela herdada: customMetrics
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
iKey |
string | IKey |
string |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
| value | real | (removido) | |
| valueCount | INT | ItemCount | INT |
| valueMax | real | Max | real |
| valueMin | real | Min | real |
| valueSum | real | Somar | real |
| valueStdDev | real | (removido) |
Observação
Versões mais antigas dos SDKs do Application Insights são usadas para relatar o desvio padrão (valueStdDev) na pré-agregação de métricas. Devido à baixa adoção na análise de métricas, o campo foi removido e não é mais agregado pelos SDKs. Se o valor for recebido pelo ponto de extremidade da coleta de dados do Application Insights, ele será removido durante a ingestão e não será enviado para o workspace do Log Analytics. Para usar o desvio padrão em sua análise, use consultas em eventos brutos do Application Insights.
AppPageViews
Tabela herdada: pageViews
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
| duration | real | DurationMs | real |
id |
string | Id |
string |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | String |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| performanceBucket | string | PerformanceBucket | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| url | string | Url | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppPerformanceCounters
Tabela herdada: performanceCounters
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| category | string | Categoria | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| contador | string | (removido) | |
| customDimensions | dinâmico | Propriedades | Dinâmico |
iKey |
string | IKey |
string |
| instance | string | Instância | string |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| name | string | Nome | cadeia de caracteres |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
| value | real | Valor | real |
AppRequests
Tabela herdada: solicitações
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | Dinâmico |
| customMeasurements | dinâmico | Medidas | Dinâmico |
| duration | real | DurationMs | Real |
id |
string | Id |
String |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | String |
| name | string | Nome | String |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| performanceBucket | string | PerformanceBucket | String |
| resultCode | string | ResultCode | String |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| source | string | Fonte | String |
| sucesso | string | Êxito | Bool |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| url | string | Url | String |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppExceptions
Tabela herdada: exceções
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| assembly | string | Assembly | string |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | dinâmico |
| customMeasurements | dinâmico | Medidas | dinâmico |
| detalhes | dinâmico | Detalhes | dinâmico |
| handledAt | string | HandledAt | string |
iKey |
string | IKey |
string |
| innermostAssembly | string | InnermostAssembly | string |
| innermostMessage | string | InnermostMessage | string |
| innermostMethod | string | InnermostMethod | string |
| innermostType | string | InnermostType | string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| message | string | Message | string |
| method | string | Método | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| outerAssembly | string | OuterAssembly | string |
| outerMessage | string | OuterMessage | string |
| outerMethod | string | OuterMethod | string |
| outerType | string | OuterType | string |
| problemId | string | ProblemId | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| severityLevel | INT | SeverityLevel | INT |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| type | string | ExceptionType | string |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |
AppTraces
Tabela herdada: rastreamentos
| ApplicationInsights | Tipo | LogAnalytics | Tipo |
|---|---|---|---|
| appId | string | ResourceGUID | string |
| application_Version | string | AppVersion | string |
| appName | string | (removido) | |
| client_Browser | string | ClientBrowser | string |
| client_City | string | ClientCity | string |
| client_CountryOrRegion | string | ClientCountryOrRegion | string |
| client_IP | string | ClientIP | string |
| client_Model | string | ClientModel | string |
| client_OS | string | ClientOS | string |
| client_StateOrProvince | string | ClientStateOrProvince | string |
| client_Type | string | ClientType | string |
| cloud_RoleInstance | string | AppRoleInstance | string |
| cloud_RoleName | string | AppRoleName | string |
| customDimensions | dinâmico | Propriedades | dinâmico |
| customMeasurements | dinâmico | Medidas | dinâmico |
iKey |
string | IKey |
string |
| itemCount | INT | ItemCount | INT |
| itemId | string | (removido) | |
| itemType | string | Type | string |
| message | string | Message | string |
| operation_Id | string | OperationId | string |
| operation_Name | string | OperationName | string |
| operation_ParentId | string | ParentId | string |
| operation_SyntheticSource | string | SyntheticSource | string |
| sdkVersion | string | SDKVersion | string |
| session_Id | string | SessionId | string |
| severityLevel | INT | SeverityLevel | INT |
| timestamp | DATETIME | TimeGenerated | DATETIME |
| user_AccountId | string | UserAccountId | string |
| user_AuthenticatedId | string | UserAuthenticatedId | string |
| user_Id | string | UserId | string |