Application Insights(클래식 API)를 사용하여 .NET 애플리케이션 및 서비스 모니터링

1. Visual Studio를 엽니다.
2. 새 프로젝트 만들기를 선택합니다.
3. C#으로 ASP.NET 웹 애플리케이션(.NET Framework)을 선택하고 다음을 선택합니다.
4. 프로젝트 이름을 입력한 다음 만들기를 선택합니다.
5. MVC를 선택한 다음 만들기를 선택합니다.

1. Visual Studio를 엽니다.
2. 새 프로젝트 만들기를 선택합니다.
3. C#으로 ASP.NET Core Web App(Razor Pages)을 선택하고 다음을 선택합니다.
4. 프로젝트 이름을 입력한 다음 만들기를 선택합니다.
5. 프레임워크(LTS 또는 STS)를 선택한 다음 만들기를 선택합니다.

Visual Studio의 ASP.NET 웹앱 프로젝트 내에서:

1. 프로젝트>Application Insights 원격 분석 추가>Application Insights Sdk(로컬)>다음>완료>닫기를 선택합니다.

2. ApplicationInsights.config 파일을 엽니다.

3. 닫는 </ApplicationInsights> 태그 앞에 Application Insights 리소스에 대한 연결 문자열이 포함된 선을 추가합니다. 새로 만든 Application Insights 리소스의 개요 창에서 연결 문자열을 찾습니다.

   <ConnectionString>Copy connection string from Application Insights Resource Overview</ConnectionString>
   

4. 프로젝트>NuGet 패키지 관리>업데이트를 선택합니다. 그런 다음, 각 Microsoft.ApplicationInsights NuGet 패키지를 안정적인 최신 릴리스로 업데이트합니다.

5. IIS Express를 선택하여 애플리케이션을 실행합니다. 기본 ASP.NET 앱이 열립니다. 사이트의 페이지를 탐색할 때 원격 분석 데이터가 Application Insights로 전송됩니다.

Visual Studio의 ASP.NET 웹앱 프로젝트 내에서:

1. 프로젝트>Application Insights 원격 분석 추가로 이동합니다.

2. Azure Application Insights>다음을 선택합니다.

3. 구독 및 Application Insights 인스턴스를 선택합니다. 또는 새로 만들기를 사용하여 새 인스턴스를 만들 수 있습니다. 다음을 선택합니다.

4. Application Insights 연결 문자열을 추가하거나 확인합니다. 이전 단계에서 선택한 항목에 따라 미리 채워져야 합니다. 완료를 선택합니다.

5. Application Insights가 프로젝트에 추가되면 안정적인 최신 릴리스의 SDK를 사용하고 있는지 확인합니다. 프로젝트>NuGet 패키지 관리>Microsoft.ApplicationInsights.AspNetCore로 차례로 이동합니다. 필요한 경우 업데이트를 선택합니다.

   

1. 다음 NuGet 패키지 및 해당 종속성을 프로젝트에 추가합니다.

   • Microsoft.ApplicationInsights.WindowsServer
   • Microsoft.ApplicationInsights.Web
   • Microsoft.AspNet.TelemetryCorrelation

2. 경우에 따라 ApplicationInsights.config 파일이 자동으로 만들어집니다. 파일이 이미 있는 경우 4단계로 건너뜁니다.

   없으면 직접 만들어라. ASP.NET 애플리케이션의 루트 디렉터리에서 ApplicationInsights.config라는 새 파일을 만듭니다.

3. 다음 XML 구성을 새로 만든 파일에 복사합니다.

   
   
   구성을 보려면 확장

   <?xml version="1.0" encoding="utf-8"?>
   <ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">
     <TelemetryInitializers>
       <Add Type="Microsoft.ApplicationInsights.DependencyCollector.HttpDependenciesParsingTelemetryInitializer, Microsoft.AI.DependencyCollector" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.AzureRoleEnvironmentTelemetryInitializer, Microsoft.AI.WindowsServer" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.BuildInfoConfigComponentVersionTelemetryInitializer, Microsoft.AI.WindowsServer" />
       <Add Type="Microsoft.ApplicationInsights.Web.WebTestTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.SyntheticUserAgentTelemetryInitializer, Microsoft.AI.Web">
         <!-- Extended list of bots:
               search|spider|crawl|Bot|Monitor|BrowserMob|BingPreview|PagePeeker|WebThumb|URL2PNG|ZooShot|GomezA|Google SketchUp|Read Later|KTXN|KHTE|Keynote|Pingdom|AlwaysOn|zao|borg|oegp|silk|Xenu|zeal|NING|htdig|lycos|slurp|teoma|voila|yahoo|Sogou|CiBra|Nutch|Java|JNLP|Daumoa|Genieo|ichiro|larbin|pompos|Scrapy|snappy|speedy|vortex|favicon|indexer|Riddler|scooter|scraper|scrubby|WhatWeb|WinHTTP|voyager|archiver|Icarus6j|mogimogi|Netvibes|altavista|charlotte|findlinks|Retreiver|TLSProber|WordPress|wsr-agent|http client|Python-urllib|AppEngine-Google|semanticdiscovery|facebookexternalhit|web/snippet|Google-HTTP-Java-Client-->
         <Filters>search|spider|crawl|Bot|Monitor|AlwaysOn</Filters>
       </Add>
       <Add Type="Microsoft.ApplicationInsights.Web.ClientIpHeaderTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.AzureAppServiceRoleNameFromHostNameHeaderInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.OperationNameTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.OperationCorrelationTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.UserTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.AuthenticatedUserIdTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.AccountIdTelemetryInitializer, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.SessionTelemetryInitializer, Microsoft.AI.Web" />
     </TelemetryInitializers>
     <TelemetryModules>
       <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector">
         <ExcludeComponentCorrelationHttpHeadersOnDomains>
           <!-- 
           Requests to the following hostnames will not be modified by adding correlation headers.
           Add entries here to exclude additional hostnames.
           NOTE: this configuration will be lost upon NuGet upgrade.
           -->
           <Add>core.windows.net</Add>
           <Add>core.chinacloudapi.cn</Add>
           <Add>core.cloudapi.de</Add>
           <Add>core.usgovcloudapi.net</Add>
         </ExcludeComponentCorrelationHttpHeadersOnDomains>
         <IncludeDiagnosticSourceActivities>
           <Add>Microsoft.Azure.EventHubs</Add>
           <Add>Azure.Messaging.ServiceBus</Add>
         </IncludeDiagnosticSourceActivities>
       </Add>
       <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector">
         <!--
         Use the following syntax here to collect additional performance counters:
   
         <Counters>
           <Add PerformanceCounter="\Process(??APP_WIN32_PROC??)\Handle Count" ReportAs="Process handle count" />
           ...
         </Counters>
   
         PerformanceCounter must be either \CategoryName(InstanceName)\CounterName or \CategoryName\CounterName
   
         NOTE: performance counters configuration will be lost upon NuGet upgrade.
   
         The following placeholders are supported as InstanceName:
           ??APP_WIN32_PROC?? - instance name of the application process for Win32 counters.
           ??APP_W3SVC_PROC?? - instance name of the application IIS worker process for IIS/ASP.NET counters.
           ??APP_CLR_PROC?? - instance name of the application CLR process for .NET counters.
         -->
       </Add>
       <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryModule, Microsoft.AI.PerfCounterCollector" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.AppServicesHeartbeatTelemetryModule, Microsoft.AI.WindowsServer" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.AzureInstanceMetadataTelemetryModule, Microsoft.AI.WindowsServer">
         <!--
         Remove individual fields collected here by adding them to the ApplicationInsighs.HeartbeatProvider
         with the following syntax:
   
         <Add Type="Microsoft.ApplicationInsights.Extensibility.Implementation.Tracing.DiagnosticsTelemetryModule, Microsoft.ApplicationInsights">
           <ExcludedHeartbeatProperties>
             <Add>osType</Add>
             <Add>___location</Add>
             <Add>name</Add>
             <Add>offer</Add>
             <Add>platformFaultDomain</Add>
             <Add>platformUpdateDomain</Add>
             <Add>publisher</Add>
             <Add>sku</Add>
             <Add>version</Add>
             <Add>vmId</Add>
             <Add>vmSize</Add>
             <Add>subscriptionId</Add>
             <Add>resourceGroupName</Add>
             <Add>placementGroupId</Add>
             <Add>tags</Add>
             <Add>vmScaleSetName</Add>
           </ExcludedHeartbeatProperties>
         </Add>
   
         NOTE: exclusions will be lost upon upgrade.
         -->
       </Add>
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.DeveloperModeWithDebuggerAttachedTelemetryModule, Microsoft.AI.WindowsServer" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.UnhandledExceptionTelemetryModule, Microsoft.AI.WindowsServer" />
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.UnobservedExceptionTelemetryModule, Microsoft.AI.WindowsServer">
         <!--</Add>
       <Add Type="Microsoft.ApplicationInsights.WindowsServer.FirstChanceExceptionStatisticsTelemetryModule, Microsoft.AI.WindowsServer">-->
       </Add>
       <Add Type="Microsoft.ApplicationInsights.Web.RequestTrackingTelemetryModule, Microsoft.AI.Web">
         <Handlers>
           <!-- 
           Add entries here to filter out additional handlers:
   
           NOTE: handler configuration will be lost upon NuGet upgrade.
           -->
           <Add>Microsoft.VisualStudio.Web.PageInspector.Runtime.Tracing.RequestDataHttpHandler</Add>
           <Add>System.Web.StaticFileHandler</Add>
           <Add>System.Web.Handlers.AssemblyResourceLoader</Add>
           <Add>System.Web.Optimization.BundleHandler</Add>
           <Add>System.Web.Script.Services.ScriptHandlerFactory</Add>
           <Add>System.Web.Handlers.TraceHandler</Add>
           <Add>System.Web.Services.Discovery.DiscoveryRequestHandler</Add>
           <Add>System.Web.HttpDebugHandler</Add>
         </Handlers>
       </Add>
       <Add Type="Microsoft.ApplicationInsights.Web.ExceptionTrackingTelemetryModule, Microsoft.AI.Web" />
       <Add Type="Microsoft.ApplicationInsights.Web.AspNetDiagnosticTelemetryModule, Microsoft.AI.Web" />
     </TelemetryModules>
     <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights" />
     <TelemetrySinks>
       <Add Name="default">
         <TelemetryProcessors>
           <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse.QuickPulseTelemetryProcessor, Microsoft.AI.PerfCounterCollector" />
           <Add Type="Microsoft.ApplicationInsights.Extensibility.AutocollectedMetricsExtractor, Microsoft.ApplicationInsights" />
           <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
             <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
             <ExcludedTypes>Event</ExcludedTypes>
           </Add>
           <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
             <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
             <IncludedTypes>Event</IncludedTypes>
           </Add>
           <!--
             Adjust the include and exclude examples to specify the desired semicolon-delimited types. (Dependency, Event, Exception, PageView, Request, Trace)
           -->
         </TelemetryProcessors>
         <TelemetryChannel Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.ServerTelemetryChannel, Microsoft.AI.ServerTelemetryChannel" />
       </Add>
     </TelemetrySinks>
     <!-- 
       Learn more about Application Insights configuration with ApplicationInsights.config here:
       http://go.microsoft.com/fwlink/?LinkID=513840
     -->
     <ConnectionString>Copy the connection string from your Application Insights resource</ConnectionString>
   </ApplicationInsights>
   

