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.

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.

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

.NET

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>

.NET Core

Modifique o arquivo appsettings.json em seu projeto para ajustar o ponto de extremidade principal:

"ApplicationInsights": {
    "InstrumentationKey": "instrumentationkey",
    "TelemetryChannel": {
      "EndpointAddress": "TelemetryChannel_Endpoint_Address"
    }
  }

Os valores para Live Metrics e o ponto de extremidade Profile Query só podem ser definidos via código. Para substituir os valores padrão para todos os valores de ponto de extremidade via código, faça as seguintes alterações no ConfigureServices método do Startup.cs arquivo:

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse; //Place at top of Startup.cs file

   services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) => module.QuickPulseServiceEndpoint="QuickPulse_Endpoint_Address");

   services.AddSingleton<IApplicationIdProvider, ApplicationInsightsApplicationIdProvider>(_ => new ApplicationInsightsApplicationIdProvider() { ProfileQueryEndpoint = "Profile_Query_Endpoint_address" });

   services.AddSingleton<ITelemetryChannel>(_ => new ServerTelemetryChannel() { EndpointAddress = "TelemetryChannel_Endpoint_Address" });

    //Place in the ConfigureServices method. Place this before services.AddApplicationInsightsTelemetry("instrumentation key"); if it's present

Funções do Azure

Para o Azure Functions, recomendamos que você use cadeias de conexão definidas nas configurações do Aplicativo da função. Para aceder às definições da Aplicação para a sua função a partir do painel de funções, selecione Definições>Configuração>Definições da Aplicação.

Designação: APPLICATIONINSIGHTS_CONNECTION_STRING
Valor: Connection String Value

Java

Modifique o arquivo applicationinsights.xml para alterar o endereço do ponto de extremidade padrão:

<?xml version="1.0" encoding="utf-8"?>
<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
  <InstrumentationKey>ffffeeee-dddd-cccc-bbbb-aaaa99998888</InstrumentationKey>
  <TelemetryModules>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebRequestTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebSessionTrackingTelemetryModule"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.modules.WebUserTrackingTelemetryModule"/>
  </TelemetryModules>
  <TelemetryInitializers>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationIdTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebOperationNameTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebSessionTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserTelemetryInitializer"/>
    <Add type="com.microsoft.applicationinsights.web.extensibility.initializers.WebUserAgentTelemetryInitializer"/>
  </TelemetryInitializers>
  <!--Add the following Channel value to modify the Endpoint address-->
  <Channel type="com.microsoft.applicationinsights.channel.concrete.inprocess.InProcessTelemetryChannel">
  <EndpointAddress>TelemetryChannel_Endpoint_Address</EndpointAddress>
  </Channel>
</ApplicationInsights>

Spring Boot

Modifique o application.properties arquivo e adicione:

azure.application-insights.channel.in-process.endpoint-address= TelemetryChannel_Endpoint_Address

Node.js

var appInsights = require("applicationinsights");
appInsights.setup('INSTRUMENTATION_KEY');
appInsights.defaultClient.config.endpointUrl = "TelemetryChannel_Endpoint_Address"; // ingestion
appInsights.defaultClient.config.profileQueryEndpoint = "Profile_Query_Endpoint_address"; // appid/profile lookup
appInsights.defaultClient.config.quickPulseHost = "QuickPulse_Endpoint_Address"; //live metrics
appInsights.Configuration.start();

Os pontos de extremidade também podem ser configurados por meio de variáveis de ambiente:

**Instrumentation Key*: "APPINSIGHTS_INSTRUMENTATIONKEY"
*Profile endpoint*: "Profile_Query_Endpoint_address"
*Live Metrics endpoint*: "QuickPulse_Endpoint_Address"

JavaScript

O trecho atual listado aqui é a versão 5. A versão é codificada no trecho como sv:"#". A versão atual também está disponível no GitHub.

