PerformanceClient class
构造函数
| Performance |
创建 PerformanceClient 的实例,这是包含核心性能遥测逻辑的抽象类。 |
方法
构造函数详细信息
PerformanceClient(string, string, Logger, string, string, ApplicationTelemetry, Set<string>, Map<string, string>)
创建 PerformanceClient 的实例,这是包含核心性能遥测逻辑的抽象类。
new PerformanceClient(clientId: string, authority: string, logger: Logger, libraryName: string, libraryVersion: string, applicationTelemetry: ApplicationTelemetry, intFields?: Set<string>, abbreviations?: Map<string, string>)
参数
- clientId
-
string
应用程序的客户端 ID
- authority
-
string
应用程序使用的颁发机构
- logger
- Logger
应用程序使用的记录器
- libraryName
-
string
图书馆的名称
- libraryVersion
-
string
库的版本
- applicationTelemetry
- ApplicationTelemetry
应用程序名称和版本
- intFields
-
Set<string>
要截断的整数字段
- abbreviations
-
Map<string, string>
事件名称缩写
方法详细信息
addFields({[key: string]: {} | undefined}, string)
保存刷新度量值时要发出的额外信息
function addFields(fields: {[key: string]: {} | undefined}, correlationId: string)
参数
- fields
-
{[key: string]: {} | undefined}
- correlationId
-
string
addPerformanceCallback(PerformanceCallbackFunction)
注册回调函数以接收性能事件。
function addPerformanceCallback(callback: PerformanceCallbackFunction): string
参数
- callback
- PerformanceCallbackFunction
返回
string
addQueueMeasurement(string, string, number, boolean)
将队列度量时间添加到 QueueMeasurements 数组中,以获取给定的相关 ID。
function addQueueMeasurement(eventName: string, correlationId?: string, queueTime?: number, manuallyCompleted?: boolean)
参数
- eventName
-
string
- correlationId
-
string
- queueTime
-
number
- manuallyCompleted
-
boolean
手动完成的队列度量的指示器
calculateQueuedTime(number, number)
计算函数排队时的当前时间和时间之间的差异。 注意:如果当前时间和排队时间相同,则队列时间可能为 0。
function calculateQueuedTime(preQueueTime: number, currentTime: number): number
参数
- preQueueTime
-
number
- currentTime
-
number
返回
number
discardMeasurements(string)
删除给定相关 ID 的度量值和辅助数据。
function discardMeasurements(correlationId: string)
参数
- correlationId
-
string
emitEvents(PerformanceEvent[], string)
向所有已注册的回调发出事件。
function emitEvents(events: PerformanceEvent[], correlationId?: string)
参数
- events
- correlationId
-
string
endMeasurement(PerformanceEvent, unknown, AccountInfo)
停止测量操作的性能。 应仅由 PerformanceClient 类直接调用,因为使用者应改用 startMeasurement 返回的函数。 为子度量添加一个名为“[事件名称]DurationMs”的新字段,否则完成并发出事件。
function endMeasurement(event: PerformanceEvent, error?: unknown, account?: AccountInfo): null | PerformanceEvent
参数
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
返回
null | PerformanceEvent
generateId()
生成并返回唯一 ID,通常是 guid。
function generateId(): string
返回
string
getPreQueueTime(string, string)
按关联 ID 获取预队列时间的映射
function getPreQueueTime(eventName: string, correlationId: string): number | void
参数
- eventName
-
string
- correlationId
-
string
返回
number | void
incrementFields({[key: string]: number | undefined}, string)
刷新度量值时要发出的递增计数器
function incrementFields(fields: {[key: string]: number | undefined}, correlationId: string)
参数
- fields
-
{[key: string]: number | undefined}
{string[]}
- correlationId
-
string
{string} 相关标识符
removePerformanceCallback(string)
删除向 addPerformanceCallback 注册的回调。
function removePerformanceCallback(callbackId: string): boolean
参数
- callbackId
-
string
返回
boolean
setPreQueueTime(PerformanceEvents, string)
按关联 ID 设置预队列时间
function setPreQueueTime(eventName: PerformanceEvents, correlationId?: string)
参数
- eventName
- PerformanceEvents
- correlationId
-
string
startMeasurement(string, string)
开始测量给定操作的性能。 返回一个函数,该函数应用于结束度量。
function startMeasurement(measureName: string, correlationId?: string): InProgressPerformanceEvent
参数
- measureName
-
string
- correlationId
-
string
返回
startPerformanceMeasurement(string, string)
警告
现已弃用此 API。
This method will be removed in the next major version
启动并返回特定于平台的 IPerformanceMeasurement 实现。 注意:此函数可以在下一个主要版本颠簸处更改为抽象。
function startPerformanceMeasurement(measureName: string, correlationId: string): IPerformanceMeasurement
参数
- measureName
-
string
- correlationId
-
string