4. 두 가지 방법으로 수행할 수 있는 연결 문자열 추가합니다.

   • (권장) 구성에서 연결 문자열 설정합니다.

     </ApplicationInsights> 파일의 마지막 태그 앞에 Application Insights 리소스의 연결 문자열을 추가하십시오. 새로 만든 Application Insights 리소스의 개요 창에서 연결 문자열을 찾습니다.

     <ConnectionString>Copy the connection string from your Application Insights resource</ConnectionString>
     

   • 코드에서 연결 문자열 설정합니다.

     program.cs 클래스에 연결 문자열 제공합니다.

     var configuration = new TelemetryConfiguration
     {
         ConnectionString = "Copy the connection string from your Application Insights resource"
     };
     

5. ApplicationInsights.config 파일과 동일한 프로젝트 수준에서 AiHandleErrorAttribute.cs라는 새 C# 파일이 있는 ErrorHandler라는 폴더를 만듭니다. 파일의 콘텐츠는 다음과 같습니다.

   using System;
   using System.Web.Mvc;
   using Microsoft.ApplicationInsights;
   
   namespace WebApplication10.ErrorHandler //namespace will vary based on your project name
   {
       [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = true)] 
       public class AiHandleErrorAttribute : HandleErrorAttribute
       {
           public override void OnException(ExceptionContext filterContext)
           {
               if (filterContext != null && filterContext.HttpContext != null && filterContext.Exception != null)
               {
                   //If customError is Off, then AI HTTPModule will report the exception
                   if (filterContext.HttpContext.IsCustomErrorEnabled)
                   {   
                       var ai = new TelemetryClient();
                       ai.TrackException(filterContext.Exception);
                   } 
               }
               base.OnException(filterContext);
           }
       }
   }
   

6. App_Start 폴더에서 FilterConfig.cs 파일을 열어 샘플과 일치하도록 변경합니다.

   using System.Web;
   using System.Web.Mvc;
   
   namespace WebApplication10 //Namespace will vary based on project name
   {
       public class FilterConfig
       {
           public static void RegisterGlobalFilters(GlobalFilterCollection filters)
           {
               filters.Add(new ErrorHandler.AiHandleErrorAttribute());
           }
       }
   }
   

7. Web.config가 이미 업데이트된 경우 이 단계를 건너뜁니다. 그러지 않으면 파일을 다음과 같이 업데이트합니다.

   
   
   구성을 보려면 확장

   <?xml version="1.0" encoding="utf-8"?>
   <!--
     For more information on how to configure your ASP.NET application, please visit
     https://go.microsoft.com/fwlink/?LinkId=301880
     -->
   <configuration>
     <appSettings>
       <add key="webpages:Version" value="3.0.0.0" />
       <add key="webpages:Enabled" value="false" />
       <add key="ClientValidationEnabled" value="true" />
       <add key="UnobtrusiveJavaScriptEnabled" value="true" />
     </appSettings>
     <system.web>
       <compilation debug="true" targetFramework="4.7.2" />
       <httpRuntime targetFramework="4.7.2" />
       <!-- Code added for Application Insights start -->
       <httpModules>
         <add name="TelemetryCorrelationHttpModule" type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, Microsoft.AspNet.TelemetryCorrelation" />
         <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
       </httpModules>
       <!-- Code added for Application Insights end -->
     </system.web>
     <runtime>
       <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
         <dependentAssembly>
           <assemblyIdentity name="Antlr3.Runtime" publicKeyToken="eb42632606e9261f" />
           <bindingRedirect oldVersion="0.0.0.0-3.5.0.2" newVersion="3.5.0.2" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="Newtonsoft.Json" publicKeyToken="30ad4fe6b2a6aeed" />
           <bindingRedirect oldVersion="0.0.0.0-12.0.0.0" newVersion="12.0.0.0" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="System.Web.Optimization" publicKeyToken="31bf3856ad364e35" />
           <bindingRedirect oldVersion="1.0.0.0-1.1.0.0" newVersion="1.1.0.0" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="WebGrease" publicKeyToken="31bf3856ad364e35" />
           <bindingRedirect oldVersion="0.0.0.0-1.6.5135.21930" newVersion="1.6.5135.21930" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="System.Web.Helpers" publicKeyToken="31bf3856ad364e35" />
           <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="System.Web.WebPages" publicKeyToken="31bf3856ad364e35" />
           <bindingRedirect oldVersion="1.0.0.0-3.0.0.0" newVersion="3.0.0.0" />
         </dependentAssembly>
         <dependentAssembly>
           <assemblyIdentity name="System.Web.Mvc" publicKeyToken="31bf3856ad364e35" />
           <bindingRedirect oldVersion="1.0.0.0-5.2.7.0" newVersion="5.2.7.0" />
         </dependentAssembly>
         <!-- Code added for Application Insights start -->
         <dependentAssembly>
           <assemblyIdentity name="System.Memory" publicKeyToken="cc7b13ffcd2ddd51" culture="neutral" />
           <bindingRedirect oldVersion="0.0.0.0-4.0.1.1" newVersion="4.0.1.1" />
         </dependentAssembly>
         <!-- Code added for Application Insights end -->
       </assemblyBinding>
     </runtime>
     <system.codedom>
       <compilers>
         <compiler language="c#;cs;csharp" extension=".cs" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.CSharpCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=2.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:1659;1699;1701" />
         <compiler language="vb;vbs;visualbasic;vbscript" extension=".vb" type="Microsoft.CodeDom.Providers.DotNetCompilerPlatform.VBCodeProvider, Microsoft.CodeDom.Providers.DotNetCompilerPlatform, Version=2.0.1.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35" warningLevel="4" compilerOptions="/langversion:default /nowarn:41008 /define:_MYTYPE=\&quot;Web\&quot; /optionInfer+" />
       </compilers>
     </system.codedom>
     <system.webServer>
       <validation validateIntegratedModeConfiguration="false" />
       <!-- Code added for Application Insights start -->
       <modules>
         <remove name="TelemetryCorrelationHttpModule" />
         <add name="TelemetryCorrelationHttpModule" type="Microsoft.AspNet.TelemetryCorrelation.TelemetryCorrelationHttpModule, Microsoft.AspNet.TelemetryCorrelation" preCondition="managedHandler" />
         <remove name="ApplicationInsightsWebTracking" />
         <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" preCondition="managedHandler" />
       </modules>
       <!-- Code added for Application Insights end -->
     </system.webServer>
   </configuration>
   

이제 서버 쪽 애플리케이션 모니터링을 성공적으로 구성했습니다. 웹앱을 실행하면 텔레메트리 데이터가 Application Insights에서 수집되기 시작합니다.

1. ASP.NET Core용 Application Insights SDK NuGet 패키지를 설치합니다.

   항상 안정적인 최신 버전을 사용하는 것이 좋습니다. 오픈 소스 GitHub 리포지토리에서 SDK에 대한 전체 릴리스 정보를 확인합니다.

   다음 코드 샘플에서는 프로젝트의 .csproj 파일에 추가할 변경 내용을 보여 줍니다.

   <ItemGroup>
       <PackageReference Include="Microsoft.ApplicationInsights.AspNetCore" Version="2.21.0" />
   </ItemGroup>
   

2. AddApplicationInsightsTelemetry()를 당신의 program.cs 클래스에 추가하세요.

   이 예와 같이 builder.Services.AddApplicationInsightsTelemetry(); 메서드 뒤에 WebApplication.CreateBuilder()를 추가합니다.

   // This method gets called by the runtime. Use this method to add services to the container.
   var builder = WebApplication.CreateBuilder(args);
   
   // The following line enables Application Insights telemetry collection.
   builder.Services.AddApplicationInsightsTelemetry();
   
   // This code adds other services for your application.
   builder.Services.AddMvc();
   
   var app = builder.Build();
   

3. 세 가지 방법으로 수행할 수 있는 연결 문자열 추가합니다.

   • (권장) 구성에서 연결 문자열 설정합니다.

     appsettings.json 연결 문자열 설정하고 게시하는 동안 구성 파일이 애플리케이션 루트 폴더에 복사되었는지 확인합니다.

     {
         "Logging": {
             "LogLevel": {
                 "Default": "Information",
                 "Microsoft.AspNetCore": "Warning"
             }
         },
         "AllowedHosts": "*",
         "ApplicationInsights": {
             "ConnectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000"
         }
     }
     

   • 환경 변수 또는 APPLICATIONINSIGHTS_CONNECTION_STRING JSON 구성 파일에서 ApplicationInsights:ConnectionString 연결 문자열 설정합니다.

     다음은 그 예입니다.

     • SET ApplicationInsights:ConnectionString = <Copy connection string from Application Insights Resource Overview>
     • SET APPLICATIONINSIGHTS_CONNECTION_STRING = <Copy connection string from Application Insights Resource Overview>
     • 일반적으로 APPLICATIONINSIGHTS_CONNECTION_STRING은 Web Apps에서 사용됩니다. 또한 이 SDK가 지원되는 모든 곳에서 사용할 수 있습니다.

     비고

     코드에 지정된 연결 문자열은 다른 옵션보다 우선 적용되는 APPLICATIONINSIGHTS_CONNECTION_STRING 환경 변수보다 우선 적용됩니다.

   • 코드에서 연결 문자열 설정합니다.

     ApplicationInsightsServiceOptions 클래스에서 AddApplicationInsightsTelemetry에 대한 인수의 일부로 연결 문자열을 제공합니다.

사용자 비밀 및 기타 구성 공급자

연결 문자열을 ASP.NET Core 사용자 비밀에 저장하거나 다른 구성 공급자에서 검색하려면 Microsoft.Extensions.Configuration.IConfiguration 매개 변수를 사용하여 오버로드를 사용하면 됩니다. 예 매개 변수는 services.AddApplicationInsightsTelemetry(Configuration);입니다.

Microsoft.ApplicationInsights.AspNetCore 버전 2.15.0 이상에서 services.AddApplicationInsightsTelemetry()를 호출하면 애플리케이션의 Microsoft.Extensions.Configuration.IConfiguration에서 자동으로 연결 문자열을 읽습니다. IConfiguration을 명시적으로 제공할 필요는 없습니다.

IConfiguration이(가) 여러 공급자에서 구성을 로드한 경우 공급자가 추가되는 순서에 관계없이 services.AddApplicationInsightsTelemetry이(가)appsettings.json 구성의 우선 순위를 지정합니다. services.AddApplicationInsightsTelemetry(IConfiguration)에 대한 우선 처리 없이 IConfiguration에서 구성을 읽으려면 메서드를 사용합니다.

이 부분에서는

• Worker Service용 Application Insights SDK 사용
• .NET Core 작업자 서비스 애플리케이션
• 호스팅된 서비스를 사용한 ASP.NET Core 백그라운드 작업
• .NET Core/.NET Framework 콘솔 애플리케이션

Worker Service용 Application Insights SDK 사용

1. 애플리케이션에 Microsoft.ApplicationInsights.WorkerService 패키지를 설치합니다.

   다음 코드 조각은 프로젝트 .csproj 파일에 추가해야 하는 변경 내용을 보여 줍니다.

       <ItemGroup>
           <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
       </ItemGroup>
   

2. 환경 변수 또는 구성(APPLICATIONINSIGHTS_CONNECTION_STRING)에서 appsettings.json 연결 문자열을 구성합니다.

   

3. ILogger 또는 생성자 주입을 사용하여 DI(종속성 주입) 컨테이너에서 TelemetryClient 인스턴스 또는 serviceProvider.GetRequiredService<TelemetryClient>(); 인스턴스를 검색합니다. 이 단계에서는 TelemetryConfiguration 및 자동 수집 모듈의 설정을 트리거합니다.

