Migrar para recursos do Application Insights baseados na área de trabalho

Este artigo orienta você na migração de um recurso clássico do Application Insights para um recurso baseado em espaço de trabalho.

Recursos baseados em espaço de trabalho:

  • Suporte à integração total entre o Application Insights e o Log Analytics.
  • Envie a telemetria do Application Insights para um espaço de trabalho comum do Log Analytics.
  • Permitir que você acesse os recursos mais recentes do Azure Monitor enquanto mantém os logs de aplicativos, infraestrutura e plataforma em um local consolidado.
  • Habilite o controle de acesso baseado em função comum do Azure em todos os seus recursos.
  • Elimine a necessidade de consultas entre aplicativos/espaços de trabalho.
  • Estão disponíveis em todas as regiões comerciais e no Azure US Government.
  • Não requer a alteração de chaves de instrumentação após a migração de um recurso clássico.

Novas capacidades

Os recursos do Application Insights baseados em espaço de trabalho permitem que você aproveite os recursos mais recentes do Azure Monitor e do Log Analytics:

  • As chaves gerenciadas pelo cliente fornecem criptografia em repouso para seus dados com chaves de criptografia às quais somente você tem acesso.
  • O Azure Private Link permite que você vincule com segurança a plataforma Azure como um serviço (PaaS) à sua rede virtual usando pontos de extremidade privados.
  • O Profiler e o Depurador de Snapshot Bring your own storage (BYOS) oferecem controle total sobre:
    • Política de encriptação em repouso.
    • Política de gestão do tempo de vida.
    • Acesso à rede para todos os dados associados ao Application Insights Profiler e ao Snapshot Debugger.
  • Os níveis de compromisso permitem-lhe poupar até 30% em comparação com o preço pré-pago. Caso contrário, a cobrança pela ingestão e retenção de dados pré-pagos no Log Analytics é semelhante à cobrança no Application Insights.
  • Os dados são ingeridos mais rapidamente por meio da ingestão de streaming do Log Analytics.

Nota

Depois de migrar 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 espaço de trabalho comum do Log Analytics. Você ainda pode extrair dados de um recurso específico do Application Insights, conforme descrito na seção Compreender consultas de log.

Processo de migração

Quando migra para um recurso baseado na área de trabalho, não são transferidos dados do armazenamento do recurso clássico para o novo armazenamento baseado na área de trabalho. Optar por migrar altera a localização onde os novos dados são escritos numa área de trabalho do Log Analytics ao preservar o acesso aos dados de recursos clássicos.

Os dados do recurso clássico persistem e estã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 estão sujeitos às configurações de retenção do espaço de trabalho associado do Log Analytics, 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ê pode 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 do Application Insights baseado em espaço de trabalho, consulte o Guia de criação de recursos baseado em espaço de trabalho.

Nota

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 espaço de trabalho do Log Analytics com o modo de controle de acesso definido como a configuração "Usar permissões de recurso ou espaço de trabalho" :

    • Os recursos do Application Insights baseados em espaço de trabalho não são compatíveis com espaços de trabalho definidos para a configuração de permissões baseada em espaço de trabalho dedicado. Para saber mais sobre o controle de acesso ao espaço de trabalho do Log Analytics, consulte as diretrizes do modo de controle de acesso.
    • Se você ainda não tiver um espaço de trabalho existente do Log Analytics, consulte a documentação de criação do espaço de trabalho do Log Analytics.
  • A exportação contínua não é compatível com recursos baseados em espaço de trabalho e deve ser desabilitada. Após a conclusão da migração, você pode usar as configurações de diagnóstico para configurar o arquivamento de dados para uma conta de armazenamento ou o streaming para os Hubs de Eventos do Azure.

    Atenção

    • As definições de diagnóstico utilizam um esquema/formato de exportação diferente da exportação contínua. Migrar quebrará quaisquer integrações existentes com o Azure Stream Analytics.
    • A exportação de definições de diagnóstico pode aumentar os custos. Para obter mais informações, consulte Exportar telemetria do Application Insights.
  • Verifique suas configurações de retenção atuais em Configurações>de uso e custos>estimados Retenção de dados para seu espaço de trabalho do Log Analytics. Essa configuração afeta por quanto tempo os novos dados ingeridos são armazenados após a migração do recurso do Application Insights.

    Nota

    • Se você atualmente armazena dados do Application Insights por mais tempo do que os 90 dias padrão e deseja manter esse período de retenção mais longo após a migração, ajuste as configurações de retenção do espaço de trabalho.
    • Se você selecionou a retenção de dados por mais de 90 dias nos dados ingeridos no recurso clássico do Application Insights antes da migração, a retenção de dados continuará a ser 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 sua 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 para os dados de telemetria ainda salvos no armazenamento do recurso clássico.
  • Entenda o uso e os custos do Application Insights baseados em espaço de trabalho.

