Compartilhar via


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:

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":

  • 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: Captura de tela da página de visão geral do portal do Application Insights clássico.

Recursos baseados em workspace: Captura de tela da página de visão geral do portal do Application Insights baseado 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:

  1. No recurso do Application Insights, selecione "Propriedades" no cabeçalho "Configurar" no menu à esquerda.

    Captura de tela que mostra as Propriedades no cabeçalho

  2. Selecione Migrar para baseado em espaço de trabalho.

    Captura de tela que mostra o botão Migrar para baseado em workspace.

  3. 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.

    Captura de tela que mostra a interface do usuário do Assistente de Migração com a opção de selecionar o workspace de destino.

    Depois que o recurso for migrado, você verá as informações do workspace correspondente no painel Visão Geral.

    Captura de tela que mostra o nome do workspace.

    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 _ResourceId que 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.

  1. Habilitar as configurações de diagnóstico no recurso clássico do Application Insights.

  2. Na exibição do recurso do Application Insights, no cabeçalho "Configurar", selecione "Exportação contínua".

    Captura de tela que mostra o item de menu de exportação contínua.

  3. Selecione Desabilitar.

    Captura de tela que mostra o botão para desabilitar a exportação contínua.

    • 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.

Diagrama que mostra a estrutura dos Logs do Azure Monitor para o Application Insights.

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