각 애플리케이션 유형에 대한 구체적인 지침은 다음 섹션에서 설명합니다.

.NET Core 작업자 서비스 애플리케이션

전체 예제는 NuGet 웹 사이트에서 공유됩니다.

1. .NET SDK를 다운로드하고 설치합니다.

2. Visual Studio 새 프로젝트 템플릿 또는 명령줄 dotnet new worker을 사용하여 새 작업자 서비스 프로젝트를 만듭니다.

3. Microsoft.ApplicationInsights.WorkerService 패키지를 애플리케이션에 추가합니다.

4. services.AddApplicationInsightsTelemetryWorkerService(); 클래스의 CreateHostBuilder() 메서드에 Program.cs를 추가합니다. 다음 예제를 참고하세요.

       public static IHostBuilder CreateHostBuilder(string[] args) =>
           Host.CreateDefaultBuilder(args)
               .ConfigureServices((hostContext, services) =>
               {
                   services.AddHostedService<Worker>();
                   services.AddApplicationInsightsTelemetryWorkerService();
               });
   

5. 다음 예제에 따라 귀하의 Worker.cs를 수정하십시오.

       using Microsoft.ApplicationInsights;
       using Microsoft.ApplicationInsights.DataContracts;
   
       public class Worker : BackgroundService
       {
           private readonly ILogger<Worker> _logger;
           private TelemetryClient _telemetryClient;
           private static HttpClient _httpClient = new HttpClient();
   
           public Worker(ILogger<Worker> logger, TelemetryClient tc)
           {
               _logger = logger;
               _telemetryClient = tc;
           }
   
           protected override async Task ExecuteAsync(CancellationToken stoppingToken)
           {
               while (!stoppingToken.IsCancellationRequested)
               {
                   _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);
   
                   using (_telemetryClient.StartOperation<RequestTelemetry>("operation"))
                   {
                       _logger.LogWarning("A sample warning message. By default, logs with severity Warning or higher is captured by Application Insights");
                       _logger.LogInformation("Calling bing.com");
                       var res = await _httpClient.GetAsync("https://bing.com");
                       _logger.LogInformation("Calling bing completed with status:" + res.StatusCode);
                       _telemetryClient.TrackEvent("Bing call event completed");
                   }
   
                   await Task.Delay(1000, stoppingToken);
               }
           }
       }
   

6. 연결 문자열을 설정합니다.

   

   비고

   구성에서 연결 문자열을 지정하는 것이 좋습니다. 다음 코드 샘플에서는 .에서 appsettings.json연결 문자열을 지정하는 방법을 보여줍니다. 게시하는 동안 appsettings.json이 애플리케이션 루트 폴더에 복사되었는지 확인합니다.

       {
           "ApplicationInsights":
           {
               "ConnectionString" : "InstrumentationKey=00000000-0000-0000-0000-000000000000;"
           },
           "Logging":
           {
               "LogLevel":
               {
                   "Default": "Warning"
               }
           }
       }
   

또는 환경 변수에 연결 문자열을 APPLICATIONINSIGHTS_CONNECTION_STRING 지정합니다.

일반적으로 APPLICATIONINSIGHTS_CONNECTION_STRING 웹앱에 배포된 애플리케이션에 대한 연결 문자열을 웹 작업으로 지정합니다.

호스팅된 서비스를 사용한 ASP.NET 코어 백그라운드 작업

이 문서에서 는 ASP.NET Core 애플리케이션에서 백그라운드 작업을 만드는 방법을 설명합니다.

전체 예제는 이 GitHub 페이지에서 공유됩니다.

1. 애플리케이션에 Microsoft.ApplicationInsights.WorkerService 패키지를 설치합니다.

2. 예를 들어 services.AddApplicationInsightsTelemetryWorkerService(); 메서드에 ConfigureServices()를 추가하십시오.

       public static async Task Main(string[] args)
       {
           var host = new HostBuilder()
               .ConfigureAppConfiguration((hostContext, config) =>
               {
                   config.AddJsonFile("appsettings.json", optional: true);
               })
               .ConfigureServices((hostContext, services) =>
               {
                   services.AddLogging();
                   services.AddHostedService<TimedHostedService>();
   
                   // connection string is read automatically from appsettings.json
                   services.AddApplicationInsightsTelemetryWorkerService();
               })
               .UseConsoleLifetime()
               .Build();
   
           using (host)
           {
               // Start the host
               await host.StartAsync();
   
               // Wait for the host to shutdown
               await host.WaitForShutdownAsync();
           }
       }
   

   다음 코드는 백그라운드 작업 논리가 있는 위치에 대한 TimedHostedService것입니다.

       using Microsoft.ApplicationInsights;
       using Microsoft.ApplicationInsights.DataContracts;
   
       public class TimedHostedService : IHostedService, IDisposable
       {
           private readonly ILogger _logger;
           private Timer _timer;
           private TelemetryClient _telemetryClient;
           private static HttpClient httpClient = new HttpClient();
   
           public TimedHostedService(ILogger<TimedHostedService> logger, TelemetryClient tc)
           {
               _logger = logger;
               this._telemetryClient = tc;
           }
   
           public Task StartAsync(CancellationToken cancellationToken)
           {
               _logger.LogInformation("Timed Background Service is starting.");
   
               _timer = new Timer(DoWork, null, TimeSpan.Zero,
                   TimeSpan.FromSeconds(1));
   
               return Task.CompletedTask;
           }
   
           private void DoWork(object state)
           {
               _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);
   
               using (_telemetryClient.StartOperation<RequestTelemetry>("operation"))
               {
                   _logger.LogWarning("A sample warning message. By default, logs with severity Warning or higher is captured by Application Insights");
                   _logger.LogInformation("Calling bing.com");
                   var res = httpClient.GetAsync("https://bing.com").GetAwaiter().GetResult();
                   _logger.LogInformation("Calling bing completed with status:" + res.StatusCode);
                   _telemetryClient.TrackEvent("Bing call event completed");
               }
           }
       }
   

3. 연결 문자열을 설정합니다. 앞의 appsettings.json 작업자 서비스 예제와 동일하게 사용합니다.

.NET Core/.NET Framework 콘솔 애플리케이션

이 문서의 시작 부분에서 설명한 것처럼 새 패키지를 사용하여 일반 콘솔 애플리케이션에서도 Application Insights 원격 분석을 사용하도록 설정할 수 있습니다. 이 패키지는 netstandard2.0를 대상으로 하므로 .NET Core 이상 및 .NET Framework 이상의 콘솔 앱에서 사용할 수 있습니다.

전체 예제는 이 GitHub 페이지에서 공유됩니다.

1. 애플리케이션에 Microsoft.ApplicationInsights.WorkerService 패키지를 설치합니다.

2. 다음 예제와 같이 Program.cs 수정합니다.

       using Microsoft.ApplicationInsights;
       using Microsoft.ApplicationInsights.DataContracts;
       using Microsoft.ApplicationInsights.WorkerService;
       using Microsoft.Extensions.DependencyInjection;
       using Microsoft.Extensions.Logging;
       using System;
       using System.Net.Http;
       using System.Threading.Tasks;
   
       namespace WorkerSDKOnConsole
       {
           class Program
           {
               static async Task Main(string[] args)
               {
                   // Create the DI container.
                   IServiceCollection services = new ServiceCollection();
   
                   // Being a regular console app, there is no appsettings.json or configuration providers enabled by default.
                   // Hence instrumentation key/ connection string and any changes to default logging level must be specified here.
                   services.AddLogging(loggingBuilder => loggingBuilder.AddFilter<Microsoft.Extensions.Logging.ApplicationInsights.ApplicationInsightsLoggerProvider>("Category", LogLevel.Information));
                   services.AddApplicationInsightsTelemetryWorkerService((ApplicationInsightsServiceOptions options) => options.ConnectionString = "InstrumentationKey=<instrumentation key here>");
   
                   // To pass a connection string
                   // - aiserviceoptions must be created
                   // - set connectionstring on it
                   // - pass it to AddApplicationInsightsTelemetryWorkerService()
   
                   // Build ServiceProvider.
                   IServiceProvider serviceProvider = services.BuildServiceProvider();
   
                   // Obtain logger instance from DI.
                   ILogger<Program> logger = serviceProvider.GetRequiredService<ILogger<Program>>();
   
                   // Obtain TelemetryClient instance from DI, for additional manual tracking or to flush.
                   var telemetryClient = serviceProvider.GetRequiredService<TelemetryClient>();
   
                   var httpClient = new HttpClient();
   
                   while (true) // This app runs indefinitely. Replace with actual application termination logic.
                   {
                       logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);
   
                       // Replace with a name which makes sense for this operation.
                       using (telemetryClient.StartOperation<RequestTelemetry>("operation"))
                       {
                           logger.LogWarning("A sample warning message. By default, logs with severity Warning or higher is captured by Application Insights");
                           logger.LogInformation("Calling bing.com");                    
                           var res = await httpClient.GetAsync("https://bing.com");
                           logger.LogInformation("Calling bing completed with status:" + res.StatusCode);
                           telemetryClient.TrackEvent("Bing call event completed");
                       }
   
                       await Task.Delay(1000);
                   }
   
                   // Explicitly call Flush() followed by sleep is required in console apps.
                   // This is to ensure that even if application terminates, telemetry is sent to the back-end.
                   telemetryClient.Flush();
                   Task.Delay(5000).Wait();
               }
           }
       }
   

이 콘솔 애플리케이션도 동일한 기본값 TelemetryConfiguration을 사용합니다. 이전 섹션의 예제와 동일한 방식으로 사용자 지정할 수 있습니다.

애플리케이션을 실행하고 이에 대한 요청을 수행합니다. 이제 원격 분석이 Application Insights로 이동합니다. Application Insights SDK는 다음 원격 분석과 함께 애플리케이션에 대한 들어오는 웹 요청을 자동으로 수집합니다.

애플리케이션을 실행하고 이에 대한 요청을 수행합니다. 이제 원격 분석이 Application Insights로 이동합니다. Application Insights SDK는 다음 원격 분석과 함께 애플리케이션에 대한 들어오는 웹 요청을 자동으로 수집합니다.

애플리케이션을 실행합니다. 앞의 모든 예제의 작업자는 매초 HTTP 호출을 통해 bing.com에 연결하고, ILogger를 사용하여 몇 개의 로그를 내보냅니다. 이러한 줄은 작업을 생성하는 데 사용되는 StartOperation 호출 내부에 TelemetryClient 래핑되어 있습니다. 이 예제 RequestTelemetry 에서는 이름이 "operation"입니다.

Application Insights는 기본적으로 경고 이상의 심각도를 가진 ILogger 로그 및 종속성을 수집합니다. RequestTelemetry는 부모-자식 관계로 상관되어 있습니다. 상관 관계는 프로세스/네트워크 경계 간에도 작동합니다. 예를 들어 모니터링되는 다른 구성 요소에 대한 호출이 수행된 경우 이 부모와도 상관 관계가 있습니다.

이 사용자 지정 작업은 RequestTelemetry 일반적인 웹 애플리케이션에서 들어오는 웹 요청과 동일하다고 생각할 수 있습니다. 작업을 사용할 필요는 없지만 Application Insights 상관 관계 데이터 모델에 가장 적합합니다. RequestTelemetry 는 부모 작업으로 작동하며 작업자 반복 내에서 생성된 모든 원격 분석은 동일한 작업에 논리적으로 속하는 것으로 처리됩니다.

