ASP.NET 및 ASP.NET Core 애플리케이션용 Application Insights

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에서 구성을 읽으려면 메서드를 사용합니다.

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

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 지침은 ASP.NET 적용되지 않습니다. 클래식 ASP.NET 앱에서 Application Insights로 추적 로그를 보내려면 다음과 같은 지원되는 어댑터를 사용합니다.

• Application Insights TraceListener를 사용한 System.Diagnostics.Trace
• 공식 Application Insights 대상이 있는 log4net 또는 NLog

자세한 단계 및 구성 예제는 Application Insights에 추적 로그 보내기를 참조하세요.

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

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

ApplicationInsightsLoggerProvider 추가

1. 를 설치합니다 Microsoft.Extensions.Logging.ApplicationInsights.

2. 추가 ApplicationInsightsLoggerProvider:

using Microsoft.Extensions.Logging.ApplicationInsights;

var builder = WebApplication.CreateBuilder(args);

// Add services to the container.

builder.Services.AddControllers();
// Learn more about configuring Swagger/OpenAPI at https://aka.ms/aspnetcore/swashbuckle
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();

builder.Logging.AddApplicationInsights(
        configureTelemetryConfiguration: (config) => 
            config.ConnectionString = builder.Configuration.GetConnectionString("APPLICATIONINSIGHTS_CONNECTION_STRING"),
            configureApplicationInsightsLoggerOptions: (options) => { }
    );

builder.Logging.AddFilter<ApplicationInsightsLoggerProvider>("your-category", LogLevel.Trace);

var app = builder.Build();

// Configure the HTTP request pipeline.
if (app.Environment.IsDevelopment())
{
    app.UseSwagger();
    app.UseSwaggerUI();
}

app.UseHttpsRedirection();

app.UseAuthorization();

app.MapControllers();

app.Run();

NuGet 패키지가 설치되고 공급자가 종속성 주입에 등록되면 앱이 로그할 준비가 된 것입니다. 생성자 주입을 사용하는 경우 제네릭 형식 대안 ILogger 이 ILogger<TCategoryName> 필요합니다. 이러한 구현이 해결되면 해당 구현을 ApplicationInsightsLoggerProvider 제공합니다. 기록된 메시지 또는 예외가 Application Insights로 전송됩니다.

다음 예제 컨트롤러를 고려합니다.

public class ValuesController : ControllerBase
{
    private readonly ILogger _logger;

    public ValuesController(ILogger<ValuesController> logger)
    {
        _logger = logger;
    }

    [HttpGet]
    public ActionResult<IEnumerable<string>> Get()
    {
        _logger.LogWarning("An example of a Warning trace..");
        _logger.LogError("An example of an Error level message");

        return new string[] { "value1", "value2" };
    }
}

자세한 내용은 ASP.NET Core의 로깅 및 ILogger 로그에서 생성되는 Application Insights 원격 분석 유형을 참조하세요. Application Insights에서 ILogger 로그는 어디에서 볼 수 있나요?

.NET 콘솔 앱의 종속성을 자동으로 추적하려면 NuGet 패키지 Microsoft.ApplicationInsights.DependencyCollector을 설치하고 DependencyTrackingTelemetryModule를 초기화합니다.

    DependencyTrackingTelemetryModule depModule = new DependencyTrackingTelemetryModule();
    depModule.Initialize(TelemetryConfiguration.Active);

.NET Core 콘솔 앱의 경우 TelemetryConfiguration.Active는 더 이상 사용되지 않습니다. 이 문서의 작업자 서비스 설명서 및 ASP.NET Core 탭의 지침을 참조하세요.

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 Virtual Machines 및 Azure Virtual Machine Scale Sets 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 하지 않으려면 API를 Activity 직접 사용합니다.

• 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 웹 애플리케이션에 대한 기본 카운터:

• % Process\Processor Time
• % Process\Processor Time normalized
• Memory\Available 바이트
• ASP.NET Requests/Sec
• .NET CLR(공용 언어 런타임) 예외 throw됨/초
• ASP.NET ApplicationsRequest 실행 시간
• Process\Private Bytes
• Process\IO Data Bytes/sec
• ASP.NET Applications\Requests In Application Queue
• Processor(_Total)\% Processor Time

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

• % Process\Processor Time
• % Process\Processor Time normalized
• Memory\Available 바이트
• Process\Private Bytes
• Process\IO Data Bytes/sec
• Processor(_Total)\% Processor Time

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

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

구성 파일의 이름이 지정 ApplicationInsights.config 되거나 ApplicationInsights.xml. 이름은 애플리케이션의 유형에 따라 달라집니다. 대부분의 SDK 버전을 설치하면 프로젝트에 자동으로 추가됩니다.

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

웹 페이지에서 SDK를 제어하는 동일한 파일이 없습니다.

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

옵션 1: 코드의 구성

