Criar um recurso Application Insights

Atenção

Este artigo se aplica aos recursos do Application Insights Classic, que não são mais recomendados.

As informações neste artigo estão obsoletas e não serão atualizadas.

Faça a transição para o Application Insights baseado em espaço de trabalho para aproveitar os novos recursos.

O Application Insights exibe dados sobre seu aplicativo em um recurso do Azure. A criação de um novo recurso faz parte da configuração do Application Insights para monitorar um novo aplicativo. Depois de criar seu novo recurso, você pode obter sua chave de instrumentação e usá-la para configurar o SDK do Application Insights. A chave de instrumentação vincula sua telemetria ao recurso.

Importante

Em 29 de fevereiro de 2024, o suporte para o clássico Application Insights será encerrado. Faça a transição para o Application Insights baseado em espaço de trabalho para aproveitar os novos recursos. As regiões mais recentes introduzidas após fevereiro de 2021 não suportam a criação de recursos clássicos do Application Insights.

Nota

A 31 de março de 2025, o suporte da ingestão de chaves de instrumentação terminará. A ingestão de chaves de instrumentação continuará a funcionar, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar os novos recursos.

Iniciar sessão no Azure

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Criar um recurso Application Insights

Entre no portal do Azure e crie um recurso do Application Insights.

Captura de tela que mostra a seleção do sinal + no canto superior esquerdo, Ferramentas de Desenvolvedor e Informações sobre Aplicativos.

Definições valor Descrição
Nome Unique value Nome que identifica o aplicativo que você está monitorando.
Grupo de recursos myResourceGroup Nome do grupo de recursos novo ou existente para hospedar dados do Application Insights.
Região East US Selecione um local perto de você ou perto de onde seu aplicativo está hospedado.
Modo de recurso Classic ou Workspace-based Os recursos baseados em espaço de trabalho permitem que você envie sua telemetria do Application Insights para um espaço de trabalho comum do Log Analytics. Para obter mais informações, consulte Recursos do Application Insights baseados em espaço de trabalho.

Nota

Você pode usar o mesmo nome de recurso em diferentes grupos de recursos, mas pode ser benéfico usar um nome exclusivo globalmente. Se você planeja executar consultas entre recursos, usar um nome globalmente exclusivo simplifica a sintaxe necessária.

Insira os valores apropriados nos campos obrigatórios. Selecione Rever + criar.

Captura de ecrã que mostra a introdução de valores nos campos obrigatórios e o botão Rever + criar.

Depois que seu aplicativo é criado, um novo painel exibe dados de desempenho e uso sobre seu aplicativo monitorado.

Copie a chave de instrumentação

A chave de instrumentação identifica o recurso que você deseja associar aos seus dados de telemetria. Você precisa copiar a chave de instrumentação e adicioná-la ao código do seu aplicativo.

Instalar o SDK em seu aplicativo

Instale o SDK do Application Insights em seu aplicativo. Esta etapa depende muito do tipo de seu aplicativo.

Use a chave de instrumentação para configurar o SDK que você instala em seu aplicativo.

O SDK inclui módulos padrão que enviam telemetria, para que você não precise escrever mais código. Para acompanhar as ações do usuário ou diagnosticar problemas com mais detalhes, use a API para enviar sua própria telemetria.

Criar um recurso automaticamente

Use o PowerShell ou a CLI do Azure para criar um recurso automaticamente.

PowerShell

Crie um novo recurso do Application Insights.

New-AzApplicationInsights [-ResourceGroupName] <String> [-Name] <String> [-Location] <String> [-Kind <String>]
 [-Tag <Hashtable>] [-DefaultProfile <IAzureContextContainer>] [-WhatIf] [-Confirm] [<CommonParameters>]

Exemplo

New-AzApplicationInsights -Kind java -ResourceGroupName testgroup -Name test1027 -location eastus

Resultados

Id                 : /subscriptions/{subid}/resourceGroups/testgroup/providers/microsoft.insights/components/test1027
ResourceGroupName  : testgroup
Name               : test1027
Kind               : web
Location           : eastus
Type               : microsoft.insights/components
AppId              : 8323fb13-32aa-46af-b467-8355cf4f8f98
ApplicationType    : web
Tags               : {}
CreationDate       : 10/27/2017 4:56:40 PM
FlowType           :
HockeyAppId        :
HockeyAppToken     :
InstrumentationKey : 00000000-aaaa-bbbb-cccc-dddddddddddd
ProvisioningState  : Succeeded
RequestSource      : AzurePowerShell
SamplingPercentage :
TenantId           : {subid}

