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

TelemetryClient.GetMetric 方法

定义

命名空间:

Microsoft.ApplicationInsights

程序集:

Microsoft.ApplicationInsights.dll

包:

Microsoft.ApplicationInsights v2.21.0

重载

GetMetric(String, String, String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String, String, String, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(MetricIdentifier, MetricConfiguration, MetricAggregationScope)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(MetricIdentifier, MetricConfiguration)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(MetricIdentifier)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。
GetMetric(String, String, String)	获取或创建可用于跟踪、聚合和发送指标值的指标容器。 （可选）指定指标配置来控制跟踪值的聚合方式。

GetMetric(String, String, String, String, String, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name, string dimension4Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : string * string * string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String, dimension4Name As String, metricConfiguration As MetricConfiguration) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

dimension4Name

String

第四个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同一个 的所有客户端中聚合在一 TelemetryConfiguration起。

GetMetric(String, String, String, String, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : string * string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

指标值在内存中聚合的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

GetMetric(String, String, String, String, String)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name, string dimension4Name);

member this.GetMetric : string * string * string * string * string -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String, dimension4Name As String) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

dimension4Name

String

第四个维度的名称。

返回

Metric

Metric可用于自动聚合并发送指标数据值的实例。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同一个 的所有客户端中聚合在一 TelemetryConfiguration起。

GetMetric(String, String, String, String, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : string * string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String, metricConfiguration As MetricConfiguration) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同一个 的所有客户端中聚合在一 TelemetryConfiguration起。

GetMetric(String, String, String, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

指标值在内存中聚合的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

GetMetric(String, String, String, String)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name);

member this.GetMetric : string * string * string * string -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

返回

Metric

Metric可用于自动聚合并发送指标数据值的实例。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同一个 的所有客户端中聚合在一 TelemetryConfiguration起。

GetMetric(String, String, String, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, metricConfiguration As MetricConfiguration) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同一个 的所有客户端中聚合在一 TelemetryConfiguration起。

GetMetric(String, String, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

指标值在内存中聚合的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

GetMetric(String, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

metricConfiguration

MetricConfiguration

确定跟踪值将如何聚合。
使用 中的 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

指标值在内存中聚合的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果多次使用给定聚合范围的相同指标 ID 和维度调用此方法，则会收到 相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

GetMetric(String, String, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, metricConfiguration As MetricConfiguration) As Metric

参数

metricId

String

id (指标的名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用参数的 MetricIdentifier 重载。)

dimension1Name

String

第一个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪的值的聚合方式。
在 中使用 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果以前创建了具有相同命名空间、ID、维度和聚合范围但配置不同的指标。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 以表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(String, String, String, String, String, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name, string dimension3Name, string dimension4Name, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : string * string * string * string * string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String, dimension3Name As String, dimension4Name As String, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricId

String

指标的 ID (名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用 MetricIdentifier 参数的重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

dimension3Name

String

第三个维度的名称。

dimension4Name

String

第四个维度的名称。

metricConfiguration

MetricConfiguration

确定跟踪的值的聚合方式。
在 中使用 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

在内存中聚合指标值的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

GetMetric(MetricIdentifier, MetricConfiguration, MetricAggregationScope)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (Microsoft.ApplicationInsights.Metrics.MetricIdentifier metricIdentifier, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration, Microsoft.ApplicationInsights.MetricAggregationScope aggregationScope);

member this.GetMetric : Microsoft.ApplicationInsights.Metrics.MetricIdentifier * Microsoft.ApplicationInsights.Metrics.MetricConfiguration * Microsoft.ApplicationInsights.MetricAggregationScope -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricIdentifier As MetricIdentifier, metricConfiguration As MetricConfiguration, aggregationScope As MetricAggregationScope) As Metric

参数

metricIdentifier

MetricIdentifier

包含命名空间、ID (名称) 和指标的维度名称的分组。

metricConfiguration

MetricConfiguration

确定跟踪的值的聚合方式。
在 中使用 Common 预设或指定自己的设置。

aggregationScope

MetricAggregationScope

在内存中聚合指标值的范围。 有关详细信息，请参阅 MetricAggregationScope。

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

GetMetric(String, String)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name);

member this.GetMetric : string * string -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String) As Metric

参数

metricId

String

指标的 ID (名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用 MetricIdentifier 参数的重载。)

dimension1Name

String

第一个维度的名称。

返回

Metric

一个 Metric 实例，可用于自动聚合并发送指标数据值。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(String, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : string * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, metricConfiguration As MetricConfiguration) As Metric

参数

metricId

String

指标的 ID (名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用 MetricIdentifier 参数的重载。)

metricConfiguration

MetricConfiguration

确定跟踪的值的聚合方式。
在 中使用 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(MetricIdentifier, MetricConfiguration)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (Microsoft.ApplicationInsights.Metrics.MetricIdentifier metricIdentifier, Microsoft.ApplicationInsights.Metrics.MetricConfiguration metricConfiguration);

member this.GetMetric : Microsoft.ApplicationInsights.Metrics.MetricIdentifier * Microsoft.ApplicationInsights.Metrics.MetricConfiguration -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricIdentifier As MetricIdentifier, metricConfiguration As MetricConfiguration) As Metric

