NullTelemetryClient 类

构造函数

NullTelemetryClient()

方法

track_dependency

发送为应用程序捕获的单个依赖项遥测数据。 :p aram 名称:使用此依赖项调用启动的命令的名称。 低基数值。 示例包括存储过程名称和 URL 路径模板。 :p aram 数据:此依赖项调用启动的命令。 示例包括包含所有查询参数的 SQL 语句和 HTTP URL。 :p aram type_name:依赖项类型名称。 用于对依赖项进行逻辑分组的低基数值,以及 commandName 和 resultCode 等其他字段的解释。 示例包括 SQL、Azure 表和 HTTP。 (默认值为:None):p aram 目标:依赖项调用的目标站点。 例如服务器名称、主机地址。 (默认值为: None) :p aram 持续时间:此依赖项调用持续的时间毫秒数。 (默认值为: None) :p aram success: true 如果依赖项调用以成功结束,则为 false;否则为 false。 (默认值为:None):p aram result_code:依赖项调用的结果代码。 示例包括 SQL 错误代码和 HTTP 状态代码。 (默认值为: None) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为: None) :p aram dependency_id:此依赖项调用的 ID。 如果 None,将生成新的 uuid。 (默认值为:无)

track_event

发送有关应用程序上下文中发生的单个事件的信息。 :p aram 名称:要与此事件关联的数据。 :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_exception

发送有关应用程序中发生的单个异常的信息。 :p aram exception_type:引发的异常的类型。 :p aram 值:客户端要发送的异常。 :p aram 跟踪:exc_info返回的跟踪信息。 :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_metric

发送有关为应用程序捕获的单个指标数据点的信息。 :p aram 名称:捕获的指标的名称。 :p aram 值:捕获的指标的值。 :p aram tel_type:指标的类型。 (默认值为:TelemetryDataPointType.aggregation'):p aram 计数:聚合到此数据点的指标数。 (默认值为:无:p aram min_val:收集到此数据点的所有指标的最小值。

(默认值为:无)

track_pageview

发送有关应用程序(例如网页)中查看的页面的信息。 :p aram 名称:已查看的页面的名称。 :p aram url:已查看的页面的 URL。 :p aram 持续时间:页面视图的持续时间(以毫秒为单位)。 (默认值为: 0) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_request

发送为应用程序捕获的单个请求。 :p aram 名称:此请求的名称。 具有相同名称的所有请求将分组在一起。 :p aram url:此请求的实际 URL(要显示在单个请求实例中)。 :p aram 成功:如果请求成功结束,则为 True;否则为 False。 :p aram start_time:请求的开始时间。 该值应与 <xref:datetime.isoformat>返回的值相同。 (默认值为: None) :p aram 持续时间:此请求持续的时间毫秒数。 (默认值为: None) :p aram response_code:此请求返回的响应代码。 (默认值为:None):p aram http_method:触发此请求的 HTTP 方法。 (默认值为: None) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为: None) :p aram request_id:此请求的 ID。 如果 None,将生成新的 uuid。 (默认值为:无)

track_trace

发送单个跟踪语句。 :p aram 名称:跟踪语句。

track_dependency

发送为应用程序捕获的单个依赖项遥测数据。 :p aram 名称:使用此依赖项调用启动的命令的名称。 低基数值。 示例包括存储过程名称和 URL 路径模板。 :p aram 数据:此依赖项调用启动的命令。 示例包括包含所有查询参数的 SQL 语句和 HTTP URL。 :p aram type_name:依赖项类型名称。 用于对依赖项进行逻辑分组的低基数值,以及 commandName 和 resultCode 等其他字段的解释。 示例包括 SQL、Azure 表和 HTTP。 (默认值为:None):p aram 目标:依赖项调用的目标站点。 例如服务器名称、主机地址。 (默认值为: None) :p aram 持续时间:此依赖项调用持续的时间毫秒数。 (默认值为: None) :p aram success: true 如果依赖项调用以成功结束,则为 false;否则为 false。 (默认值为:None):p aram result_code:依赖项调用的结果代码。 示例包括 SQL 错误代码和 HTTP 状态代码。 (默认值为: None) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为: None) :p aram dependency_id:此依赖项调用的 ID。 如果 None,将生成新的 uuid。 (默认值为:无)

track_dependency(name: str, data: str, type_name: str = None, target: str = None, duration: int = None, success: bool = None, result_code: str = None, properties: Dict[str, object] = None, measurements: Dict[str, object] = None, dependency_id: str = None)

参数

