Criar um recurso do Application Insights

Atenção

Este artigo aplica-se aos recursos clássicos do Application Insights, que já não são recomendados.

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

Transição para o Application Insights baseado na área de trabalho para tirar partido de novas capacidades.

O Application Insights apresenta dados sobre a sua aplicação num recurso do Azure. A criação de um novo recurso faz parte da configuração do Application Insights para monitorizar uma nova aplicação. Depois de criar o novo recurso, pode obter a respetiva chave de instrumentação e utilizá-la para configurar o SDK do Application Insights. A chave de instrumentação liga a telemetria ao recurso.

Importante

A 29 de fevereiro de 2024,o suporte para o Application Insights clássico terminará. Transição para o Application Insights baseado na área de trabalho para tirar partido de novas capacidades. 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 chave de instrumentação continuará a funcionar, mas deixaremos de fornecer atualizações ou suporte para a funcionalidade. Transição para cadeias de ligação para tirar partido de novas capacidades.

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 do Application Insights

Inicie sessão no portal do Azure e crie um recurso do Application Insights.

Definições	Valor	Descrição
Nome	Unique value	Nome que identifica a aplicação que está a monitorizar.
Grupo de recursos	myResourceGroup	Nome do grupo de recursos novo ou existente para alojar dados do Application Insights.
Região	East US	Selecione uma localização perto de si ou perto do local onde a sua aplicação está alojada.
Modo de recurso	Classic ou Workspace-based	Os recursos baseados na área de trabalho permitem-lhe enviar a telemetria do Application Insights para uma área de trabalho comum do Log Analytics. Para obter mais informações, veja Recursos do Application Insights baseados na área de trabalho.

Nota

Pode utilizar o mesmo nome de recurso em diferentes grupos de recursos, mas pode ser vantajoso utilizar um nome globalmente exclusivo. Se planear efetuar consultas entre recursos, utilizar um nome globalmente exclusivo simplifica a sintaxe necessária.

Introduza os valores adequados nos campos necessários. Selecione Rever + criar.

Após a criação da aplicação, um novo painel apresenta dados de desempenho e utilização sobre a sua aplicação monitorizada.

Copiar a chave de instrumentação

A chave de instrumentação identifica o recurso que pretende associar aos seus dados telemétricos. Tem de copiar a chave de instrumentação e adicioná-la ao código da sua aplicação.

Instalar o SDK na sua aplicação

Instale o SDK do Application Insights na sua aplicação. Este passo depende muito do tipo da sua aplicação.

Utilize a chave de instrumentação para configurar o SDK que instala na sua aplicação.

O SDK inclui módulos padrão que enviam telemetria, pelo que não tem de escrever mais código. Para controlar as ações dos utilizadores ou diagnosticar problemas mais detalhadamente, utilize a API para enviar a sua própria telemetria.

Criar um recurso automaticamente

Utilize 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 para saber como obter a chave de instrumentação, veja a documentação Azure PowerShell.

CLI do Azure (pré-visualização)

Para aceder aos comandos da CLI do Azure do Application Insights de pré-visualização, primeiro tem de executar:

 az extension add -n application-insights

Se não executar o az extension add comando, verá uma mensagem de erro que indica: az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

Execute o seguinte comando 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 este comando e para saber como obter a chave de instrumentação, veja a documentação da CLI do Azure.

Substituir pontos finais predefinidos

Aviso

Não modifique os pontos finais. Transição para cadeias de ligaçã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, tem de substituir os endereços de ponto final predefinidos. Cada SDK requer modificações ligeiramente diferentes, todas descritas neste artigo.

Estas alterações exigem que ajuste o código de exemplo e substitua os valores do marcador de posição para QuickPulse_Endpoint_Address, TelemetryChannel_Endpoint_Addresse Profile_Query_Endpoint_address pelos endereços de ponto final reais para a sua região específica. O fim deste artigo contém ligações para os endereços de ponto final para regiões onde esta 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 chave de instrumentação continuará a funcionar, mas deixaremos de fornecer atualizações ou suporte para a funcionalidade. Transição para cadeias de ligação para tirar partido de novas capacidades.

---

Alterações ao código do SDK

.NET

Nota

O ficheiroapplicationinsights.config é substituído automaticamente sempre que for efetuada uma atualização do SDK. Depois de efetuar uma atualização do SDK, certifique-se de que reintroduzi os valores de ponto final 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 ficheiro appsettings.json no seu projeto para ajustar o ponto final principal:

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

Os valores das Métricas dinâmicas e do ponto final da Consulta de Perfil só podem ser definidos através de código. Para substituir os valores predefinidos de todos os valores de ponto final através de código, faça as seguintes alterações no ConfigureServices método do Startup.cs ficheiro:

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 Funções do Azure, recomendamos que utilize cadeias de ligação definidas nas definições da Aplicação 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 Definições>definições da Aplicação deConfiguração>.

Nome: APPLICATIONINSIGHTS_CONNECTION_STRING
Valor: Connection String Value

Java

Modifique o ficheiro applicationinsights.xml para alterar o endereço de ponto final predefinido:

<?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 ficheiro 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 finais também podem ser configurados através de variáveis de ambiente:

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

JavaScript

O fragmento atual listado aqui é a versão 5. A versão está codificada no fragmento 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 legibilidade e para reduzir possíveis erros de JavaScript, todas as opções de configuração possíveis estão listadas numa nova linha no código de fragmento anterior. Se não quiser alterar o valor de uma linha comentada, pode ser removido.

Python

Para obter orientações sobre como modificar o ponto final de ingestão para o SDK opencensus-python, consulte o repositório opencensus-python.

Regiões que necessitam de modificação do ponto final

Atualmente, as únicas regiões que necessitam de modificações de pontos finais são Azure Government e Azure China.

Região	Nome do ponto final	Valor
Azure China	Canal de Telemetria	https://dc.applicationinsights.azure.cn/v2/track
Azure China	QuickPulse (Métricas em Direto)	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 em Direto)	https://quickpulse.applicationinsights.us/QuickPulseService.svc
Azure Government	Consulta de Perfil	https://dc.applicationinsights.us/api/profiles/{0}/appId

Se utilizar atualmente a API REST do Application Insights, que é normalmente acedida através api.applicationinsights.iodo , tem de utilizar um ponto final local para a sua região.

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

Passos seguintes

• Utilize a Pesquisa de Diagnóstico.
• Explorar métricas.
• Escrever consultas do Log Analytics.
• Para saber mais sobre as modificações personalizadas para Azure Government, veja as orientações detalhadas para a monitorização e gestão do Azure.
• Para saber mais sobre o Azure China, consulte o Manual de Procedimentos do Azure China.