Encontre seus recursos do Classic Application Insights

Você pode usar os seguintes métodos para encontrar recursos do Classic Application Insights em sua assinatura:

Recurso do Application Insights no portal do Azure

Na Visão geral de um recurso do Application Insights, os recursos do Classic Application Insights não têm um espaço de trabalho vinculado e o banner de aviso de desativação do Classic Application Insights é exibido. Os recursos baseados em espaço de trabalho têm um espaço de trabalho vinculado na seção de visão geral

Recurso clássico: Uma captura de tela da página clássica de visão geral do portal do Application Insights.

Recurso baseado em espaço de trabalho: Uma captura de tela da página de visão geral do portal do Application Insights baseado em espaço de trabalho.

Azure Resource Graph

Você pode usar o Azure Resource Graph (ARG) Explorer e executar uma consulta na tabela 'recursos' para obter essas 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'])

Nota

Os recursos clássicos são identificados por valores 'ApplicationInsights', 'N/A' ou Vazio .

CLI do Azure:

Execute o seguinte script do Cloud Shell no portal onde a autenticação é incorporada ou em qualquer outro lugar após a autenticação 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}

Nota

Os recursos clássicos são identificados por valores 'ApplicationInsights', 'N/A' ou Vazio . O seguinte script do PowerShell pode ser executado a partir da 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 seu 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" sob o título "Configurar" no menu à esquerda.

    Captura de tela que mostra Propriedades sob o título Configurado.

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

    Captura de tela que mostra o botão Migrar para espaço de trabalho baseado.

  3. Selecione o espaço de trabalho do Log Analytics onde você deseja que toda a telemetria do Application Insights ingerida no futuro seja armazenada. Pode ser um espaço de trabalho do Log Analytics na mesma assinatura ou uma assinatura diferente que compartilha o mesmo locatário do Microsoft Entra. O espaço de trabalho do Log Analytics não precisa estar no mesmo grupo de recursos que o recurso do Application Insights.

    Nota

    A migração para um recurso baseado em espaço de trabalho pode levar até 24 horas, mas o processo geralmente é mais rápido. Confie no acesso aos dados por meio do recurso do Application Insights enquanto aguarda a conclusão do processo de migração. Depois de concluído, você verá novos dados armazenados nas tabelas do espaço de trabalho 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 espaço de trabalho de destino.

    Depois que o recurso for migrado, você verá as informações correspondentes do espaço de trabalho no painel Visão geral .

    Captura de tela que mostra o nome do espaço de trabalho.

    A seleção do texto do link azul leva você ao espaço de trabalho associado do Log Analytics, onde você pode aproveitar o novo ambiente de consulta do espaço de trabalho unificado.

Gorjeta

Depois de migrar para um recurso do Application Insights baseado em espaço de trabalho, use o limite diário do espaço de trabalho para limitar a ingestão e os custos, em vez do limite no Application Insights.

Compreender as consultas de registo

Fornecemos total compatibilidade com versões anteriores para suas consultas de recursos clássicos, pastas de trabalho e alertas baseados em log do Application Insights dentro da experiência do Application Insights.

Para escrever consultas na nova estrutura/esquema de tabela baseado em espaço de trabalho, você deve primeiro ir para o espaço de trabalho do Log Analytics.

Para garantir que as consultas sejam executadas com êxito, valide se os campos da consulta estão alinhados com os novos campos do esquema.

Você pode ter vários recursos do Application Insights que armazenam telemetria em um espaço de trabalho do Log Analytics, mas deseja consultar dados de um recurso específico do Application Insights. Tem duas opções:

  • Vá para o recurso do Application Insights e selecione a guia Logs . Todas as consultas desta guia extraem automaticamente dados do recurso selecionado do Application Insights.
  • Vá para o espaço de trabalho do Log Analytics que você configurou como o destino para sua telemetria do Application Insights e selecione a guia Logs . Para consultar dados de um recurso específico do Application Insights, filtre a propriedade interna _ResourceId disponível em todas as tabelas específicas do aplicativo.