이 방법은 자동 및 수동으로 생성된 모든 원격 분석이 동일한 operation_id를 갖도록 보장합니다. 샘플링이 operation_id을 기반으로 하기 때문에 샘플링 알고리즘은 모든 원격 분석 데이터를 동일한 반복에서 유지하거나 제거합니다.

수동으로 라이브 메트릭을 구성하려면 다음을 수행합니다.

1. NuGet 패키지 Microsoft.ApplicationInsights.PerfCounterCollector를 설치합니다.

2. 다음 샘플 콘솔 앱 코드는 라이브 메트릭을 설정하는 방법을 보여 줍니다.

using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;
using System;
using System.Threading.Tasks;

namespace LiveMetricsDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Create a TelemetryConfiguration instance.
            TelemetryConfiguration config = TelemetryConfiguration.CreateDefault();
            config.InstrumentationKey = "INSTRUMENTATION-KEY-HERE";
            QuickPulseTelemetryProcessor quickPulseProcessor = null;
            config.DefaultTelemetrySink.TelemetryProcessorChainBuilder
                .Use((next) =>
                {
                    quickPulseProcessor = new QuickPulseTelemetryProcessor(next);
                    return quickPulseProcessor;
                })
                .Build();

            var quickPulseModule = new QuickPulseTelemetryModule();

            // Secure the control channel.
            // This is optional, but recommended.
            quickPulseModule.AuthenticationApiKey = "YOUR-API-KEY-HERE";
            quickPulseModule.Initialize(config);
            quickPulseModule.RegisterTelemetryProcessor(quickPulseProcessor);

            // Create a TelemetryClient instance. It is important
            // to use the same TelemetryConfiguration here as the one
            // used to set up live metrics.
            TelemetryClient client = new TelemetryClient(config);

            // This sample runs indefinitely. Replace with actual application logic.
            while (true)
            {
                // Send dependency and request telemetry.
                // These will be shown in live metrics.
                // CPU/Memory Performance counter is also shown
                // automatically without any additional steps.
                client.TrackDependency("My dependency", "target", "http://sample",
                    DateTimeOffset.Now, TimeSpan.FromMilliseconds(300), true);
                client.TrackRequest("My Request", DateTimeOffset.Now,
                    TimeSpan.FromMilliseconds(230), "200", true);
                Task.Delay(1000).Wait();
            }
        }
    }
}

수동으로 라이브 메트릭을 구성하려면 다음을 수행합니다.

1. NuGet 패키지 Microsoft.ApplicationInsights.PerfCounterCollector를 설치합니다.

2. 다음 샘플 콘솔 앱 코드는 라이브 메트릭을 설정하는 방법을 보여 줍니다.

using Microsoft.ApplicationInsights;
using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;

// Create a TelemetryConfiguration instance.
TelemetryConfiguration config = TelemetryConfiguration.CreateDefault();
config.ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000";
QuickPulseTelemetryProcessor quickPulseProcessor = null;
config.DefaultTelemetrySink.TelemetryProcessorChainBuilder
    .Use((next) =>
    {
        quickPulseProcessor = new QuickPulseTelemetryProcessor(next);
        return quickPulseProcessor;
    })
    .Build();

var quickPulseModule = new QuickPulseTelemetryModule();

// Secure the control channel.
// This is optional, but recommended.
quickPulseModule.AuthenticationApiKey = "YOUR-API-KEY-HERE";
quickPulseModule.Initialize(config);
quickPulseModule.RegisterTelemetryProcessor(quickPulseProcessor);

// Create a TelemetryClient instance. It is important
// to use the same TelemetryConfiguration here as the one
// used to set up live metrics.
TelemetryClient client = new TelemetryClient(config);

// This sample runs indefinitely. Replace with actual application logic.
while (true)
{
    // Send dependency and request telemetry.
    // These will be shown in live metrics.
    // CPU/Memory Performance counter is also shown
    // automatically without any additional steps.
    client.TrackDependency("My dependency", "target", "http://sample",
        DateTimeOffset.Now, TimeSpan.FromMilliseconds(300), true);
    client.TrackRequest("My Request", DateTimeOffset.Now,
        TimeSpan.FromMilliseconds(230), "200", true);
    Task.Delay(1000).Wait();
}

위의 샘플은 콘솔 앱에 대한 것이지만 모든 .NET 애플리케이션에서 동일한 코드를 사용할 수 있습니다.

경고 이상의 심각도를 가진 ILogger 로그는 자동으로 캡처됩니다. 이 동작을 변경하려면 다음 코드와 같이 공급자 ApplicationInsights에 대한 로깅 구성을 명시적으로 재정의합니다. 다음 구성을 통해 Application Insights는 모든 Information 로그와 더 심각한 로그를 캡처할 수 있습니다.

{
  "Logging": {
    "LogLevel": {
      "Default": "Warning"
    },
    "ApplicationInsights": {
      "LogLevel": {
        "Default": "Information"
      }
    }
  }
}

중요한 점은 다음 예제가 Information 로그를 Application Insights 공급자가 캡처하지 않게 한다는 것입니다. 캡처하지 않는 이유는 SDK가 ApplicationInsights에 Warning 로그 및 더 심각한 로그만 캡처하도록 지시하는 기본 로깅 필터를 추가하기 때문입니다. Application Insights에는 명시적 재정의가 필요합니다.

{
  "Logging": {
    "LogLevel": {
      "Default": "Information"
    }
  }
}

자세한 내용은 ILogger 문서에 따라 Application Insights 에서 캡처되는 로그 수준을 사용자 지정합니다.

Application Insights에서 수집할 수 있는 진단 로그를 내보내는 로깅 방법을 선택합니다.

앱에 로깅 설치

System.Diagnostics 추적을 사용하는 클래식 ASP.NET 앱의 경우 구성에서 Application Insights TraceListener를 구성합니다.

web.config 또는 app.config에 수신기를 추가하십시오.

<configuration>
  <system.diagnostics>
    <trace>
      <listeners>
        <add name="myAppInsightsListener"
             type="Microsoft.ApplicationInsights.TraceListener.ApplicationInsightsTraceListener, Microsoft.ApplicationInsights.TraceListener" />
      </listeners>
    </trace>
  </system.diagnostics>
</configuration>

로그를 수집하도록 Application Insights 구성

옵션 1: 아직 수행하지 않은 경우 프로젝트에 Application Insights를 추가합니다. Visual Studio에서 Application Insights를 추가할 때 로그 수집기를 포함하는 옵션이 있습니다.

옵션 2: 솔루션 탐색기에서 프로젝트를 마우스 오른쪽 단추로 클릭하여 Application Insights를 구성합니다. 추적 컬렉션 구성 옵션을 선택합니다.

ASP.NET Core용 Application Insights SDK는 기본적으로 ILogger 로그를 이미 수집합니다. SDK를 사용하는 경우 일반적으로 builder.Logging.AddApplicationInsights()를 호출할 필요가 없으며, 이 경우 다음 ILogger 설치 지침을 무시해도 됩니다.

전체 원격 분석 스택이 아닌 로그 전달만 필요한 경우 Microsoft.Extensions.Logging.ApplicationInsights 공급자 패키지를 사용하여 로그를 캡처할 수 있습니다.

ASP.NET 애플리케이션의 경우, 계측 엔진을 사용하거나 System.Data.SqlClient 라이브러리 대신 Microsoft.Data.SqlClient NuGet 패키지를 사용해야 하는 바이트 코드 계측을 통해 전체 SQL 쿼리 텍스트가 수집됩니다. 전체 SQL 쿼리 컬렉션을 사용하도록 설정하는 플랫폼별 단계는 다음 표에 설명되어 있습니다.

앞의 플랫폼별 단계 외에도 다음 코드로 파일을 수정하여 ApplicationInsights.config.

<TelemetryModules>
  <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector">
    <EnableSqlCommandTextInstrumentation>true</EnableSqlCommandTextInstrumentation>
  </Add>

ASP.NET Core 애플리케이션의 경우 다음을 사용하여 SQL Text 컬렉션을 옵트인해야 합니다.

services.ConfigureTelemetryModule<DependencyTrackingTelemetryModule>((module, o) => { module. EnableSqlCommandTextInstrumentation = true; });

서버 쪽 애플리케이션에서 예외를 보고하려면 다음 시나리오를 고려하세요.

• Azure 웹앱용 Application Insights 확장을 추가합니다.
• Azure VM 및 Azure 가상 머신 확장 집합 IIS 호스팅 앱에 대한 애플리케이션 모니터링 확장을 추가합니다.
• 앱 코드에 Application Insights SDK를 추가하거나, IIS 웹 서버용 Application Insights 에이전트를 실행하거나, Java 웹앱에 Java 에이전트를 사용하도록 설정합니다.

JavaScript SDK는 웹 브라우저에서 발생하는 예외를 클라이언트 쪽에서 보고하는 기능을 제공합니다. 클라이언트에서 예외 보고를 설정하려면 웹 페이지에 대한 Application Insights를 참조하세요.

일부 애플리케이션 프레임워크에서는 더 많은 구성이 필요합니다. 다음과 같은 기술을 고려해 보세요.

• 웹 양식
• MVC
• Web API 1.*
• Web API 2.*
• WCF

Application Insights는 애플리케이션 성능 관리 환경과 함께 큐레이팅되어 모니터링된 애플리케이션에서 실패를 진단하는 데 유용합니다.

자세한 지침은 Application Insights를 사용하여 오류, 성능 및 트랜잭션 조사를 참조하세요.

1. Visual Studio에서 앱 솔루션을 엽니다. 서버 또는 개발 컴퓨터에서 F5를 사용하여 앱을 실행합니다. 예외를 다시 만듭니다.

2. Visual Studio의 Application Insights 검색 원격 분석 창을 엽니다. 디버깅하는 동안 Application Insights 드롭다운 상자를 선택합니다.

3. 예외 보고서를 클릭하여 해당 스택 추적을 표시합니다. 스택 추적에서 라인 참조를 클릭하여 관련 코드 파일을 엽니다.

   CodeLens를 사용하도록 설정하면 예외에 대한 데이터가 표시됩니다.

   

var telemetry = new TelemetryClient();

try
{
    // ...
}
catch (Exception ex)
{
    var properties = new Dictionary<string, string>
    {
        ["Game"] = currentGame.Name
    };

    var measurements = new Dictionary<string, double>
    {
        ["Users"] = currentGame.Users.Count
    };

    // Send the exception telemetry:
    telemetry.TrackException(ex, properties, measurements);
}

try
{
    // ...
}
catch (ex)
{
    appInsights.trackException(ex, "handler loc",
    {
        Game: currentGame.Name,
        State: currentGame.State.ToString()
    });
}

Storage 큐는 HTTP API를 지원하므로 큐를 통한 모든 작업은 Application Insights에서 자동으로 추적됩니다. 대부분의 경우 이 계측으로 충분합니다. 생산자 추적과 소비자 쪽 추적 사이의 상관 관계를 지정하려면 상관 관계에 대한 HTTP 프로토콜에서 수행하는 것과 비슷한 일부 상관 관계 컨텍스트를 전달해야 합니다.

이 예제는 Enqueue 작업을 추적하는 방법을 보여 줍니다. 당신은 할 수 있어요:

• 상관 관계 지정 재시도(있는 경우): 모든 작업에는 Enqueue 작업인 하나의 공통 부모가 있습니다. 그렇지 않으면 들어오는 요청의 자식으로 추적됩니다. 큐에 대한 논리적 요청이 여러 개 있으면 재시도가 발생한 호출을 찾는 것이 어려울 수 있습니다.
• 스토리지 상관 관계 지정 로그(필요한 경우): Application Insights 원격 분석과의 상관 관계가 지정됩니다.

Enqueue 작업은 부모 작업의 자식입니다. 예로는 들어오는 HTTP 요청이 있습니다. HTTP 종속성 호출은 Enqueue 작업의 자식 및 들어오는 요청의 손자입니다.

public async Task Enqueue(CloudQueue queue, string message)
{
    var operation = telemetryClient.StartOperation<DependencyTelemetry>("enqueue " + queue.Name);
    operation.Telemetry.Type = "Azure queue";
    operation.Telemetry.Data = "Enqueue " + queue.Name;

    // MessagePayload represents your custom message and also serializes correlation identifiers into payload.
    // For example, if you choose to pass payload serialized to JSON, it might look like
    // {'RootId' : 'some-id', 'ParentId' : '|some-id.1.2.3.', 'message' : 'your message to process'}
    var jsonPayload = JsonConvert.SerializeObject(new MessagePayload
    {
        RootId = operation.Telemetry.Context.Operation.Id,
        ParentId = operation.Telemetry.Id,
        Payload = message
    });
    
    CloudQueueMessage queueMessage = new CloudQueueMessage(jsonPayload);

    // Add operation.Telemetry.Id to the OperationContext to correlate Storage logs and Application Insights telemetry.
    OperationContext context = new OperationContext { ClientRequestID = operation.Telemetry.Id};

    try
    {
        await queue.AddMessageAsync(queueMessage, null, null, new QueueRequestOptions(), context);
    }
    catch (StorageException e)
    {
        operation.Telemetry.Properties.Add("AzureServiceRequestID", e.RequestInformation.ServiceRequestID);
        operation.Telemetry.Success = false;
        operation.Telemetry.ResultCode = e.RequestInformation.HttpStatusCode.ToString();
        telemetryClient.TrackException(e);
    }
    finally
    {
        // Update status code and success as appropriate.
        telemetryClient.StopOperation(operation);
    }
}  

애플리케이션 보고서에서 원격 분석의 양을 줄이거나 다른 이유로 Enqueue 작업을 추적하지 않으려면 Activity API를 직접 사용합니다.

• Application Insights 작업을 시작하는 대신 새 Activity를 만듭니다(및 시작합니다). 작업 이름을 제외한 속성은 할당할 필요가 없습니다 .
• yourActivity.Id 대신 메시지 페이로드에 operation.Telemetry.Id를 직렬화합니다. 또한 Activity.Current.Id을 사용할 수 있습니다.

Enqueue와 비슷하게 Storage 큐에 대한 실제 HTTP 요청은 Application Insights에서 자동으로 추적됩니다. Enqueue 작업은 아마도 들어오는 요청 컨텍스트와 같은 부모 컨텍스트에서 발생합니다. Application Insights SDK는 이러한 작업(및 해당하는 HTTP 부분)과 부모 요청 및 동일한 범위에서 보고되는 다른 원격 분석 사이의 상관 관계를 자동으로 지정합니다.

Dequeue 작업은 까다롭습니다. Application Insights SDK에서 HTTP 요청을 자동으로 추적합니다. 그러나 메시지가 구문 분석될 때까지 상관 관계 컨텍스트를 인식할 수 없습니다. 특히 두 개 이상의 메시지를 수신하는 경우에는 메시지를 가져오는 HTTP 요청과 원격 분석의 나머지 부분 간 상관 관계를 지정할 수 없습니다.

public async Task<MessagePayload> Dequeue(CloudQueue queue)
{
    var operation = telemetryClient.StartOperation<DependencyTelemetry>("dequeue " + queue.Name);
    operation.Telemetry.Type = "Azure queue";
    operation.Telemetry.Data = "Dequeue " + queue.Name;

    try
    {
        var message = await queue.GetMessageAsync();
    }
    catch (StorageException e)
    {
        operation.telemetry.Properties.Add("AzureServiceRequestID", e.RequestInformation.ServiceRequestID);
        operation.telemetry.Success = false;
        operation.telemetry.ResultCode = e.RequestInformation.HttpStatusCode.ToString();
        telemetryClient.TrackException(e);
    }
    finally
    {
        // Update status code and success as appropriate.
        telemetryClient.StopOperation(operation);
    }

    return null;
}

다음 예제에서 들어오는 메시지는 들어오는 HTTP 요청과 비슷한 방식으로 추적됩니다.

public async Task Process(MessagePayload message)
{
    // After the message is dequeued from the queue, create RequestTelemetry to track its processing.
    RequestTelemetry requestTelemetry = new RequestTelemetry { Name = "process " + queueName };
    
    // It might also make sense to get the name from the message.
    requestTelemetry.Context.Operation.Id = message.RootId;
    requestTelemetry.Context.Operation.ParentId = message.ParentId;

    var operation = telemetryClient.StartOperation(requestTelemetry);

    try
    {
        await ProcessMessage();
    }
    catch (Exception e)
    {
        telemetryClient.TrackException(e);
        throw;
    }
    finally
    {
        // Update status code and success as appropriate.
        telemetryClient.StopOperation(operation);
    }
}

ASP.NET 웹 애플리케이션의 기본 카운터:

• % 프로세스\프로세서 시간 (Processor Time)
• % 프로세스\프로세서 시간 정규화됨
• 메모리\사용 가능한 바이트
• ASP.NET Requests/Sec
• .NET CLR(공용 언어 런타임) 예외 발생 횟수/초
• ASP.NET 애플리케이션 요청 실행 시간
• 프로세스\개인 바이트 (Process\Private Bytes)
• 프로세스\입출력 데이터 바이트/초
• ASP.NET 애플리케이션\애플리케이션 대기열의 요청
• 프로세서(_Total)\% 프로세서 시간

ASP.NET Core 웹 애플리케이션의 기본 카운터:

• % 프로세스\프로세서 시간 (Processor Time)
• % 프로세스\프로세서 시간 정규화됨
• 메모리\사용 가능한 바이트
• 프로세스\개인 바이트 (Process\Private Bytes)
• 프로세스\입출력 데이터 바이트/초
• 프로세서(_Total)\% 프로세서 시간

옵션 1: ApplicationInsights.config 구성

1. 로컬 서버에서 다음 PowerShell 명령을 사용하여 서버에서 사용할 수 있는 카운터를 확인합니다.

   Get-Counter -ListSet *
   

   자세한 내용은 Get-Counter를 참조하세요.

2. ApplicationInsights.config을(를) 여십시오.

   배포 중에 앱에 Application Insights를 추가한 경우:

   1. 프로젝트에서 ApplicationInsights.config를 편집합니다.
   2. 서버에 다시 배포합니다.

3. 다음과 같이 성능 수집기 지시문을 편집합니다.

   
       <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector">
         <Counters>
           <Add PerformanceCounter="\Objects\Processes"/>
           <Add PerformanceCounter="\Sales(photo)\# Items Sold" ReportAs="Photo sales"/>
         </Counters>
       </Add>
   

표준 카운터와 직접 구현한 카운터를 모두 캡처합니다. \Objects\Processes는 모든 Windows 시스템에서 사용할 수 있는 표준 카운터의 한 예입니다. \Sales(photo)\# Items Sold는 웹 서비스에서 구현할 수 있는 사용자 지정 카운터의 한 예입니다.

형식은 \Category(instance)\Counter이며, 인스턴스가 없는 범주인 경우에는 \Category\Counter입니다.

ReportAs 매개 변수는 [a-zA-Z()/-_ \.]+와 일치하지 않는 카운터 이름에 필요합니다.

인스턴스를 지정하면 보고된 메트릭의 차원 CounterInstanceName이 됩니다.

옵션 2: 코드의 구성

다음 섹션을 참조하세요.

PerformanceCollectorModule의 WebApplication.CreateBuilder() 메서드 다음에 Program.cs을 구성합니다.

using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// The following configures PerformanceCollectorModule.

builder.Services.ConfigureTelemetryModule<PerformanceCollectorModule>((module, o) =>
    {
        // The application process name could be "dotnet" for ASP.NET Core self-hosted applications.
        module.Counters.Add(new PerformanceCounterCollectionRequest(@"\Process([replace-with-application-process-name])\Page Faults/sec", "DotnetPageFaultsPerfSec"));
    });

var app = builder.Build();

옵션 1: 코드의 구성

protected void Application_Start()
{
    // ...
    TelemetryConfiguration.Active.TelemetryInitializers.Add(new MyTelemetryInitializer());
}

옵션 2: ApplicationInsights.config 구성

<ApplicationInsights>
    <TelemetryInitializers>
    <!-- Fully qualified type name, assembly name: -->
    <Add Type="MvcWebRole.Telemetry.MyTelemetryInitializer, MvcWebRole"/>
    ...
    </TelemetryInitializers>
</ApplicationInsights>

이 샘플에 대해 자세히 알아보세요.

ApplicationInsights.config 문제 해결

• 정규화된 형식 이름 및 어셈블리 이름이 올바른지 확인합니다.
• applicationinsights.config 파일이 출력 디렉터리에 있으며 최근 변경 내용이 포함되어 있는지 확인합니다.

ASP.NET Core 애플리케이션에서 ApplicationInsights.config 또는 TelemetryConfiguration.Active를 사용하여 이니셜라이저를 추가하는 것은 유효하지 않습니다.

ASP.NET Core를 사용하여 작성된 앱의 경우 표시된 것처럼 새 원격 분석 이니셜라이저를 컨테이너에 DependencyInjection 추가하여 추가합니다. 메서드에서 이 단계를 수행합니다 Startup.ConfigureServices .

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddSingleton<ITelemetryInitializer, MyCustomTelemetryInitializer>();

var app = builder.Build();

원격 분석 이니셜라이저 제거

원격 분석 이니셜라이저는 기본적으로 제공됩니다. 모든 또는 특정 원격 분석 이니셜라이저를 제거하려면 를 호출한 AddApplicationInsightsTelemetry()에 다음 샘플 코드를 사용합니다.

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// Remove a specific built-in telemetry initializer
var tiToRemove = builder.Services.FirstOrDefault<ServiceDescriptor>
                    (t => t.ImplementationType == typeof(AspNetCoreEnvironmentTelemetryInitializer));
if (tiToRemove != null)
{
    builder.Services.Remove(tiToRemove);
}

// Remove all initializers
// This requires importing namespace by using Microsoft.Extensions.DependencyInjection.Extensions;
builder.Services.RemoveAll(typeof(ITelemetryInitializer));

var app = builder.Build();

작업자 서비스 SDK에서는 ApplicationInsights.config 또는 TelemetryConfiguration.Active를 사용하여 이니셜라이저를 추가하는 것이 유효하지 않습니다.

작업자 서비스를 사용하여 작성된 앱의 경우 표시된 것처럼 새 원격 분석 이니셜라이저를 DependencyInjection 컨테이너에 추가하여 추가합니다. 메서드에서 이 단계를 수행합니다 Startup.ConfigureServices .

    using Microsoft.ApplicationInsights.Extensibility;

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddSingleton<ITelemetryInitializer, MyCustomTelemetryInitializer>();
        services.AddApplicationInsightsTelemetryWorkerService();
    }

원격 분석 이니셜라이저 제거

