Application Insights 리소스 만들기

아티클
02/28/2023

주의

이 문서는 더 이상 권장되지 않는 Application Insights 클래식 리소스에 적용됩니다.

이 문서의 정보는 부실하며 업데이트되지 않습니다.

작업 영역 기반 Application Insights로 전환하여 새로운 기능을 활용합니다.

Application Insights는 Azure 리소스에서 애플리케이션에 대한 데이터를 표시합니다. 새 리소스를 만드는 것은 새 애플리케이션을 모니터링하도록 Application Insights를 설정하는 과정의 일부입니다. 새 리소스를 만든 후에는 해당 계측 키를 가져와서 Application Insights SDK를 구성하는 데 사용할 수 있습니다. 계측 키는 원격 분석을 리소스에 연결합니다.

중요

2024년 2월 29일에 클래식 Application Insights에 대한 지원이 종료됩니다. 작업 영역 기반 Application Insights로 전환하여 새로운 기능을 활용합니다. 2021년 2월 이후에 도입된 최신 지역은 클래식 Application Insights 리소스 만들기를 지원하지 않습니다.

참고

2025년 3월 31일에 계측 키 수집에 대한 지원이 종료됩니다. 계측 키 수집은 계속 작동하지만 더 이상 기능에 대한 업데이트 또는 지원을 제공하지 않습니다. 연결 문자열로 전환하여 새로운 기능을 활용합니다.

Azure 구독이 아직 없는 경우 시작하기 전에 체험 계정을 만듭니다.

Application Insights 리소스 만들기

Azure Portal 로그인하고 Application Insights 리소스를 만듭니다.

왼쪽 위 모서리에 있는 + 로그인, 개발자 도구 및 Application Insights 선택을 보여 주는 스크린샷

설정	값	Description
이름	`Unique value`	모니터링 중인 앱을 식별하는 이름
리소스 그룹	`myResourceGroup`	Application Insights 데이터를 호스트할 새 리소스 또는 기존 리소스 그룹의 이름입니다.
지역	`East US`	앱이 호스트되는 위치 또는 가까운 위치를 선택합니다.
리소스 모드	`Classic` 또는 `Workspace-based`	작업 영역 기반 리소스를 사용하면 Application Insights 원격 분석을 일반적인 Log Analytics 작업 영역으로 보낼 수 있습니다. 자세한 내용은 작업 영역 기반 Application Insights 리소스를 참조하세요.

참고

여러 리소스 그룹에서 동일한 리소스 이름을 사용할 수 있지만 전역적으로 고유한 이름을 사용하는 것이 도움이 될 수 있습니다. 리소스 간 쿼리를 수행하려는 경우 전역적으로 고유한 이름을 사용하면 필요한 구문이 간소화됩니다.

필요한 필드에 적절한 값을 입력합니다. 검토 + 만들기를 선택합니다.

필수 필드에 값을 입력하고 검토 + 만들기 단추를 보여 주는 스크린샷

앱을 만든 후 새 창에 모니터링되는 애플리케이션에 대한 성능 및 사용 현황 데이터가 표시됩니다.

계측 키 복사

계측 키는 원격 분석 데이터와 연결하려는 리소스를 식별합니다. 계측 키를 복사하여 애플리케이션의 코드에 추가해야 합니다.

응용 프로그램에 SDK를 설치합니다.

Application Insights SDK를 애플리케이션에 설치합니다. 이 단계는 애플리케이션의 형식에 따라 크게 달라 집니다.

계측 키를 사용하여 애플리케이션에 설치한 SDK를 구성합니다.

SDK에는 원격 분석을 보내는 표준 모듈이 포함되어 있으므로 더 이상 코드를 작성할 필요가 없습니다. 사용자 작업을 추적하거나 문제를 보다 세부적으로 진단하려면 API를 사용하여 사용자 고유의 원격 분석을 보내도록 합니다.

자동으로 리소스 만들기

PowerShell 또는 Azure CLI를 사용하여 리소스를 자동으로 만듭니다.

PowerShell

새 Application Insights 리소스를 만듭니다.

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

예제

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

결과

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}

이 cmdlet에 관한 전체 PowerShell 설명서를 보고 계측 키를 검색하는 방법을 알아보려면 Azure PowerShell 설명서를 참조하세요.

Azure CLI(미리 보기)

미리 보기 Application Insights Azure CLI 명령에 액세스하려면 먼저 다음을 실행해야 합니다.

 az extension add -n application-insights

명령을 실행 az extension add 하지 않으면 다음과 같은 오류 메시지가 표시됩니다. az : ERROR: az monitor: 'app-insights' is not in the 'az monitor' command group. See 'az monitor --help'.