다음 코드는 사용자 지정 위치로 ServerTelemetryChannelStorageFolder 설정된 인스턴스를 설정합니다. 일반적으로 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();

각 원격 분석 모듈은 특정 유형의 데이터를 수집하고 핵심 API를 사용하여 데이터를 보냅니다. 모듈은 다른 NuGet 패키지에 의해 설치되며 .config 파일에 필요한 줄도 추가합니다.

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

• 구성 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의 설정을 재정의합니다.

구성 파일에는 각 모듈에 대한 노드가 있습니다. 모듈을 사용하지 않도록 설정하려면 노드를 삭제하거나 주석 처리합니다.

원격 분석을 조건부로, 동적으로 사용하지 않도록 설정하려는 경우 코드의 어느 위치에서나 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에 원격 분석을 보내는 것을 방지합니다. 자동 수집 모듈이 원격 분석을 수집하는 것을 방지하지는 않습니다. 특정 자동 데이터 정렬 모듈을 제거하려면 원격 분석 모듈을 참조하세요.

원격 분석 이니셜라이저는 원격 분석의 모든 항목과 함께 전송되는 컨텍스트 속성을 설정합니다.

고유한 이니셜라이저를 작성하여 컨텍스트 속성을 설정할 수 있습니다.

표준 이니셜라이저는 모두 웹 또는 WindowsServer NuGet 패키지에 의해 설정됩니다.

ASP.NET 애플리케이션에서 원격 분석 이니셜라이저를 사용하는 방법을 알아보려면 Application Insights SDK에서 원격 분석 필터링 및 전처리를 참조하세요.

다음 코드와 같이 새 TelemetryInitializer를 DependencyInjection 컨테이너에 추가합니다. SDK에서 TelemetryInitializer 컨테이너에 추가된 모든 DependencyInjection를 자동으로 선택합니다.

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에서 포털로 전송되기 전에 각 원격 분석 항목을 필터링하고 수정할 수 있습니다.

ASP.NET 애플리케이션에서 원격 분석 프로세서를 사용하는 방법을 알아보려면 Application Insights SDK에서 원격 분석 필터링 및 전처리를 참조하세요.

사용자 고유의 원격 분석 프로세서를 작성할 수 있습니다.

적응 샘플링 원격 분석 프로세서(2.0.0-beta3부터)

이 기능은 기본적으로 사용하도록 설정됩니다. 앱이 상당한 원격 분석을 보내는 경우 이 프로세서는 일부 원격 분석을 제거합니다.

    <TelemetryProcessors>
      <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.AdaptiveSamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">
        <MaxTelemetryItemsPerSecond>5</MaxTelemetryItemsPerSecond>
      </Add>
    </TelemetryProcessors>

매개 변수는 알고리즘이 달성하려고 하는 대상을 제공합니다. SDK의 각 인스턴스는 독립적으로 작동합니다. 따라서 서버가 여러 컴퓨터의 클러스터인 경우 그에 따라 실제 원격 분석 볼륨을 곱합니다.

샘플링에 대해 자세히 알아봅니 다.

고정 속도 샘플링 원격 분석 프로세서(2.0.0-beta1부터)

표준 샘플링 원격 분석 프로세서 (2.0.1부터)도 있습니다.

    <TelemetryProcessors>
     <Add Type="Microsoft.ApplicationInsights.WindowsServer.TelemetryChannel.SamplingTelemetryProcessor, Microsoft.AI.ServerTelemetryChannel">

     <!-- Set a percentage close to 100/N where N is an integer. -->
     <!-- E.g. 50 (=100/2), 33.33 (=100/3), 25 (=100/4), 20, 1 (=100/100), 0.1 (=100/1000) -->
     <SamplingPercentage>10</SamplingPercentage>
     </Add>
   </TelemetryProcessors>

TelemetryConfiguration에서 확장 메서드 AddApplicationInsightsTelemetryProcessor를 사용하여 사용자 지정 원격 분석 프로세서를 IServiceCollection에 추가할 수 있습니다. 원격 분석 프로세서는 고급 필터링 시나리오에서 사용합니다. 다음 예제를 사용합니다.

var builder = WebApplication.CreateBuilder(args);

// ...
builder.Services.AddApplicationInsightsTelemetry();
builder.Services.AddApplicationInsightsTelemetryProcessor<MyFirstCustomTelemetryProcessor>();

// If you have more processors:
builder.Services.AddApplicationInsightsTelemetryProcessor<MySecondCustomTelemetryProcessor>();

var app = builder.Build();

표준 원격 분석 모듈을 포함하여 모든 인스턴스에 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에서 Program.cs DI(종속성 주입) 컨테이너를 사용하여 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();

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

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

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

이 문서에서 템플릿 기반 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 로더 스크립트를 여러 페이지에 추가할 수 있지만 권장되지 않습니다.