PerformanceClient class

构造函数

PerformanceClient(string, string, Logger, string, string, ApplicationTelemetry, Set<string>, Map<string, string>)

创建 PerformanceClient 的实例,这是包含核心性能遥测逻辑的抽象类。

方法

addFields({[key: string]: {} | undefined}, string)

保存刷新度量值时要发出的额外信息

addPerformanceCallback(PerformanceCallbackFunction)

注册回调函数以接收性能事件。

addQueueMeasurement(string, string, number, boolean)

将队列度量时间添加到 QueueMeasurements 数组中,以获取给定的相关 ID。

calculateQueuedTime(number, number)

计算函数排队时的当前时间和时间之间的差异。 注意:如果当前时间和排队时间相同,则队列时间可能为 0。

discardMeasurements(string)

删除给定相关 ID 的度量值和辅助数据。

emitEvents(PerformanceEvent[], string)

向所有已注册的回调发出事件。

endMeasurement(PerformanceEvent, unknown, AccountInfo)

停止测量操作的性能。 应仅由 PerformanceClient 类直接调用,因为使用者应改用 startMeasurement 返回的函数。 为子度量添加一个名为“[事件名称]DurationMs”的新字段,否则完成并发出事件。

generateId()

生成并返回唯一 ID,通常是 guid。

getPreQueueTime(string, string)

按关联 ID 获取预队列时间的映射

incrementFields({[key: string]: number | undefined}, string)

刷新度量值时要发出的递增计数器

removePerformanceCallback(string)

删除向 addPerformanceCallback 注册的回调。

setPreQueueTime(PerformanceEvents, string)

按关联 ID 设置预队列时间

startMeasurement(string, string)

开始测量给定操作的性能。 返回一个函数,该函数应用于结束度量。

startPerformanceMeasurement(string, string)

启动并返回特定于平台的 IPerformanceMeasurement 实现。 注意:此函数可以在下一个主要版本颠簸处更改为抽象。

构造函数详细信息

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

参数

返回

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

PerformanceEvent[]

correlationId

string

endMeasurement(PerformanceEvent, unknown, AccountInfo)

停止测量操作的性能。 应仅由 PerformanceClient 类直接调用,因为使用者应改用 startMeasurement 返回的函数。 为子度量添加一个名为“[事件名称]DurationMs”的新字段,否则完成并发出事件。

function endMeasurement(event: PerformanceEvent, error?: unknown, account?: AccountInfo): null | PerformanceEvent

参数

error

unknown

account
AccountInfo

返回

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

返回