다음 명령을 실행하여 Application Insights 리소스를 만듭니다.

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

예제

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

결과

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"
}

이 명령에 대한 전체 Azure CLI 설명서와 계측 키를 검색하는 방법을 알아보려면 Azure CLI 설명서를 참조하세요.

기본 엔드포인트 재정의

경고

엔드포인트를 수정하지 마세요. 연결 문자열로 전환하면 구성을 간소화할 수 있고 엔드포인트를 수정하지 않아도 됩니다.

Application Insights에서 특정 지역으로 데이터를 보내려면 기본 엔드포인트 주소를 재정의해야 합니다. 각 SDK에는 약간 다른 수정이 필요하며, 이는 모두 이 문서에 설명되어 있습니다.

이러한 변경 내용을 적용하려면 샘플 코드를 조정하고 , TelemetryChannel_Endpoint_AddressProfile_Query_Endpoint_address 및 의 QuickPulse_Endpoint_Address자리 표시자 값을 특정 지역의 실제 엔드포인트 주소로 바꿔야 합니다. 이 문서의 끝에는 이 구성이 필요한 지역의 엔드포인트 주소에 대한 링크가 포함되어 있습니다.

참고

SDK 코드 변경

참고

applicationinsights.config 파일은 SDK 업그레이드가 수행될 때마다 자동으로 덮어씁니다. SDK 업그레이드를 수행한 후에는 지역별 엔드포인트 값을 다시 입력해야 합니다.

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

프로젝트에서 appsettings.json 파일을 수정하여 주 엔드포인트를 조정합니다.

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

라이브 메트릭 및 프로필 쿼리 엔드포인트의 값은 코드를 통해서만 설정할 수 있습니다. 코드를 통해 모든 엔드포인트 값의 기본값을 재정의하려면 Startup.cs 파일의 ConfigureServices 메서드를 다음과 같이 변경합니다.

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

applicationinsights.xml 파일을 수정하여 기본 엔드포인트 주소를 변경합니다.

<?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

application.properties 파일을 수정하고 다음을 추가합니다.

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

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();

환경 변수를 통해 엔드포인트를 구성할 수도 있습니다.

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

여기에 나열된 현재 코드 조각은 버전 5입니다. 버전은 코드 조각에서 로 sv:"#"인코딩됩니다. 현재 버전은 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>

참고

가독성을 높이고 가능한 JavaScript 오류를 줄이기 위해 가능한 모든 구성 옵션이 이전 코드 조각 코드의 새 줄에 나열됩니다. 주석 처리된 줄의 값을 변경하지 않으려면 제거할 수 있습니다.

엔드포인트를 수정해야 하는 지역

현재 엔드포인트를 수정해야 하는 유일한 지역은 Azure Government와 Azure 중국입니다.

지역	엔드포인트 이름	값
Azure 중국	원격 분석 채널	`https://dc.applicationinsights.azure.cn/v2/track`
Azure 중국	QuickPulse(라이브 메트릭)	`https://live.applicationinsights.azure.cn/QuickPulseService.svc`
Azure 중국	프로필 쿼리	`https://dc.applicationinsights.azure.cn/api/profiles/{0}/appId`
Azure Government	원격 분석 채널	`https://dc.applicationinsights.us/v2/track`
Azure Government	QuickPulse(라이브 메트릭)	`https://quickpulse.applicationinsights.us/QuickPulseService.svc`
Azure Government	프로필 쿼리	`https://dc.applicationinsights.us/api/profiles/{0}/appId`

일반적으로 를 통해 api.applicationinsights.io액세스되는 Application Insights REST API를 현재 사용하는 경우 해당 지역에 로컬인 엔드포인트를 사용해야 합니다.

지역	엔드포인트 이름	값
Azure 중국	REST API	`api.applicationinsights.azure.cn`
Azure Government	REST API	`api.applicationinsights.us`

다음 단계

진단 검색을 사용합니다.
메트릭을 탐색합니다.
Log Analytics 쿼리를 작성합니다.
Azure Government 대한 사용자 지정 수정에 대한 자세한 내용은 Azure 모니터링 및 관리에 대한 자세한 지침을 참조하세요.
Azure 중국에 대한 자세한 내용은 Azure 중국 플레이북을 참조하세요.

Application Insights 리소스 만들기

Azure에 로그인

Application Insights 리소스 만들기

계측 키 복사

응용 프로그램에 SDK를 설치합니다.

자동으로 리소스 만들기

PowerShell

예제

결과

Azure CLI(미리 보기)

예제

결과

기본 엔드포인트 재정의

SDK 코드 변경

엔드포인트를 수정해야 하는 지역

다음 단계

추가 리소스