PerformanceClient class

Construtores

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

Cria uma instância do PerformanceClient, uma classe abstrata que contém lógica central de telemetria de desempenho.

Métodos

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

Poupa informação extra quando as medições são limpas

addPerformanceCallback(PerformanceCallbackFunction)

Regista uma função de callback para receber eventos de performance.

addQueueMeasurement(string, string, number, boolean)

Adiciona tempo de medição da fila ao array QueueMeasurements para o ID de correlação dado.

calculateQueuedTime(number, number)

Calcula a diferença entre a hora atual e a hora em que a função foi colocada na fila. Nota: É possível ter 0 como tempo de fila se o tempo atual e o tempo de espera forem iguais.

discardMeasurements(string)

Remove medições e dados auxiliares para um dado id de correlação.

emitEvents(PerformanceEvent[], string)

Emite eventos para todos os callbacks registados.

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Deixa de medir o desempenho de uma operação. Deve ser chamada diretamente apenas pelas classes PerformanceClient, pois os consumidores devem usar a função devolvida por startMeasurement. Adiciona um novo campo chamado "[nome do evento]DurationMs" para submedições, completa e emite um evento caso contrário.

generateId()

Gera e devolve um id único, tipicamente um guid.

getPreQueueTime(string, string)

Obtém o mapa dos tempos de pré-fila por correlação Id

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

Contadores de incremento a serem emitidos quando as medições são lavadas

removePerformanceCallback(string)

Remove um callback registado com o addPerformanceCallback.

setPreQueueTime(PerformanceEvents, string)

Define o tempo de pré-fila por correlação Id

startMeasurement(string, string)

Começa a medir o desempenho de uma determinada operação. Devolve uma função que deve ser usada para terminar a medição.

startPerformanceMeasurement(string, string)

Inicia e retorna uma implementação específica da plataforma do IPerformanceMeasurement. Nota: esta função pode ser alterada para abstraída na próxima grande atualização da versão.

Detalhes do Construtor

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

Cria uma instância do PerformanceClient, uma classe abstrata que contém lógica central de telemetria de desempenho.

new PerformanceClient(clientId: string, authority: string, logger: Logger, libraryName: string, libraryVersion: string, applicationTelemetry: ApplicationTelemetry, intFields?: Set<string>, abbreviations?: Map<string, string>)

Parâmetros

clientId

string

ID do cliente da aplicação

authority

string

Autoridade utilizada pela candidatura

logger
Logger

Logger utilizado pela aplicação

libraryName

string

Nome da biblioteca

libraryVersion

string

Versão da biblioteca

applicationTelemetry
ApplicationTelemetry

Nome e versão da aplicação

intFields

Set<string>

Corpos inteiros a truncar

abbreviations

Map<string, string>

Abreviaturas dos nomes dos eventos

Detalhes de Método

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

Poupa informação extra quando as medições são limpas

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

Parâmetros

fields

{[key: string]: {} | undefined}

correlationId

string

addPerformanceCallback(PerformanceCallbackFunction)

Regista uma função de callback para receber eventos de performance.

function addPerformanceCallback(callback: PerformanceCallbackFunction): string

Parâmetros

Devoluções

string

addQueueMeasurement(string, string, number, boolean)

Adiciona tempo de medição da fila ao array QueueMeasurements para o ID de correlação dado.

function addQueueMeasurement(eventName: string, correlationId?: string, queueTime?: number, manuallyCompleted?: boolean)

Parâmetros

eventName

string

correlationId

string

queueTime

number

manuallyCompleted

boolean

indicador para medições de fila preencaminhadas manualmente

calculateQueuedTime(number, number)

Calcula a diferença entre a hora atual e a hora em que a função foi colocada na fila. Nota: É possível ter 0 como tempo de fila se o tempo atual e o tempo de espera forem iguais.

function calculateQueuedTime(preQueueTime: number, currentTime: number): number

Parâmetros

preQueueTime

number

currentTime

number

Devoluções

number

discardMeasurements(string)

Remove medições e dados auxiliares para um dado id de correlação.

function discardMeasurements(correlationId: string)

Parâmetros

correlationId

string

emitEvents(PerformanceEvent[], string)

Emite eventos para todos os callbacks registados.

function emitEvents(events: PerformanceEvent[], correlationId?: string)

Parâmetros

events

PerformanceEvent[]

correlationId

string

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Deixa de medir o desempenho de uma operação. Deve ser chamada diretamente apenas pelas classes PerformanceClient, pois os consumidores devem usar a função devolvida por startMeasurement. Adiciona um novo campo chamado "[nome do evento]DurationMs" para submedições, completa e emite um evento caso contrário.

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

Parâmetros

error

unknown

account
AccountInfo

Devoluções

generateId()

Gera e devolve um id único, tipicamente um guid.

function generateId(): string

Devoluções

string

getPreQueueTime(string, string)

Obtém o mapa dos tempos de pré-fila por correlação Id

function getPreQueueTime(eventName: string, correlationId: string): number | void

Parâmetros

eventName

string

correlationId

string

Devoluções

number | void

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

Contadores de incremento a serem emitidos quando as medições são lavadas

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

Parâmetros

fields

{[key: string]: number | undefined}

{string[]}

correlationId

string

{string} identificador de correlação

removePerformanceCallback(string)

Remove um callback registado com o addPerformanceCallback.

function removePerformanceCallback(callbackId: string): boolean

Parâmetros

callbackId

string

Devoluções

boolean

setPreQueueTime(PerformanceEvents, string)

Define o tempo de pré-fila por correlação Id

function setPreQueueTime(eventName: PerformanceEvents, correlationId?: string)

Parâmetros

eventName
PerformanceEvents
correlationId

string

startMeasurement(string, string)

Começa a medir o desempenho de uma determinada operação. Devolve uma função que deve ser usada para terminar a medição.

function startMeasurement(measureName: string, correlationId?: string): InProgressPerformanceEvent

Parâmetros

measureName

string

correlationId

string

Devoluções

startPerformanceMeasurement(string, string)

Aviso

Esta API foi preterida.

This method will be removed in the next major version

Inicia e retorna uma implementação específica da plataforma do IPerformanceMeasurement. Nota: esta função pode ser alterada para abstraída na próxima grande atualização da versão.

function startPerformanceMeasurement(measureName: string, correlationId: string): IPerformanceMeasurement

Parâmetros

measureName

string

correlationId

string

Devoluções