원격 분석 이니셜라이저는 기본적으로 존재합니다. 모든 또는 특정 원격 분석 이니셜라이저를 제거하려면 를 호출한 AddApplicationInsightsTelemetryWorkerService()에 다음 샘플 코드를 사용합니다.

   public void ConfigureServices(IServiceCollection services)
   {
        services.AddApplicationInsightsTelemetryWorkerService();
        // Remove a specific built-in telemetry initializer.
        var tiToRemove = services.FirstOrDefault<ServiceDescriptor>
                            (t => t.ImplementationType == typeof(AspNetCoreEnvironmentTelemetryInitializer));
        if (tiToRemove != null)
        {
            services.Remove(tiToRemove);
        }

        // Remove all initializers.
        // This requires importing namespace by using Microsoft.Extensions.DependencyInjection.Extensions;
        services.RemoveAll(typeof(ITelemetryInitializer));
   }

ApplicationInsights.config 파일에서 다음을 수행합니다.

    <ApplicationInsights>
      <TelemetryInitializers>
        <!-- Fully qualified type name, assembly name: -->
        <Add Type="CustomInitializer.Telemetry.MyTelemetryInitializer, CustomInitializer"/>
        ...
      </TelemetryInitializers>
    </ApplicationInsights>

ASP.NET Web Apps의 대체 방법은 코드에서 이니셜라이저를 인스턴스화하는 것입니다. 다음 예제에서는 Global.aspx.cs 파일의 코드를 보여줍니다.

 using Microsoft.ApplicationInsights.Extensibility;
 using CustomInitializer.Telemetry;

    protected void Application_Start()
    {
        // ...
        TelemetryConfiguration.Active.TelemetryInitializers.Add(new MyTelemetryInitializer());
    }

새 TelemetryInitializer 인스턴스를 추가하려면 종속성 주입 컨테이너에 추가합니다. 다음 예제에서는 이 방법을 보여 줍니다. ConfigureServices 메서드에 이 코드를 당신의 Startup.cs 클래스에 추가합니다.

 using Microsoft.ApplicationInsights.Extensibility;
 using CustomInitializer.Telemetry;
 public void ConfigureServices(IServiceCollection services)
{
    services.AddSingleton<ITelemetryInitializer, MyTelemetryInitializer>();
}

ASP.NET 애플리케이션에 대한 샘플링을 구성하는 방법을 알아보려면 Application Insights의 샘플링을 참조하세요.

ASP.NET Core 애플리케이션에 대한 샘플링을 구성하는 방법을 알아보려면 Application Insights의 샘플링을 참조하세요.

Application Insights SDK for Worker Service는 고정 비율 샘플링 및 적응 샘플링을 모두 지원합니다. 적응 샘플링은 기본적으로 사용하도록 설정됩니다. EnableAdaptiveSampling의 옵션을 사용하여 샘플링을 사용하지 않도록 설정할 수 있습니다.

다른 샘플링 설정을 구성하려면 다음 예제를 사용할 수 있습니다.

using Microsoft.ApplicationInsights.AspNetCore.Extensions;
using Microsoft.ApplicationInsights.Extensibility;

var builder = WebApplication.CreateBuilder(args);

builder.Services.Configure<TelemetryConfiguration>(telemetryConfiguration =>
{
   var telemetryProcessorChainBuilder = telemetryConfiguration.DefaultTelemetrySink.TelemetryProcessorChainBuilder;

   // Using adaptive sampling
   telemetryProcessorChainBuilder.UseAdaptiveSampling(maxTelemetryItemsPerSecond: 5);

   // Alternately, the following configures adaptive sampling with 5 items per second, and also excludes DependencyTelemetry from being subject to sampling:
   // telemetryProcessorChainBuilder.UseAdaptiveSampling(maxTelemetryItemsPerSecond:5, excludedTypes: "Dependency");
});

builder.Services.AddApplicationInsightsTelemetryWorkerService(new ApplicationInsightsServiceOptions
{
   EnableAdaptiveSampling = false,
});

var app = builder.Build();

var requestTelemetry = HttpContext.Current?.Items["Microsoft.ApplicationInsights.RequestTelemetry"] as RequestTelemetry;

if (requestTelemetry != null)
{
    requestTelemetry.Properties["myProp"] = "someData";
}

HttpContext.Features.Get<RequestTelemetry>().Properties["myProp"] = someData

Application Insights .NET SDK는 다양한 NuGet 패키지로 구성됩니다. 코어 패키지 Application Insights에 원격 분석을 보내는 경우에 API를 제공합니다. 추가 패키지는 원격 분석 모듈 및 이니셜라이저를 제공하여 애플리케이션과 해당 컨텍스트에서 원격 분석을 자동으로 추적합니다. 구성 파일을 조정하면 원격 분석 모듈과 이니셜라이저를 사용하거나 사용하지 않도록 설정할 수 있습니다. 일부 매개 변수에 대한 매개 변수를 설정할 수도 있습니다.

구성 파일의 이름은 ApplicationInsights.config 또는 ApplicationInsights.xml입니다. 이름은 애플리케이션의 유형에 따라 달라집니다. 대부분의 SDK 버전은 설치할 때 프로젝트에 자동으로 추가됩니다.

기본적으로 추가>Application Insights 원격 분석을 지원하는 Visual Studio 템플릿 프로젝트에서 자동화된 환경을 사용하는 경우 ApplicationInsights.config 파일이 프로젝트 루트 폴더에 만들어집니다. 컴파일한 후 bin 폴더에 복사됩니다. 또한 IIS 서버의 Application Insights 에이전트에 의해 웹앱에 추가됩니다.

웹 페이지에서 SDK를 제어할 동급의 파일은 없습니다.

ASP.NET Core 애플리케이션에서는 달리 지시하지 않는 한 ConfigureServices() 클래스의 메서드에서 모든 구성이 변경됩니다.

Worker Service SDK에서 사용하는 기본값 TelemetryConfiguration은 ASP.NET 또는 ASP.NET Core 애플리케이션에서 사용되는 자동 구성과 유사하며, HttpContext의 원격 분석 데이터를 보강하는 데 사용되는 TelemetryInitializers를 제외합니다.

Worker Service용 Application Insights SDK를 사용자 지정하여 기본 구성을 변경할 수 있습니다. Application Insights ASP.NET Core SDK 사용자는 ASP.NET Core 기본 제공 종속성 주입을 사용하여 구성을 변경하는 데 익숙할 수 있습니다. 작업자 서비스 SDK도 유사한 원칙을 기반으로 합니다. ConfigureServices() 섹션에서 IServiceCollection의 적절한 메서드를 호출하여 거의 모든 구성을 변경합니다. 자세한 내용은 다음 섹션에 설명되어 있습니다.

옵션 1: 코드의 구성

다음 코드는 사용자 지정 위치로 설정된 ServerTelemetryChannel로 StorageFolder 인스턴스를 설정합니다. 애플리케이션의 시작 부분에 이 코드를 추가합니다(보통 Global.aspx.cs의 Application_Start() 메서드).

using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;
protected void Application_Start()
{
    var serverTelemetryChannel = new ServerTelemetryChannel();
serverTelemetryChannel.StorageFolder = @"d:\temp\applicationinsights";
    serverTelemetryChannel.Initialize(TelemetryConfiguration.Active);
    TelemetryConfiguration.Active.TelemetryChannel = serverTelemetryChannel;
}

옵션 2: ApplicationInsights.config 구성

ApplicationInsights.config의 다음 섹션에서는 사용자 지정 위치로 설정된 ServerTelemetryChannel로 구성된 StorageFolder 채널을 보여 줍니다.

    <TelemetrySinks>
        <Add Name="default">
            <TelemetryProcessors>
                <!-- Telemetry processors omitted for brevity -->
            </TelemetryProcessors>
            <TelemetryChannel Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.ServerTelemetryChannel, Microsoft.AI.ServerTelemetryChannel">
                <StorageFolder>d:\temp\applicationinsights</StorageFolder>
            </TelemetryChannel>
        </Add>
    </TelemetrySinks>

ConfigureServices 클래스의 Startup.cs 메서드를 다음과 같이 수정 합니다.

using Microsoft.ApplicationInsights.Channel;
using Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel;

public void ConfigureServices(IServiceCollection services)
{
    // This sets up ServerTelemetryChannel with StorageFolder set to a custom ___location.
    services.AddSingleton(typeof(ITelemetryChannel), new ServerTelemetryChannel() {StorageFolder = @"d:\temp\applicationinsights" });

    services.AddApplicationInsightsTelemetry();
}

ServerTelemetryChannel 재정의

기본 원격 분석 채널은 ServerTelemetryChannel입니다. 다음 예제에서는 이를 재정의하는 방법을 설명합니다.

using Microsoft.ApplicationInsights.Channel;

var builder = WebApplication.CreateBuilder(args);

// Use the following to replace the default channel with InMemoryChannel.
// This can also be applied to ServerTelemetryChannel.
builder.Services.AddSingleton(typeof(ITelemetryChannel), new InMemoryChannel() {MaxTelemetryBufferCapacity = 19898 });

builder.Services.AddApplicationInsightsTelemetry();

var app = builder.Build();

기본 채널은 .입니다 ServerTelemetryChannel. 이는 다음 예제와 같이 재정의할 수 있습니다.

using Microsoft.ApplicationInsights.Channel;

    public void ConfigureServices(IServiceCollection services)
    {
        // Use the following to replace the default channel with InMemoryChannel.
        // This can also be applied to ServerTelemetryChannel.
        services.AddSingleton(typeof(ITelemetryChannel), new InMemoryChannel() {MaxTelemetryBufferCapacity = 19898 });

        services.AddApplicationInsightsTelemetryWorkerService();
    }

각 원격 분석 모듈은 특정 형식의 데이터를 수집하고 코어 API를 사용하여 데이터를 전송합니다. 모듈은 다른 NuGet 패키지에 의해 설치되며 이는 .config 파일에 필요한 줄을 추가합니다.

TelemetryModules에서 섹션을 사용하여 모듈을 구성, 추가 또는 제거합니다. 다음 예제는 다음과 같습니다.

• 구성 DependencyTrackingTelemetryModule (W3C 헤더 삽입 사용).
• 구성 EventCounterCollectionModule (기본값 지우기 및 단일 카운터 추가).
• PerformanceCollectorModule을(를) 제거하여 perf-counter 컬렉션을 사용하지 않도록 설정합니다.

<ApplicationInsights>
  <TelemetryModules>

    <!-- Dependency tracking -->
    <Add Type="Microsoft.ApplicationInsights.DependencyCollector.DependencyTrackingTelemetryModule, Microsoft.AI.DependencyCollector">
      <!-- Match Core example: enable W3C header injection -->
      <EnableW3CHeadersInjection>true</EnableW3CHeadersInjection>
    </Add>

    <!-- EventCounterCollectionModule: add a single counter (if you use event counters) -->
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.EventCounterCollectionModule, Microsoft.AI.PerfCounterCollector">
      <Counters>
        <!-- Mirrors Core example: only collect 'gen-0-size' from System.Runtime -->
        <Add ProviderName="System.Runtime" CounterName="gen-0-size" />
      </Counters>
    </Add>

    <!-- PerformanceCollectorModule (classic Windows performance counters).
         To DISABLE perf-counter collection, do NOT include this module.
         If it already exists in your file, remove or comment it out.
         Example of the line you would remove:
    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector" />
    -->

  </TelemetryModules>
</ApplicationInsights>

옵션 1: ConfigureTelemetryModule을 사용하여 원격 분석 모듈 구성

