Criar um recurso do Application Insights

Cuidado

Este artigo se aplica aos recursos Clássicos do Application Insights, 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 workspace para aproveitar as novas funcionalidades.

O Application Insights exibe dados sobre o seu aplicativo em um recurso do Microsoft Azure. Por isso, criar um recurso faz parte da configuração do Application Insights para monitorar um novo aplicativo. Depois de criar o novo recurso, você pode obter a chave de instrumentação dele 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 Application Insights clássico será encerrado. Faça a transição para o Application Insights baseado em workspace para aproveitar as novas funcionalidades. Regiões mais recentes introduzidas após fevereiro de 2021 não dão suporte à criação de recursos clássicos do Application Insights.

Observação

Em 31 de março de 31, 2025, o suporte à ingestão de chave de instrumentação será encerrado. A ingestão de chave de instrumentação continuará funcionando, mas não forneceremos mais atualizações ou suporte para o recurso. Faça a transição para cadeias de conexão para aproveitar as novas funcionalidades.

Entrar no Azure

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

Criar um recurso do 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 para Desenvolvedores e Application Insights.

Configurações Valor Descrição
Nome Unique value Nome que identifica o aplicativo que você está monitorando.
Grupo de recursos myResourceGroup Nome para o grupo de recursos novo ou existente no qual hospedar dados do Application Insights.
Região East US Escolha uma localização perto de você ou 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 no espaço de trabalho.

Observação

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

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

Captura de tela que mostra a inserção de valores nos campos obrigatórios e o botão Revisar + criar.

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

Copiar a chave de instrumentação

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

Instalar o SDK em seu aplicativo

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

Use a chave de instrumentação para configurar o SDK instalado no seu aplicativo.

O SDK inclui módulos padrão que enviam telemetria sem precisar escrever nenhum código. Para rastrear ações do usuário ou diagnosticar problemas mais detalhadamente, use a API para enviar sua própria telemetria.

Criar um recurso automaticamente

Use o PowerShell ou a CLI do Azure para criar um grupo de recursos.

PowerShell

Criar 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 esse cmdlet e saber como recuperar a chave de instrumentação, confira a documentação do Azure PowerShell.

CLI do Azure (versão prévia)

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

Execute o comando a seguir para criar o 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 esse 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 os 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 de ponto de extremidade.

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

Essas alterações exigem o ajuste do código de exemplo e a substituição dos valores do espaço reservado para QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Address e Profile_Query_Endpoint_address pelos endereços do ponto de extremidade reais para a região específica. No final deste artigo estão listados os links dos endereços de ponto de extremidade para as regiões em que essa configuração é necessária.

Observação

Em 31 de março de 31, 2025, o suporte à ingestão de chave de instrumentação será encerrado. A ingestão de chave de instrumentação continuará funcionando, mas não forneceremos mais atualizações ou suporte para o recurso. Transição para cadeias de conexão para aproveitar as novas funcionalidades.


Alterações de código do SKD

Observação

O arquivo applicationinsights.config é substituído automaticamente sempre que uma atualização do SDK é executada. Depois de executar uma atualização do SDK, não esqueça 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 Governamental e o Azure China.

Região Nome do ponto de extremidade Valor
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, atualmente, você usa a API REST do Application Insights que normalmente é acessada via api.applicationinsights.io, será necessário usar um ponto de extremidade que seja local para sua região.

Região Nome do ponto de extremidade Valor
Azure China API REST api.applicationinsights.azure.cn
Azure Government API REST api.applicationinsights.us

Próximas etapas