Quando você consulta diretamente do espaço de trabalho do Log Analytics, vê apenas os dados 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 de dentro do recurso migrado do Application Insights.

Nota

Se você renomear seu recurso do Application Insights depois de migrar para o modelo baseado em espaço de trabalho, a guia Logs do Application Insights não mostrará mais a telemetria coletada antes de renomear. Você pode ver todos os dados antigos e novos na guia Logs do recurso Log Analytics associado.

Identificando 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 de recursos programática

Esta secção ajuda-o a migrar os seus recursos.

CLI do Azure

Para acessar os comandos da CLI do Azure do Application Insights, primeiro você precisa executar:

 az extension add -n application-insights

Se você não executar o az extension add comando, verá uma mensagem de erro informando 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 seu 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, consulte a documentação da CLI do Azure.

Azure PowerShell

A partir da versão 8.0 ou superior do Azure PowerShell, você pode usar o Update-AzApplicationInsights comando PowerShell para migrar um recurso clássico do Application Insights para o espaço de trabalho.

Para usar esse cmdlet, você precisa especificar o nome e o grupo de recursos do recurso do Application Insights que deseja atualizar. Use os IngestionMode parâmetros e WorkspaceResoruceId para migrar sua instância clássica para a instância baseada em espaço de trabalho. 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.

Atenção

Certifique-se de ter removido todas as configurações de Exportação Contínua do seu recurso antes de executar os modelos de migração. Veja 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 espaço de trabalho associado

Depois de criar um recurso do Application Insights baseado em espaço de trabalho, você pode modificar o espaço de trabalho associado do Log Analytics.

No painel de recursos do Application Insights, selecione Propriedades>Change Workspace>Log Analytics Workspaces.

Perguntas mais frequentes

Esta secção fornece respostas a perguntas comuns.

O que acontece se eu não migrar meu recurso clássico do Application Insights para um recurso baseado em espaço de trabalho?

A Microsoft iniciou uma abordagem faseada para migrar recursos clássicos para recursos baseados em espaço de trabalho em maio de 2024 e essa migração está em curso há vários meses. Não podemos fornecer datas aproximadas em que recursos, assinaturas ou regiões específicos são migrados.

Recomendamos fortemente a migração manual para recursos baseados em espaços de trabalho. Este processo é iniciado através da seleção do banner de aviso de aposentadoria. Você pode encontrá-lo no painel Visão geral do recurso clássico do Application Insights do portal do Azure. Esse processo geralmente envolve uma única etapa para escolher qual espaço de trabalho do Log Analytics é 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 não desejar que seu recurso clássico seja migrado automaticamente para um recurso baseado em espaço de trabalho, 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 recebiam 1 GB por mês gratuitamente por meio do modelo de preços herdado do Application Insights não recebem os dados gratuitos.
  • Os recursos do Application Insights que estavam no nível de preço básico antes de abril de 2018 continuam a ser cobrados no mesmo ponto de preço não regional que antes de abril de 2018. Os recursos do Application Insights criados após esse período, ou os recursos convertidos para serem baseados em espaço de trabalho, receberão os preços regionais atuais. Para obter os preços atuais em sua moeda e região, consulte Preços do Application Insights.

A migração para o Application Insights baseado em espaço de trabalho oferece muitas opções para otimizar ainda mais os custos, incluindo camadas de compromisso do Log Analytics, clusters dedicados e logs básicos e auxiliares.

Como funcionará o limite de telemetria?

Você pode definir um limite diário no espaço de trabalho do Log Analytics.

Não há limites de faturamento rigorosos disponíveis.

Como funcionará a amostragem baseada na ingestão?

Não há alterações na amostragem baseada na ingestão.

Existem lacunas nos dados recolhidos durante a migração?

N.º Mesclamos dados durante o tempo de consulta.

As consultas de log antigas continuam a funcionar?

Sim, continuam a trabalhar.

Meus painéis com gráficos fixos de métricas e logs continuarão a funcionar após a migração?

Sim, continuam a trabalhar.

A migração afeta o acesso aos dados da API do AppInsights?

N.º A migração não afeta o acesso existente à API aos dados. Após a migração, você pode acessar dados diretamente de um espaço de trabalho usando um esquema ligeiramente diferente.

Há algum impacto no Live Metrics ou em outras experiências de monitoramento?