기본 TelemetryModule을 구성하려면 다음 예제와 같이 ConfigureTelemetryModule<T>에서 IServiceCollection 확장 메서드를 사용합니다.

using Microsoft.ApplicationInsights.DependencyCollector;
using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// The following configures DependencyTrackingTelemetryModule.
// Similarly, any other default modules can be configured.
builder.Services.ConfigureTelemetryModule<DependencyTrackingTelemetryModule>((module, o) =>
        {
            module.EnableW3CHeadersInjection = true;
        });

// The following removes all default counters from EventCounterCollectionModule, and adds a single one.
builder.Services.ConfigureTelemetryModule<EventCounterCollectionModule>((module, o) =>
        {
            module.Counters.Add(new EventCounterCollectionRequest("System.Runtime", "gen-0-size"));
        });

// The following removes PerformanceCollectorModule to disable perf-counter collection.
// Similarly, any other default modules can be removed.
var performanceCounterService = builder.Services.FirstOrDefault<ServiceDescriptor>(t => t.ImplementationType == typeof(PerformanceCollectorModule));
if (performanceCounterService != null)
{
    builder.Services.Remove(performanceCounterService);
}

var app = builder.Build();

옵션 2: ApplicationInsightsServiceOptions를 사용하여 원격 분석 모듈 구성

SDK 버전 2.12.2 이상에서는 다음 예제와 같이 ApplicationInsightsServiceOptions을(를) AddApplicationInsightsTelemetry에 전달하여 몇 가지 일반적인 설정을 수정할 수 있습니다.

var builder = WebApplication.CreateBuilder(args);

var aiOptions = new Microsoft.ApplicationInsights.AspNetCore.Extensions.ApplicationInsightsServiceOptions();

// Disables adaptive sampling.
aiOptions.EnableAdaptiveSampling = false;

// Disables live metrics (also known as QuickPulse).
aiOptions.EnableQuickPulseMetricStream = false;

builder.Services.AddApplicationInsightsTelemetry(aiOptions);
var app = builder.Build();

다음 표에는 ApplicationInsightsServiceOptions 설정의 전체 목록이 있습니다.

최신 목록은 ApplicationInsightsServiceOptions의 구성 가능한 설정을 참조하세요.

Microsoft.ApplicationInsights.AspNetCore SDK 2.15.0 이상에 대한 구성 권장 사항

Microsoft.ApplicationInsights.AspNetCore SDK 버전 2.15.0 이상에서 ApplicationInsightsServiceOptions을 포함하여 ConnectionString에서 사용 가능한 모든 설정을 구성합니다. 애플리케이션의 IConfiguration 인스턴스를 사용합니다. 설정은 다음 예와 같이 섹션 ApplicationInsights 아래에 있어야 합니다. appsettings.json의 다음 섹션에서는 연결 문자열을 구성하고 적응 샘플링과 성능 카운터 수집을 사용하지 않습니다.

{
    "ApplicationInsights": {
    "ConnectionString": "InstrumentationKey=00000000-0000-0000-0000-000000000000",
    "EnableAdaptiveSampling": false,
    "EnablePerformanceCounterCollectionModule": false
    }
}

builder.Services.AddApplicationInsightsTelemetry(aiOptions)(ASP.NET Core 6.0의 경우) 또는 services.AddApplicationInsightsTelemetry(aiOptions)(ASP.NET Core 3.1 이하의 경우)인 경우 Microsoft.Extensions.Configuration.IConfiguration의 설정을 재정의합니다.

옵션 1: ConfigureTelemetryModule을 사용하여 원격 분석 모듈 구성

Application Insights는 원격 분석 모듈을 사용하여 수동 추적 없이 특정 워크로드에 대한 원격 분석을 자동으로 수집합니다.

다음 자동 데이터 정렬 모듈은 기본적으로 사용하도록 설정됩니다. 이러한 자동 수집 모듈은 원격 분석을 자동으로 수집해야 합니다. 자동 수집 모듈을 사용하지 않도록 설정하거나 해당 기본 동작을 변경하도록 구성할 수 있습니다.

• DependencyTrackingTelemetryModule
• PerformanceCollectorModule
• QuickPulseTelemetryModule
• AppServicesHeartbeatTelemetryModule (현재 이 원격 분석 모듈과 관련된 문제가 있습니다. 임시 해결 방법은 GitHub 문제 1689를 참조하세요.)
• AzureInstanceMetadataTelemetryModule

기본 원격 분석 모듈을 구성하려면, 다음 예제에서 ConfigureTelemetryModule의 확장 메서드 IServiceCollection를 사용합니다.

    using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.QuickPulse;
    using Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector;

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddApplicationInsightsTelemetryWorkerService();

            // The following configures QuickPulseTelemetryModule.
            // Similarly, any other default modules can be configured.
            services.ConfigureTelemetryModule<QuickPulseTelemetryModule>((module, o) =>
            {
                module.AuthenticationApiKey = "keyhere";
            });

            // The following removes PerformanceCollectorModule to disable perf-counter collection.
            // Similarly, any other default modules can be removed.
            var performanceCounterService = services.FirstOrDefault<ServiceDescriptor>
                                        (t => t.ImplementationType == typeof(PerformanceCollectorModule));
            if (performanceCounterService != null)
            {
                services.Remove(performanceCounterService);
            }
    }

옵션 2: ApplicationInsightsServiceOptions를 사용하여 원격 분석 모듈 구성

몇 가지 일반적인 설정은 다음 예제와 같이 ApplicationInsightsServiceOptions를 AddApplicationInsightsTelemetryWorkerService에 전달하여 수정할 수 있습니다.

using Microsoft.ApplicationInsights.WorkerService;

public void ConfigureServices(IServiceCollection services)
{
    var aiOptions = new ApplicationInsightsServiceOptions();
    // Disables adaptive sampling.
    aiOptions.EnableAdaptiveSampling = false;

    // Disables live metrics (also known as QuickPulse).
    aiOptions.EnableQuickPulseMetricStream = false;
    services.AddApplicationInsightsTelemetryWorkerService(aiOptions);
}

이 SDK의 ApplicationInsightsServiceOptions는 ASP.NET Core SDK의 Microsoft.ApplicationInsights.WorkerService와 달리 Microsoft.ApplicationInsights.AspNetCore.Extensions 네임스페이스에 있습니다.

다음 표에는 일반적으로 사용되는 설정이 나열되어 있습니다 ApplicationInsightsServiceOptions.

최신 목록은 에서 구성 가능한 설정을 참조하세요ApplicationInsightsServiceOptions.

각 모듈에 대해 구성 파일에 노드가 있습니다. 모듈을 사용하지 않으려면 노드를 삭제하거나 주석으로 처리합니다.

원격 분석을 조건부로, 동적으로 사용하지 않도록 설정하려는 경우 코드의 어느 위치에서나 ASP.NET Core 종속성 삽입 컨테이너를 사용하여 TelemetryConfiguration 인스턴스를 확인하고 이 인스턴스에 DisableTelemetry 플래그를 설정할 수 있습니다.

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// any custom configuration can be done here:
builder.Services.Configure<TelemetryConfiguration>(x => x.DisableTelemetry = true);

var app = builder.Build();

앞의 코드 샘플은 Application Insights에 원격 분석을 보내는 것을 방지합니다. 자동 수집 모듈이 원격 분석을 수집하는 것을 방지하지는 않습니다. 특정 자동 데이터 정렬 모듈을 제거하려면 원격 분석 모듈을 참조하세요.

원격 분석을 조건부로, 동적으로 사용하지 않도록 설정하려는 경우 코드의 어느 위치에서나 ASP.NET Core 종속성 삽입 컨테이너를 사용하여 TelemetryConfiguration 인스턴스를 확인하고 이 인스턴스에 DisableTelemetry 플래그를 설정할 수 있습니다.

    public void ConfigureServices(IServiceCollection services)
    {
        services.AddApplicationInsightsTelemetryWorkerService();
    }

    public void Configure(IApplicationBuilder app, IHostingEnvironment env, TelemetryConfiguration configuration)
    {
        configuration.DisableTelemetry = true;
        ...
    }

표준 원격 분석 모듈을 포함하여 TelemetryClient의 모든 인스턴스에 대한 연결 문자열을 설정하려면 ASP.NET 서비스의 global.aspx.cs 같은 초기화 메서드에서 이 단계를 수행합니다.

