你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

TelemetryClient 类

定义

命名空间:

Microsoft.ApplicationInsights

程序集:

Microsoft.ApplicationInsights.dll

包:

Microsoft.ApplicationInsights v2.21.0

将事件、指标和其他遥测数据发送到 Application Insights 服务。 了解详细信息

public sealed class TelemetryClient

type TelemetryClient = class

Public NotInheritable Class TelemetryClient

继承

Object

TelemetryClient

构造函数

TelemetryClient()	已过时. 初始化 TelemetryClient 类的新实例。 使用活动配置发送遥测数据，通常从ApplicationInsights.config加载。
TelemetryClient(TelemetryConfiguration)	初始化 TelemetryClient 类的新实例。 使用指定的 configuration发送遥测数据。

属性

Context	获取将用于增加发送的遥测数据的当前上下文。
InstrumentationKey	已过时. 获取或设置在此 TelemetryClient中记录的所有ITelemetry对象的默认检测密钥。

方法

Flush()	刷新内存中缓冲区和预聚合的任何指标。
FlushAsync(CancellationToken)	异步刷新内存中缓冲区和预聚合的任何指标。
GetMetric(MetricIdentifier)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(MetricIdentifier, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(MetricIdentifier, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
IsEnabled()	检查以确定跟踪是否已启用。
TrackAvailability(AvailabilityTelemetry)	发送有关应用程序可用性的信息。 为每个对 的TrackAvailability(AvailabilityTelemetry)调用创建单独的 AvailabilityTelemetry 实例。
TrackAvailability(String, DateTimeOffset, TimeSpan, String, Boolean, String, IDictionary<String,String>, IDictionary<String,Double>)	发送有关应用程序可用性的信息。
TrackDependency(DependencyTelemetry)	发送有关应用程序中的外部依赖项调用的信息。 为每个对 的TrackDependency(DependencyTelemetry)调用创建单独的 DependencyTelemetry 实例。
TrackDependency(String, String, DateTimeOffset, TimeSpan, Boolean)	已过时. (应用程序中的传出调用) 发送有关外部依赖项的信息。
TrackDependency(String, String, String, DateTimeOffset, TimeSpan, Boolean)	(应用程序中的传出调用) 发送有关外部依赖项的信息。
TrackDependency(String, String, String, String, DateTimeOffset, TimeSpan, String, Boolean)	(应用程序中的传出调用) 发送有关外部依赖项的信息。
TrackEvent(EventTelemetry)	发送 ， EventTelemetry 以便在诊断搜索和分析门户中显示。 为每个对 的TrackEvent(EventTelemetry)调用创建单独的 EventTelemetry 实例。
TrackEvent(String, IDictionary<String,String>, IDictionary<String,Double>)	发送 ， EventTelemetry 以便在诊断搜索和分析门户中显示。
TrackException(Exception, IDictionary<String,String>, IDictionary<String,Double>)	发送 ， ExceptionTelemetry 以便在诊断搜索中显示。
TrackException(ExceptionTelemetry)	发送 ， ExceptionTelemetry 以便在诊断搜索中显示。 为每个对 的TrackException(ExceptionTelemetry)调用创建单独的 ExceptionTelemetry 实例。
TrackMetric(MetricTelemetry)	此方法不是发送指标的首选方法。 在发送之前，应当始终对一段时间内的指标进行预聚合。 使用 GetMetric(..) 重载之一获取用于访问 SDK 预聚合功能的指标对象。 如果要实现自己的预聚合逻辑，则可以使用此方法。 如果应用程序要求每次都发送单独的遥测项而不跨时间聚合，则可能是事件遥测的用例;请参阅 TrackEvent(EventTelemetry)。
TrackMetric(String, Double, IDictionary<String,String>)	此方法不是发送指标的首选方法。 在发送之前，应当始终对一段时间内的指标进行预聚合。 使用 GetMetric(..) 重载之一获取用于访问 SDK 预聚合功能的指标对象。 如果要实现自己的预聚合逻辑，则可以使用此方法。 如果应用程序要求每次都发送单独的遥测项而不跨时间聚合，则可能是事件遥测的用例;请参阅 TrackEvent(EventTelemetry)。
TrackPageView(PageViewTelemetry)	发送有关在应用程序中查看的页面的信息。 为每个对 的TrackPageView(PageViewTelemetry)调用创建单独的 PageViewTelemetry 实例。
TrackPageView(String)	发送有关在应用程序中查看的页面的信息。
TrackRequest(RequestTelemetry)	发送有关应用程序处理的请求的信息。 为每个对 的TrackRequest(RequestTelemetry)调用创建单独的 RequestTelemetry 实例。
TrackRequest(String, DateTimeOffset, TimeSpan, String, Boolean)	发送有关应用程序处理的请求的信息。
TrackTrace(String)	发送跟踪消息，以便在诊断搜索中显示。
TrackTrace(String, IDictionary<String,String>)	发送跟踪消息，以便在诊断搜索中显示。
TrackTrace(String, SeverityLevel)	发送跟踪消息，以便在诊断搜索中显示。
TrackTrace(String, SeverityLevel, IDictionary<String,String>)	发送跟踪消息，以便在诊断搜索中显示。
TrackTrace(TraceTelemetry)	发送跟踪消息，以便在诊断搜索中显示。 为每个对 的TrackTrace(TraceTelemetry)调用创建单独的 TraceTelemetry 实例。

扩展方法

GetMetricManager(TelemetryClient, MetricAggregationScope)

获取 MetricManager 指定范围内的此 TelemetryClient 的 。 如果指定范围内不存在指标管理器，则会创建它。