N.º Não há impacto no Live Metrics 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ê precisa migrar para as configurações de diagnóstico antes de migrar para o recurso baseado em espaço de trabalho. A configuração de diagnóstico é transferida na migração para o Application Insights baseado em espaço de trabalho.

Como posso 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 azurerm Terraform antes de tentar atualizar seu 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 Application Insights baseado em espaço de trabalho de substituição. Ele 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 esse problema, certifique-se de usar a versão mais recente do provedor azurerm Terraform, versão 3.89 ou superior. Ele executa as etapas de migração adequadas emitindo a chamada apropriada do Azure Resource Manager (ARM) para atualizar o recurso clássico do App Insights para um recurso baseado em espaço de trabalho, preservando todos os dados antigos e os valores de chave de cadeia de conexão/instrumentação.

Ainda posso usar a API antiga para criar recursos do Application Insights programaticamente?

Para compatibilidade com versões anteriores, as chamadas para a API antiga para criar recursos do Application Insights continuam a funcionar. Cada uma dessas chamadas cria um recurso do Application Insights baseado em espaço de trabalho e um espaço de trabalho do Log Analytics para armazenar os dados.

Recomendamos vivamente a atualização para a nova API para um melhor controlo sobre a criação de recursos.

Devo migrar as configurações de diagnóstico no Application Insights clássico antes de mudar para uma IA baseada em espaço de trabalho?

Sim, recomendamos migrar as configurações de diagnóstico em recursos clássicos do Application Insights antes de fazer a transição para um Application Insights baseado em espaço de trabalho. Ele garante a continuidade e compatibilidade de suas configurações de diagnóstico.

Resolução de Problemas

Esta seção fornece dicas de solução de problemas.

Modo de acesso

Mensagem de erro: "O espaço de trabalho selecionado está configurado com o modo de acesso baseado em espaço de trabalho. Alguns recursos de monitoramento de desempenho de aplicativos (APM) podem ser afetados. Selecione outro espaço de trabalho ou permita acesso baseado em recursos nas configurações do espaço de trabalho. Você pode substituir esse erro usando a CLI."

Para que seu recurso do Application Insights baseado em espaço de trabalho funcione corretamente, você precisa alterar o modo de controle de acesso do espaço de trabalho do Log Analytics de destino para a configuração de permissões de recurso ou espaço de trabalho. Essa configuração está localizada na interface do usuário do espaço de trabalho do Log Analytics no modo de controle de acesso de propriedades>. Para obter instruções, consulte as diretrizes de modo de controle de acesso de configuração do Log Analytics. Se o modo de controle de acesso estiver definido para a configuração exclusiva Exigir permissões do espaço de trabalho, a migração por meio da experiência de migração do portal permanecerá bloqueada.

Se não for possível alterar o modo de controle de acesso por motivos de segurança para seu espaço de trabalho de destino atual, crie um novo espaço de trabalho do Log Analytics para usar na migração.

Continuous export (Exportação contínua)

Mensagem de erro: "A exportação contínua precisa ser desabilitada antes de continuar. Após a migração, use as Configurações de diagnóstico para exportação."

A funcionalidade de exportação contínua herdada não é suportada 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. Habilite as Configurações de diagnóstico em seu recurso clássico do Application Insights.

  2. Na visualização de recursos do Application Insights, sob o título "Configurar", selecione "Exportação contínua".

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

  3. Selecione Desativar.

    Captura de tela que mostra o botão Desativar exportação contínua.

    • Depois de selecionar Desabilitar, você pode voltar para a interface do usuário de migração. Se a página Editar exportação contínua solicitar que suas configurações não sejam salvas, selecione OK. Esse prompt não diz respeito à desativação ou habilitação da exportação contínua.

    • Depois de migrar o recurso do Application Insights, você pode usar as configurações de diagnóstico para substituir a funcionalidade que a exportação contínua costumava fornecer. Selecione Configurações>de diagnóstico Adicionar configuração 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 os Hubs de Eventos do Azure. Para obter mais informações sobre 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: "Suas configurações personalizadas de retenção do Application Insights não se aplicam aos dados enviados para o espaço de trabalho. Você precisa reconfigurá-los separadamente."

Você não precisa fazer nenhuma alteração antes de migrar. Esta mensagem alerta que suas configurações atuais de retenção do Application Insights 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 para seu espaço de trabalho do Log Analytics antes de migrar e começar a ingerir novos dados.