<script type="text/javascript">
!function(T,l,y){var S=T.location,k="script",D="instrumentationKey",C="ingestionendpoint",I="disableExceptionTracking",E="ai.device.",b="toLowerCase",w="crossOrigin",N="POST",e="appInsightsSDK",t=y.name||"appInsights";(y.name||T[e])&&(T[e]=t);var n=T[t]||function(d){var g=!1,f=!1,m={initialize:!0,queue:[],sv:"5",version:2,config:d};function v(e,t){var n={},a="Browser";return n[E+"id"]=a[b](),n[E+"type"]=a,n["ai.operation.name"]=S&&S.pathname||"_unknown_",n["ai.internal.sdkVersion"]="javascript:snippet_"+(m.sv||m.version),{time:function(){var e=new Date;function t(e){var t=""+e;return 1===t.length&&(t="0"+t),t}return e.getUTCFullYear()+"-"+t(1+e.getUTCMonth())+"-"+t(e.getUTCDate())+"T"+t(e.getUTCHours())+":"+t(e.getUTCMinutes())+":"+t(e.getUTCSeconds())+"."+((e.getUTCMilliseconds()/1e3).toFixed(3)+"").slice(2,5)+"Z"}(),iKey:e,name:"Microsoft.ApplicationInsights."+e.replace(/-/g,"")+"."+t,sampleRate:100,tags:n,data:{baseData:{ver:2}}}}var h=d.url||y.src;if(h){function a(e){var t,n,a,i,r,o,s,c,u,p,l;g=!0,m.queue=[],f||(f=!0,t=h,s=function(){var e={},t=d.connectionString;if(t)for(var n=t.split(";"),a=0;a<n.length;a++){var i=n[a].split("=");2===i.length&&(e[i[0][b]()]=i[1])}if(!e[C]){var r=e.endpointsuffix,o=r?e.location:null;e[C]="https://"+(o?o+".":"")+"dc."+(r||"services.visualstudio.com")}return e}(),c=s[D]||d[D]||"",u=s[C],p=u?u+"/v2/track":d.endpointUrl,(l=[]).push((n="SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details)",a=t,i=p,(o=(r=v(c,"Exception")).data).baseType="ExceptionData",o.baseData.exceptions=[{typeName:"SDKLoadFailed",message:n.replace(/\./g,"-"),hasFullStack:!1,stack:n+"\nSnippet failed to load ["+a+"] -- Telemetry is disabled\nHelp Link: https://go.microsoft.com/fwlink/?linkid=2128109\nHost: "+(S&&S.pathname||"_unknown_")+"\nEndpoint: "+i,parsedStack:[]}],r)),l.push(function(e,t,n,a){var i=v(c,"Message"),r=i.data;r.baseType="MessageData";var o=r.baseData;return o.message='AI (Internal): 99 message:"'+("SDK LOAD Failure: Failed to load Application Insights SDK script (See stack for details) ("+n+")").replace(/\"/g,"")+'"',o.properties={endpoint:a},i}(0,0,t,p)),function(e,t){if(JSON){var n=T.fetch;if(n&&!y.useXhr)n(t,{method:N,body:JSON.stringify(e),mode:"cors"});else if(XMLHttpRequest){var a=new XMLHttpRequest;a.open(N,t),a.setRequestHeader("Content-type","application/json"),a.send(JSON.stringify(e))}}}(l,p))}function i(e,t){f||setTimeout(function(){!t&&m.core||a()},500)}var e=function(){var n=l.createElement(k);n.src=h;var e=y[w];return!e&&""!==e||"undefined"==n[w]||(n[w]=e),n.onload=i,n.onerror=a,n.onreadystatechange=function(e,t){"loaded"!==n.readyState&&"complete"!==n.readyState||i(0,t)},n}();y.ld<0?l.getElementsByTagName("head")[0].appendChild(e):setTimeout(function(){l.getElementsByTagName(k)[0].parentNode.appendChild(e)},y.ld||0)}try{m.cookie=l.cookie}catch(p){}function t(e){for(;e.length;)!function(t){m[t]=function(){var e=arguments;g||m.queue.push(function(){m[t].apply(m,e)})}}(e.pop())}var n="track",r="TrackPage",o="TrackEvent";t([n+"Event",n+"PageView",n+"Exception",n+"Trace",n+"DependencyData",n+"Metric",n+"PageViewPerformance","start"+r,"stop"+r,"start"+o,"stop"+o,"addTelemetryInitializer","setAuthenticatedUserContext","clearAuthenticatedUserContext","flush"]),m.SeverityLevel={Verbose:0,Information:1,Warning:2,Error:3,Critical:4};var s=(d.extensionConfig||{}).ApplicationInsightsAnalytics||{};if(!0!==d[I]&&!0!==s[I]){var c="onerror";t(["_"+c]);var u=T[c];T[c]=function(e,t,n,a,i){var r=u&&u(e,t,n,a,i);return!0!==r&&m["_"+c]({message:e,url:t,lineNumber:n,columnNumber:a,error:i}),r},d.autoExceptionInstrumented=!0}return m}(y.cfg);function a(){y.onInit&&y.onInit(n)}(T[t]=n).queue&&0===n.queue.length?(n.queue.push(a),n.trackPageView({})):a()}(window,document,{
src: "https://js.monitor.azure.com/scripts/b/ai.2.min.js", // The SDK URL Source
// name: "appInsights", // Global SDK Instance name defaults to "appInsights" when not supplied.
// ld: 0, // Defines the load delay (in ms) before attempting to load the sdk. -1 = block page load and add to head (default) = 0ms load after timeout.
// useXhr: 1, // Use XHR instead of fetch to report failures (if available).
crossOrigin: "anonymous", // When supplied, this will add the provided value as the cross origin attribute on the script tag.
// onInit: null, // Once the Application Insights instance has loaded and initialized, this callback function will be called with 1 argument -- the sdk instance. (DO NOT ADD anything to the sdk.queue -- as they won't get called.)
cfg: { // Application Insights Configuration
    instrumentationKey:"INSTRUMENTATION_KEY",
    endpointUrl: "TelemetryChannel_Endpoint_Address"
}});
</script>

Nota

Para facilitar a leitura e reduzir possíveis erros de JavaScript, todas as opções de configuração possíveis são listadas em uma nova linha no código de trecho anterior. Se você não quiser alterar o valor de uma linha comentada, ela pode ser removida.

Python

Para obter orientação sobre como modificar o endpoint de ingestão para o SDK opencensus-python, consulte o opencensus-python repo.

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

• Use a Pesquisa de diagnóstico.
• Explore métricas.
• Escreva consultas do Log Analytics.
• Para saber mais sobre as modificações personalizadas para o Azure Government, consulte as orientações detalhadas para monitoramento e gerenciamento do Azure.
• Para saber mais sobre o Azure China, consulte o Azure China Playbook.