名称 说明
name
必需
data
必需
type_name
默认值: None
target
默认值: None
duration
默认值: None
success
默认值: None
result_code
默认值: None
properties
默认值: None
measurements
默认值: None
dependency_id
默认值: None

track_event

发送有关应用程序上下文中发生的单个事件的信息。 :p aram 名称:要与此事件关联的数据。 :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_event(name: str, properties: Dict[str, object] = None, measurements: Dict[str, object] = None) -> None

参数

名称 说明
name
必需
properties
默认值: None
measurements
默认值: None

track_exception

发送有关应用程序中发生的单个异常的信息。 :p aram exception_type:引发的异常的类型。 :p aram 值:客户端要发送的异常。 :p aram 跟踪:exc_info返回的跟踪信息。 :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_exception(exception_type: type = None, value: Exception = None, trace: <module 'traceback' from 'C:\\hostedtoolcache\\windows\\Python\\3.11.10\\x64\\Lib\\traceback.py'> = None, properties: ~typing.Dict[str, object] = None, measurements: ~typing.Dict[str, object] = None) -> None

参数

名称 说明
exception_type
默认值: None
value
默认值: None
trace
默认值: None
properties
默认值: None
measurements
默认值: None

track_metric

发送有关为应用程序捕获的单个指标数据点的信息。 :p aram 名称:捕获的指标的名称。 :p aram 值:捕获的指标的值。 :p aram tel_type:指标的类型。 (默认值为:TelemetryDataPointType.aggregation'):p aram 计数:聚合到此数据点的指标数。 (默认值为:无:p aram min_val:收集到此数据点的所有指标的最小值。

(默认值为:无)

track_metric(name: str, value: float, tel_type: TelemetryDataPointType = None, count: int = None, min_val: float = None, max_val: float = None, std_dev: float = None, properties: Dict[str, object] = None) -> NotImplemented

参数

名称 说明
max_val

聚合到此数据点的所有指标的最大值。 (默认值为:无)

默认值: None
std_dev

聚合到此数据点的所有指标的标准偏差。 (默认值为:无)

默认值: None
properties

客户端希望附加到此数据项的自定义属性集。 (默认值为:无)

默认值: None
name
必需
value
必需
tel_type
默认值: None
count
默认值: None
min_val
默认值: None

track_pageview

发送有关应用程序(例如网页)中查看的页面的信息。 :p aram 名称:已查看的页面的名称。 :p aram url:已查看的页面的 URL。 :p aram 持续时间:页面视图的持续时间(以毫秒为单位)。 (默认值为: 0) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为:无)

track_pageview(name: str, url, duration: int = 0, properties: Dict[str, object] = None, measurements: Dict[str, object] = None) -> None

参数

名称 说明
name
必需
url
必需
duration
默认值: 0
properties
默认值: None
measurements
默认值: None

track_request

发送为应用程序捕获的单个请求。 :p aram 名称:此请求的名称。 具有相同名称的所有请求将分组在一起。 :p aram url:此请求的实际 URL(要显示在单个请求实例中)。 :p aram 成功:如果请求成功结束,则为 True;否则为 False。 :p aram start_time:请求的开始时间。 该值应与 <xref:datetime.isoformat>返回的值相同。 (默认值为: None) :p aram 持续时间:此请求持续的时间毫秒数。 (默认值为: None) :p aram response_code:此请求返回的响应代码。 (默认值为:None):p aram http_method:触发此请求的 HTTP 方法。 (默认值为: None) :p aram 属性:客户端希望附加到此数据项的自定义属性集。 (默认值为: None) :p aram 度量:客户端希望附加到此数据项的自定义度量集。 (默认值为: None) :p aram request_id:此请求的 ID。 如果 None,将生成新的 uuid。 (默认值为:无)

track_request(name: str, url: str, success: bool, start_time: str = None, duration: int = None, response_code: str = None, http_method: str = None, properties: Dict[str, object] = None, measurements: Dict[str, object] = None, request_id: str = None)

参数

名称 说明
name
必需
url
必需
success
必需
start_time
默认值: None
duration
默认值: None
response_code
默认值: None
http_method
默认值: None
properties
默认值: None
measurements
默认值: None
request_id
默认值: None

track_trace

发送单个跟踪语句。 :p aram 名称:跟踪语句。

track_trace(name, properties=None, severity: Severity = None)

参数

名称 说明
properties

客户端希望附加到此数据项的自定义属性集。 (默认值为:无)

默认值: None
severity

此跟踪的严重性级别,其中一种是 DEBUG、INFO、WARNING、ERROR、CRITICAL

默认值: None
name
必需