适用于 ASP.NET 和 ASP.NET 核心应用程序的 Application Insights

1. 打开 Visual Studio。
2. 选择 “创建新项目”。
3. 使用 C# 选择 ASP.NET Web 应用程序（.NET Framework），然后选择“下一步”。
4. 输入 项目名称，然后选择“ 创建”。
5. 选择 MVC，然后选择“ 创建”。

1. 打开 Visual Studio。
2. 选择 “创建新项目”。
3. 使用 C# 选择 ASP.NET 核心 Web 应用（Razor Pages），然后选择“下一步”。
4. 输入 项目名称，然后选择“ 创建”。
5. 选择 框架 （LTS 或 STS），然后选择“ 创建”。

在 Visual Studio 中的 ASP.NET Web 应用项目中，请执行以下操作：

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 Web 应用项目中，请执行以下操作：

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.chinacloudapi.cn</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>
   

现在已成功配置服务器端应用程序监视。 如果运行 Web 应用，你将会看到遥测数据开始出现在 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 应用中。 它也可以在所有支持此 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 读取配置，而无需对 appsettings.json 进行这种优先处理。

若要手动配置实时指标，请执行以下操作：

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 包并通过依赖项注入注册提供程序后，该应用即可开始记录日志。 使用构造函数注入时，需要 <xref:Microsoft.Extensions.Logging.ILogger> 或泛型替代 <xref:Microsoft.Extensions.Logging.ILogger%601>。 解析这些实现后，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 核心选项卡中的指南。

对于 ASP.NET 应用程序，完整 SQL 查询文本是在字节代码检测的帮助下收集的，这需要使用检测引擎，或者使用 Microsoft.Data.SqlClient NuGet 包而不是 System.Data.SqlClient 库。 下表描述了用于启用完整 SQL 查询收集的平台特定步骤。

除了上述平台特定的步骤之外，还必须通过以下代码修改 文件来显式选择启用 SQL 命令集合applicationInsights.config：

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

对于 ASP.NET Core 应用程序，需要使用以下方法选择开启 SQL 文本收集：

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

要从服务器端应用程序报告异常，请考虑以下方案：

• 为 Azure Web 应用添加 Application Insights 扩展。
• 为 Azure 虚拟机规模集和 Azure 虚拟机规模集 IIS 托管的应用添加应用程序监视扩展。
• 在应用代码中添加 Application Insights SDK，为 IIS Web 服务器运行 Application Insights 代理，或为 Java Web 应用启用 Java 代理。

借助 JavaScript SDK，客户端能够报告 Web 浏览器中发生的异常的功能。 若要在客户端设置有关报告异常的功能，请参阅用于网页的 Application Insights。

对于某些应用程序框架，需要进行更多配置。 请考虑以下技术：

• Web 窗体
• 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()
    });
}

由于存储队列支持 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：

• 创建（并启动）新的 Activity，而不是启动 Application Insights 操作。 除了作名称之外，无需为其分配任何属性。
• 将 yourActivity.Id 串行化到消息有效负载，而不是 operation.Telemetry.Id。 还可以使用 Activity.Current.Id。

与 Enqueue 类似，Application Insights 自动跟踪对存储队列的实际 HTTP 请求。 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 Web 应用程序的默认计数器：

• % 进程\处理器时间
• % 进程\处理器时间标准化
• 内存\可用字节数
• ASP.NET 请求数/秒
• 每秒抛出异常的 .NET 公共语言运行时 (CLR)
• ASP.NET ApplicationsRequest 执行时间
• 进程\私有字节
• Process\IO 数据字节数/秒
• ASP.NET 应用程序队列中的应用程序\请求
• 处理器（_Total）\% 处理器占用时间

ASP.NET Core Web 应用程序的默认计数器：

• % 进程\处理器时间
• % 进程\处理器时间标准化
• 内存\可用字节数
• 进程\私有字节
• Process\IO 数据字节数/秒
• Processor（_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 是自定义计数器的一个示例，可在 Web 服务中实现。

格式为 \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 包组成。 核心包提供 API，用于将遥测数据发送到 Application Insights。 其他包提供遥测模块和初始值设定项，用于自动从应用程序及其上下文跟踪遥测。 可以通过调整配置文件来启用或禁用遥测模块和初始值设定项。 对于其中的一些，你还可以设置参数。

配置文件名称是 ApplicationInsights.config 或 ApplicationInsights.xml。 该名称取决于应用程序的类型。 安装大多数版本的 SDK 时，系统会自动将配置文件添加到项目。

默认情况下，使用支持“添加”“Application Insights 遥测”>的 Visual Studio 模板项目提供的自动化体验时，ApplicationInsights.config 文件将在项目根文件夹中创建。 编译后，它会复制到 bin 文件夹。 它也会由 IIS 服务器上的 Application Insights 代理添加到 Web 应用。

没有一个等效的文件用来控制网页中的 SDK。

在 ASP.NET Core 应用程序中，所有配置更改应在ConfigureServices()类中的方法中进行，除非另有指示。

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

每个遥测模块收集特定类型的数据，并使用核心 API 来发送数据。 不同的 NuGet 包会安装这些模块，同时在 .config 文件中添加所需的行。

使用 ApplicationInsights.configTelemetryModules 中的 部分来配置、添加或删除模块。 示例如下：

• 配置 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。 它不会阻止任何自动收集模块收集遥测数据。 如果要删除特定的自动收集模块，请参阅遥测模块。

遥测初始值设定项设置连同每个遥测项一起发送的上下文属性。

可以编写自己的初始值设定项来设置上下文属性。

标准的初始值设定项均由 Web 或 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 中，在应用程序启动期间使用依赖项注入 (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();

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 (Web) SDK 加载程序脚本的设置说明进行操作。

如果应用程序具有客户端组件，请按照后续步骤开始使用 JavaScript (Web) SDK 加载程序脚本注入通过配置来收集用量遥测数据。

1. 在 _ViewImports.cshtml 中，添加注入：

   @inject Microsoft.ApplicationInsights.AspNetCore.JavaScriptSnippet JavaScriptSnippet
   

2. 在 _Layout.cshtml 中，将 HtmlHelper 插入到 <head> 节的末尾、任何其他脚本的前面。 若要从页面报告任何自定义 JavaScript 遥测数据，请将其注入到此片段的后面：

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

作为 FullScript 的替代方法，ScriptBody 从 Application Insights SDK for ASP.NET Core 版本 2.14 开始提供。 如果需要控制 ScriptBody 标记以设置内容安全策略，请使用 <script>：

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

前面引用的 .cshtml 文件名取自默认的 MVC 应用程序模板。 从根本上讲，若要为应用程序正确启用客户端监视，JavaScript (Web) SDK 加载程序脚本必须出现在所要监视的应用程序的每个页面的 <head> 部分中。 在应用程序模板中，将 JavaScript (Web) SDK 加载程序脚本添加到 _Layout.cshtml 以启用客户端监视。

如果你的项目不包含 _Layout.cshtml，仍可通过将 JavaScript (Web) SDK 加载程序脚本添加到控制应用内所有页面的 的等效文件来添加<head>。 或者，可将 JavaScript (Web) SDK 加载程序脚本添加到多个页面中，但我们不建议这样做。