Você pode verificar suas configurações de retenção atuais para o Log Analytics em Configurações>de uso e custos>estimados Retenção de dados na interface do usuário do Log Analytics. Essa configuração afeta por quanto tempo os novos dados ingeridos são armazenados após a migração do recurso do Application Insights.

Alterações dos recursos baseados na área 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 KQL (Kusto Query Language). Os dados de recursos do Application Insights baseados em espaço de trabalho são armazenados em um espaço de trabalho do Log Analytics, juntamente com outros dados de monitoramento e dados de aplicativos. Esta disposição simplifica a sua configuração. Você pode analisar dados em várias soluções mais facilmente e usar os recursos dos espaços de trabalho.

Estrutura de dados clássica

A estrutura de um espaço de trabalho do Log Analytics é descrita na visão geral do espaço de trabalho do Log Analytics. Para um aplicativo clássico, os dados não são armazenados em um espaço de trabalho 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 é a mesma que para aplicativos baseados em espaço de trabalho, embora os nomes de tabela e coluna sejam diferentes.

Nota

A experiência clássica do Application Insights inclui compatibilidade com versões anteriores para suas consultas de recursos, pastas de trabalho e alertas baseados em log. Para consultar ou exibir a nova estrutura ou esquema de tabela baseado em espaço de trabalho, primeiro vá para o espaço de trabalho do Log Analytics. Durante a visualização, selecionar Logs no painel Application Insights dá acesso à experiência clássica de consulta do Application Insights. Para obter mais informações, consulte Escopo da consulta.

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

Estrutura da tabela

Nome da tabela herdada Novo nome da tabela Description
availabilityResults AppAvailabilityResultados Dados resumidos de testes de disponibilidade.
browserTimings AppBrowserTimings Dados sobre o desempenho do cliente, como o tempo necessário para processar os dados de entrada.
dependências AppDependencies Chamadas do aplicativo para outros componentes (incluindo componentes externos) gravadas via TrackDependency(). Exemplos são chamadas para a API REST ou banco de dados ou 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 visualização do site com informações do navegador.
performanceCounters Contadores AppPerformanceCounter Medições de desempenho dos recursos de computação que suportam o aplicativo. Um exemplo são os contadores de desempenho do Windows.
pedidos AppRequests Pedidos recebidos pela sua candidatura. Por exemplo, um registro de solicitação separado é registrado para cada solicitação HTTP que seu aplicativo Web recebe.
exceções AppExceptions Exceções geradas pelo tempo de execução do aplicativo. Captura exceções do lado do servidor e do lado do cliente (navegadores).
rastreios Rastreios de aplicativos Logs detalhados (rastreamentos) emitidos por meio de código de aplicativo/estruturas de registro registradas via TrackTrace().

Atenção

Aguarde a nova telemetria no Log Analytics antes de confiar nela. Depois de iniciar a migração, a telemetria vai primeiro para o Classic Application Insights. A ingestão de telemetria é mudada para o Log Analytics em 24 horas. Uma vez feito, 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ássicos e os novos nomes de propriedade do Application Insights baseados em espaço de trabalho. Use essas informações para converter quaisquer consultas usando tabelas herdadas.

A maioria das colunas tem o mesmo nome com maiúsculas diferentes. O KQL diferencia maiúsculas de minúsculas, portanto, você precisa alterar o nome de cada coluna junto com os nomes das tabelas em consultas existentes. As colunas com alterações, além da capitalização, são realçadas. Você ainda pode usar suas consultas clássicas do Application Insights no painel Logs do recurso do Application Insights, mesmo que seja um recurso baseado em espaço de trabalho. Os novos nomes de propriedade são necessários quando você consulta de dentro do contexto da experiência do espaço de trabalho do Log Analytics.

AppAvailabilityResultados

Tabela herdada: availabilityResults

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
duration real DurationMs real
id string Id string
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type String
localização string Localização string
mensagem string Mensagem string
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
performanceBucket string PerformanceBucket string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
size real Tamanho real
exito string Com êxito Bool
carimbo de data/hora datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppBrowserTimings

Tabela herdada: browserTimings

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type string
nome 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 Fonte sintética string
performanceBucket string PerformanceBucket string
processamentoDuração real ProcessingDurationMs real
receberDuração real ReceiveDurationMs real
sdkVersion [en] string SDKVersion string
sendDuration real SendDurationMs real
session_Id string SessionId string
carimbo de data/hora datetime TimeGenerated datetime
totalDuração 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 Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
dados string Dados string
duration real DurationMs real
id string Id string
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type String
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
performanceBucket string PerformanceBucket string
Código de resultados string Código de Resultados string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
exito string Com êxito Bool
destino string Destino string
carimbo de data/hora datetime TimeGenerated datetime
tipo string DependencyType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppEvents

Tabela herdada: customEvents

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type string
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
carimbo de data/hora datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

AppMetrics

Tabela herdada: customMetrics

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
iKey string IKey string
itemId string (suprimido)
Tipo de item string Type string
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
carimbo de data/hora datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
valor real (suprimido)
valorCount número inteiro ItemCount número inteiro
valorMáximo real Máx real
valorMin real Min real
valorSoma real Soma real
valorStdDev real (suprimido)

Nota

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. Como a adoção na análise de métricas foi leve, o campo foi removido e não é mais agregado pelos SDKs. Se o valor for recebido pelo ponto de extremidade de coleta de dados do Application Insights, ele será descartado durante a ingestão e não será enviado para o espaço de trabalho do Log Analytics. Se você quiser usar o desvio padrão em sua análise, use consultas em eventos brutos do Application Insights.

AppPageViews

Tabela herdada: pageViews

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
duration real DurationMs real
id string Id string
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type String
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
performanceBucket string PerformanceBucket string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
carimbo de data/hora datetime TimeGenerated datetime
url string Url string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

Contadores AppPerformanceCounter

Tabela herdada: performanceCounters

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
category string Categoria string
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
counter string (suprimido)
customDimensions dynamic Propriedades Dinâmica
iKey string IKey string
instância string Instância string
itemId string (suprimido)
Tipo de item string Type string
nome string Nome string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
carimbo de data/hora datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string
valor real Value real

AppRequests

Tabela herdada: solicitações

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades Dinâmica
customMeasurements dynamic Medidas Dinâmica
duration real DurationMs Real
id string Id String
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type String
nome string Nome Cadeia (de carateres)
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
performanceBucket string PerformanceBucket String
Código de resultados string Código de Resultados String
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
origem string Origem String
exito string Com êxito Bool
carimbo de data/hora 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 Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
assemblagem string Assemblagem string
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades dynamic
customMeasurements dynamic Medidas dynamic
detalhes dynamic Detalhes dynamic
manipuladoEm string ManipuladoEm string
iKey string IKey string
mais interiorAssembleia string Montagem Interna string
innermostMensagem string InnermostMensagem string
innermostMethod string Método mais interno string
innermostType string Tipo mais interno string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type string
mensagem string Mensagem string
método string Método string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
Montagem externa string Montagem externa string
outerMessage string OuterMessage string
outerMethod string OuterMethod string
outerType string OuterType string
problemId string ProblemId string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
gravidadeNível número inteiro Nível de Gravidade número inteiro
carimbo de data/hora datetime TimeGenerated datetime
tipo string ExceptionType string
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string

Rastreios de aplicativos

Tabela herdada: rastreamentos

ApplicationInsights Type LogAnalytics Type
appId string ResourceGUID string
application_Version string AppVersion string
nome_do_aplicativo string (suprimido)
client_Browser string ClientBrowser string
client_City string Cidade Cliente string
client_CountryOrRegion string ClientCountryOrRegion string
client_IP string ClientIP string
client_Model string Modelo de Cliente string
client_OS string SO cliente string
client_StateOrProvince string ClientStateOrProvince string
client_Type string ClientType string
cloud_RoleInstance string AppRoleInstance string
cloud_RoleName string AppRoleName string
customDimensions dynamic Propriedades dynamic
customMeasurements dynamic Medidas dynamic
iKey string IKey string
itemContagem número inteiro ItemCount número inteiro
itemId string (suprimido)
Tipo de item string Type string
mensagem string Mensagem string
operation_Id string OperationId string
operation_Name string OperationName string
operation_ParentId string ParentId string
operation_SyntheticSource string Fonte sintética string
sdkVersion [en] string SDKVersion string
session_Id string SessionId string
gravidadeNível número inteiro Nível de Gravidade número inteiro
carimbo de data/hora datetime TimeGenerated datetime
user_AccountId string UserAccountId string
user_AuthenticatedId string UserAuthenticatedId string
user_Id string UserId string