参数

metricIdentifier

MetricIdentifier

包含命名空间、ID (名称) 和指标的维度名称的分组。

metricConfiguration

MetricConfiguration

确定跟踪的值的聚合方式。
在 中使用 Common 预设或指定自己的设置。

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(String)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId);

member this.GetMetric : string -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String) As Metric

参数

metricId

String

指标的 ID (名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用 MetricIdentifier 参数的重载。)

返回

Metric

Metric具有指定 ID 和维度的 。 如果使用给定聚合范围的相同指标 ID 和维度多次调用此方法，将收到相同的 实例 Metric。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(MetricIdentifier)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (Microsoft.ApplicationInsights.Metrics.MetricIdentifier metricIdentifier);

member this.GetMetric : Microsoft.ApplicationInsights.Metrics.MetricIdentifier -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricIdentifier As MetricIdentifier) As Metric

参数

metricIdentifier

MetricIdentifier

包含命名空间、ID (名称) 和指标的维度名称的分组。

返回

Metric

一个 Metric 实例，可用于自动聚合并发送指标数据值。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。

GetMetric(String, String, String)

获取或创建可用于跟踪、聚合和发送指标值的指标容器。
（可选）指定指标配置来控制跟踪值的聚合方式。

public Microsoft.ApplicationInsights.Metric GetMetric (string metricId, string dimension1Name, string dimension2Name);

member this.GetMetric : string * string * string -> Microsoft.ApplicationInsights.Metric

Public Function GetMetric (metricId As String, dimension1Name As String, dimension2Name As String) As Metric

参数

metricId

String

指标的 ID (名称) 。 (将使用 中指定的 DefaultMetricNamespace 命名空间。若要指定另一个命名空间，请使用改用 MetricIdentifier 参数的重载。)

dimension1Name

String

第一个维度的名称。

dimension2Name

String

第二个维度的名称。

返回

Metric

一个 Metric 实例，可用于自动聚合并发送指标数据值。

例外

ArgumentException

如果之前创建的指标具有相同的命名空间、ID、维度和聚合范围，但配置不同。 调用此方法以获取以前创建的指标时，只需避免指定任何配置 (或指定 null) 来表示之前使用的配置。

注解

聚合值将发送到 TelemetryConfiguration 与此客户端关联的 。
提取Metric 的 的聚合范围为 TelemetryConfiguration;这意味着，针对给定指标 ID 和维度跟踪的所有值将在共享同 TelemetryConfiguration一 个 的所有客户端之间聚合在一起。