using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights;

    protected void Application_Start()
    {
        TelemetryConfiguration configuration = TelemetryConfiguration.CreateDefault();
        configuration.ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000";
        var telemetryClient = new TelemetryClient(configuration);

특정 이벤트 집합을 다른 리소스로 보내려는 경우 특정 원격 분석 클라이언트에 대한 키를 설정할 수 있습니다.

    var tc = new TelemetryClient();
    tc.Context.ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000";
    tc.TrackEvent("myEvent");
    // ...

새 연결 문자열을 얻으려면 Application Insights 포털에서 새 리소스를 만듭니다.

ASP.NET Core에서 DI(종속성 주입) 컨테이너의 Program.cs을(를) 사용하여 애플리케이션을 시작하는 동안 TelemetryConfiguration에서 연결 문자열을 구성합니다.

using Microsoft.ApplicationInsights.Extensibility;
using Microsoft.ApplicationInsights;

var builder = WebApplication.CreateBuilder(args);

// Add Application Insights
builder.Services.AddApplicationInsightsTelemetry();

var app = builder.Build();

// Resolve TelemetryConfiguration from DI and set the connection string
var config = app.Services.GetRequiredService<TelemetryConfiguration>();
config.ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000";

app.Run();

특정 이벤트 집합을 다른 리소스로 보내려면 새 TelemetryClient 인스턴스를 만들고 해당 연결 문자열을 명시적으로 설정할 수 있습니다.

using Microsoft.ApplicationInsights;

var tc = new TelemetryClient();
tc.Context.ConnectionString = "InstrumentationKey=00000000-0000-0000-0000-000000000000";
tc.TrackEvent("myEvent");
// ...

ApplicationInsights.config를 통한 예제 구성

<ApplicationInsights>
    ...
    <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights">
        <ProfileQueryEndpoint>https://dc.services.visualstudio.com/api/profiles/{0}/appId</ProfileQueryEndpoint>
    </ApplicationIdProvider>
    ...
</ApplicationInsights>

코드를 통한 구성 예제

TelemetryConfiguration.Active.ApplicationIdProvider = new ApplicationInsightsApplicationIdProvider();

기본 공급자를 재정의하거나 해당 ProfileQueryEndpoint을(를) 사용자 지정할 수 있습니다.

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;

var builder = WebApplication.CreateBuilder(args);

// Add Application Insights
builder.Services.AddApplicationInsightsTelemetry();

// Replace default provider with custom configuration
builder.Services.AddSingleton<IApplicationIdProvider>(sp =>
    new ApplicationInsightsApplicationIdProvider
    {
        ProfileQueryEndpoint = "https://custom-proxy/api/profiles/{0}/appId"
    });

var app = builder.Build();
app.Run();

ApplicationInsights.config를 통한 예제 구성

<ApplicationInsights>
    ...
    <ApplicationIdProvider Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.DictionaryApplicationIdProvider, Microsoft.ApplicationInsights">
        <Defined>
            <Type key="InstrumentationKey_1" value="ApplicationId_1"/>
            <Type key="InstrumentationKey_2" value="ApplicationId_2"/>
        </Defined>
        <Next Type="Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId.ApplicationInsightsApplicationIdProvider, Microsoft.ApplicationInsights" />
    </ApplicationIdProvider>
    ...
</ApplicationInsights>

코드를 통한 구성 예제

TelemetryConfiguration.Active.ApplicationIdProvider = new DictionaryApplicationIdProvider{
 Defined = new Dictionary<string, string>
    {
        {"InstrumentationKey_1", "ApplicationId_1"},
        {"InstrumentationKey_2", "ApplicationId_2"}
    }
};

using Microsoft.ApplicationInsights.Extensibility.Implementation.ApplicationId;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddApplicationInsightsTelemetry();

// Register DictionaryApplicationIdProvider
builder.Services.AddSingleton<IApplicationIdProvider>(sp =>
    new DictionaryApplicationIdProvider
    {
        Defined = new Dictionary<string, string>
        {
            { "InstrumentationKey_1", "ApplicationId_1" },
            { "InstrumentationKey_2", "ApplicationId_2" }
        },
        Next = new ApplicationInsightsApplicationIdProvider() // optional fallback
    });

var app = builder.Build();
app.Run();

이 문서에서 템플릿 기반 ASP.NET MVC 앱의 경우 _Layout.cshtml 파일을 편집해야 합니다. 이 파일은 보기>공유에서 찾을 수 있습니다. 클라이언트 쪽 모니터링을 추가하려면 _Layout.cshtml을 열고 클라이언트 쪽 JavaScript SDK 구성에 대한 문서의 JavaScript(웹) SDK 로더 스크립트 기반 설정 지침을 따릅니다.

애플리케이션에 클라이언트 쪽 구성 요소가 있는 경우 다음 단계에 따라 구성별 JavaScript(웹) SDK 로더 스크립트 삽입을 사용하여 사용 원격 분석 수집을 시작합니다.

1. _ViewImports.cshtml에서 injection을 추가합니다.

   @inject Microsoft.ApplicationInsights.AspNetCore.JavaScriptSnippet JavaScriptSnippet
   

2. _Layout.cshtml에서 HtmlHelper 섹션의 끝에 <head>을 삽입하지만, 다른 스크립트보다 앞에 배치합니다. 페이지에서 사용자 지정 JavaScript 원격 분석을 보고하려는 경우 다음 코드 조각 뒤에 삽입합니다.

       @Html.Raw(JavaScriptSnippet.FullScript)
   </head>
   

FullScript를 사용하는 대신 ScriptBody는 ASP.NET Core용 Application Insights SDK 버전 2.14부터 사용할 수 있습니다. 콘텐츠 보안 정책을 설정하기 위해 ScriptBody 태그를 제어해야 하는 경우 <script>를 사용합니다.

<script> // apply custom changes to this script tag.
    @Html.Raw(JavaScriptSnippet.ScriptBody)
</script>

앞에서 참조한 .cshtml 파일 이름은 기본 MVC 애플리케이션 템플릿에서 가져옵니다. 궁극적으로 애플리케이션에 대해 클라이언트 쪽 모니터링을 올바르게 사용하도록 설정하려면 모니터링하려는 애플리케이션의 각 페이지 섹션에 <head> JavaScript(웹) SDK 로더 스크립트가 표시되어야 합니다. JavaScript(웹) SDK 로더 스크립트를 애플리케이션 템플릿의 _Layout.cshtml 에 추가하여 클라이언트 쪽 모니터링을 사용하도록 설정합니다.

프로젝트에 _Layout.cshtml이 포함되지 있습니다. 또는 JavaScript(웹) SDK 로더 스크립트를 여러 페이지에 추가할 수 있지만 권장되지 않습니다.

private TelemetryClient telemetry = new TelemetryClient();

이 메서드가 사용되지 않는다는 메시지가 표시되는 경우 자세한 내용은 microsoft/ApplicationInsights-dotnet#1152 를 참조하세요.

들어오는 HTTP 요청은 자동으로 캡처됩니다. 앱의 다른 모듈을 위해 TelemetryClient 인스턴스를 더 많이 생성할 수도 있습니다. 예를 들어 미들웨어 클래스에 비즈니스 논리 이벤트를 보고하는 인스턴스가 하나 TelemetryClient 있을 수 있습니다. UserId 및 DeviceId와 같은 속성을 설정하여 기계를 식별할 수 있습니다. 이 정보는 인스턴스가 보내는 모든 이벤트에 연결됩니다.

TelemetryClient.Context.User.Id = "...";
TelemetryClient.Context.Device.Id = "...";

var telemetry = applicationInsights.defaultClient;

새 인스턴스를 만드는 데 사용할 new applicationInsights.TelemetryClient(instrumentationKey?) 수 있습니다. 단일 항목 defaultClient에서 격리된 구성이 필요한 시나리오에 대해서만 이 방법을 사용하는 것이 좋습니다.

telemetry.TrackEvent("WinGame");

telemetry.trackEvent({name: "WinGame"});

var sample = new MetricTelemetry();
sample.Name = "queueLength";
sample.Sum = 42.3;
telemetryClient.TrackMetric(sample);

telemetry.trackMetric({name: "queueLength", value: 42.0});

telemetry.TrackPageView("GameReviewPage");

적용할 수 없습니다.

// Establish an operation context and associated telemetry item:
using (var operation = telemetryClient.StartOperation<RequestTelemetry>("operationName"))
{
    // Telemetry sent in here uses the same operation ID.
    ...
    telemetryClient.TrackTrace(...); // or other Track* calls
    ...

    // Set properties of containing telemetry item--for example:
    operation.Telemetry.ResponseCode = "200";

    // Optional: explicitly send telemetry item:
    telemetryClient.StopOperation(operation);

} // When operation is disposed, telemetry item is sent.

상관 관계에 대한 자세한 내용은 Application Insights의 원격 분석 상관 관계를 참조하세요.

// Establish an operation context and associated telemetry item:
const operation = appInsights.startOperation(client, { name: "operationName" });

appInsights.wrapWithCorrelationContext(() => {
    // Telemetry sent in here uses the same operation ID.
    ...
    client.trackTrace({ message: "..." }); // or other track* calls
    ...

    // Set properties of containing telemetry item—for example:
    operation.telemetry.responseCode = "200";

    // Optional: explicitly send telemetry item:
    client.stopOperation(operation);

}, operation.context)(); // When callback completes, telemetry item is sent.

try
{
    ...
}
catch (Exception ex)
{
    telemetry.TrackException(ex);
}

try
{
    ...
}
catch (ex)
{
    telemetry.trackException({exception: ex});
}

.NET 로그 어댑터에서 이 API를 사용하여 타사 로그를 포털로 보냅니다.

telemetry.TrackTrace(message, SeverityLevel.Warning, properties);

telemetry.trackTrace({
    message: message,
    severity: applicationInsights.Contracts.SeverityLevel.Warning,
    properties: properties
});

var telemetry = new Microsoft.ApplicationInsights.TelemetryClient();
telemetry.TrackTrace("Slow database response",
                SeverityLevel.Warning,
                new Dictionary<string,string> { {"database", db.ID} });

var success = false;
var startTime = DateTime.UtcNow;
var timer = System.Diagnostics.Stopwatch.StartNew();
try
{
    success = dependency.Call();
}
catch(Exception ex)
{
    success = false;
    telemetry.TrackException(ex);
    throw new Exception("Operation went wrong", ex);
}
finally
{
    timer.Stop();
    telemetry.TrackDependency("DependencyType", "myDependency", "myCall", startTime, timer.Elapsed, success);
}

var success = false;
var startTime = new Date().getTime();
try
{
    success = dependency.Call();
}
finally
{
    var elapsed = new Date() - startTime;
    telemetry.trackDependency({
        dependencyTypeName: "myDependency",
        name: "myCall",
        duration: elapsed,
        success: success
    });
}

사용할 때 Flush()을, 우리는 다음의 패턴을 추천합니다:

telemetry.Flush();
// Allow some time for flushing before shutdown.
System.Threading.Thread.Sleep(5000);

FlushAsync()를 사용할 때는 다음 패턴을 사용하는 것을 권장합니다.

await telemetryClient.FlushAsync()
// No need to sleep

원격 분석이 손실되지 않도록 항상 애플리케이션 종료의 일부로 플러시하는 것이 좋습니다.

이 함수는 서버 원격 분석 채널에 대해 비동기적입니다.

telemetry.flush();

// Set up some properties and metrics:
var properties = new Dictionary <string, string>
    {{"game", currentGame.Name}, {"difficulty", currentGame.Difficulty}};
var metrics = new Dictionary <string, double>
    {{"Score", currentGame.Score}, {"Opponents", currentGame.OpponentCount}};

// Send the event:
telemetry.TrackEvent("WinGame", properties, metrics);

// Set up some properties and metrics:
var properties = {"game": currentGame.Name, "difficulty": currentGame.Difficulty};
var metrics = {"Score": currentGame.Score, "Opponents": currentGame.OpponentCount};

// Send the event:
telemetry.trackEvent({name: "WinGame", properties: properties, measurements: metrics});

var stopwatch = System.Diagnostics.Stopwatch.StartNew();

// ... perform the timed action ...

stopwatch.Stop();

var metrics = new Dictionary <string, double>
    {{"processingTime", stopwatch.Elapsed.TotalMilliseconds}};

// Set up some properties:
var properties = new Dictionary <string, string>
    {{"signalSource", currentSignalSource.Name}};

// Send the event:
telemetry.TrackEvent("SignalProcessed", properties, metrics);

using Microsoft.ApplicationInsights.DataContracts;

var gameTelemetry = new TelemetryClient();
gameTelemetry.Context.GlobalProperties["Game"] = currentGame.Name;
// Now all telemetry is automatically sent with the context property:
gameTelemetry.TrackEvent("WinGame");

var gameTelemetry = new applicationInsights.TelemetryClient();
gameTelemetry.commonProperties["Game"] = currentGame.Name;

gameTelemetry.TrackEvent({name: "WinGame"});

using  Microsoft.ApplicationInsights.Extensibility;

TelemetryConfiguration.Active.DisableTelemetry = true;

telemetry.config.disableAppInsights = true;

선택한 표준 수집기(예: 성능 카운터, HTTP 요청 또는 종속성)를 초기화 시 사용하지 않도록 설정하려면 구성 메서드를 SDK 초기화 코드에 연결합니다.

applicationInsights.setup()
    .setAutoCollectRequests(false)
    .setAutoCollectPerformance(false)
    .setAutoCollectExceptions(false)
    .setAutoCollectDependencies(false)
    .setAutoCollectConsole(false)
    .start();

초기화 후 이러한 수집기를 사용하지 않도록 설정하려면 Configuration 개체 applicationInsights.Configuration.setAutoCollectRequests(false)를 사용합니다.

TelemetryConfiguration.Active.TelemetryChannel.DeveloperMode = true;

Node.js의 경우 setInternalLogging을 통해 내부 로깅을 사용하도록 설정하고 maxBatchSize를 0으로 설정하여 개발자 모드를 사용하도록 설정할 수 있습니다. 그러면 원격 분석이 수집되는 즉시 보내집니다.

applicationInsights.setup("ikey")
  .setInternalLogging(true, true)
  .start()
applicationInsights.defaultClient.config.maxBatchSize = 0;

var telemetry = new TelemetryClient();
telemetry.InstrumentationKey = "---my key---";
// ...

protected void Application_Start()
{
    Microsoft.ApplicationInsights.Extensibility.
    TelemetryConfiguration.Active.InstrumentationKey =
        // - for example -
        WebConfigurationManager.Settings["ikey"];
    ...
}