Para obter a documentação completa do PowerShell para este cmdlet e saber como recuperar a chave de instrumentação, consulte a documentação do Azure PowerShell.

CLI do Azure (visualização)

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 que afirma: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Execute o seguinte comando para criar seu recurso do Application Insights:

az monitor app-insights component create --app
                                         --location
                                         --resource-group
                                         [--application-type]
                                         [--kind]
                                         [--tags]

Exemplo

az monitor app-insights component create --app demoApp --location westus2 --kind web --resource-group demoRg --application-type web

Resultados

az monitor app-insights component create --app demoApp --location eastus --kind web --resource-group demoApp --application-type web
{
  "appId": "87ba512c-e8c9-48d7-b6eb-118d4aee2697",
  "applicationId": "demoApp",
  "applicationType": "web",
  "creationDate": "2019-08-16T18:15:59.740014+00:00",
  "etag": "\"0300edb9-0000-0100-0000-5d56f2e00000\"",
  "flowType": "Bluefield",
  "hockeyAppId": null,
  "hockeyAppToken": null,
  "id": "/subscriptions/{subid}/resourceGroups/demoApp/providers/microsoft.insights/components/demoApp",
  "instrumentationKey": "00000000-aaaa-bbbb-cccc-dddddddddddd",
  "kind": "web",
  "location": "eastus",
  "name": "demoApp",
  "provisioningState": "Succeeded",
  "requestSource": "rest",
  "resourceGroup": "demoApp",
  "samplingPercentage": null,
  "tags": {},
  "tenantId": {tenantID},
  "type": "microsoft.insights/components"
}

Para obter a documentação completa da CLI do Azure para este comando e saber como recuperar a chave de instrumentação, consulte a documentação da CLI do Azure.

Substituir pontos de extremidade padrão

Aviso

Não modifique pontos de extremidade. Faça a transição para cadeias de conexão para simplificar a configuração e eliminar a necessidade de modificação do ponto final.

Para enviar dados do Application Insights para determinadas regiões, você precisa substituir os endereços de ponto de extremidade padrão. Cada SDK requer modificações ligeiramente diferentes, todas descritas neste artigo.

Essas alterações exigem que você ajuste o código de exemplo e substitua os valores de espaço reservado para QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addresse Profile_Query_Endpoint_address com os endereços de ponto de extremidade reais para sua região específica. O final deste artigo contém links para os endereços de ponto de extremidade para regiões onde essa configuração é necessária.

Nota

A 31 de março de 2025, o suporte da ingestão de chaves de instrumentação terminará. A ingestão de chaves de instrumentação continuará a funcionar, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar os novos recursos.


Alterações no código do SDK

Nota

O arquivo applicationinsights.config é substituído automaticamente sempre que uma atualização do SDK é executada. Depois de executar uma atualização do SDK, certifique-se de inserir novamente os valores de ponto de extremidade específicos da região.

<ApplicationInsights>
  ...
  <TelemetryModules>
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector">
      <QuickPulseServiceEndpoint>Custom_QuickPulse_Endpoint_Address</QuickPulseServiceEndpoint>
    </Add>
  </TelemetryModules>
   ...
  <TelemetrySinks>
    <Add Name = "default">
      <TelemetryChannel>
         <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
      </TelemetryChannel>
    </Add>
  </TelemetrySinks>
  ...
  <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
    <ProfileQueryEndpoint>Profile_Query_Endpoint_address</ProfileQueryEndpoint>
  </ApplicationIdProvider>
  ...
</ApplicationInsights>

Regiões que exigem modificação de ponto de extremidade

Atualmente, as únicas regiões que exigem modificações de ponto de extremidade são o Azure Government e o Azure China.

País/Região Nome do ponto final Value
Azure China Canal de Telemetria https://dc.applicationinsights.azure.cn/v2/track
Azure China QuickPulse (métricas ao vivo) https://live.applicationinsights.azure.cn/QuickPulseService.svc
Azure China Consulta de perfil https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId
Azure Government Canal de Telemetria https://dc.applicationinsights.us/v2/track
Azure Government QuickPulse (métricas ao vivo) https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government Consulta de perfil https://dc.applicationinsights.us/api/profiles/{0}/appId

Se você usa atualmente a API REST do Application Insights, que normalmente é acessada via api.applicationinsights.io, você precisa usar um ponto de extremidade que seja local para sua região.

País/Região Nome do ponto final Value
Azure China API REST api.applicationinsights.azure.cn
Azure Government API REST api.applicationinsights.us

Próximos passos