PerformanceClient class
Construtores
| Performance |
Cria uma instância do PerformanceClient, uma classe abstrata que contém lógica central de telemetria de desempenho. |
Métodos
| add |
Poupa informação extra quando as medições são limpas |
| add |
Regista uma função de callback para receber eventos de performance. |
| add |
Adiciona tempo de medição da fila ao array QueueMeasurements para o ID de correlação dado. |
| calculate |
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. |
| discard |
Remove medições e dados auxiliares para um dado id de correlação. |
| emit |
Emite eventos para todos os callbacks registados. |
| end |
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. |
| generate |
Gera e devolve um id único, tipicamente um guid. |
| get |
Obtém o mapa dos tempos de pré-fila por correlação Id |
| increment |
Contadores de incremento a serem emitidos quando as medições são lavadas |
| remove |
Remove um callback registado com o addPerformanceCallback. |
| set |
Define o tempo de pré-fila por correlação Id |
| start |
Começa a medir o desempenho de uma determinada operação. Devolve uma função que deve ser usada para terminar a medição. |
| start |
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
- callback
- PerformanceCallbackFunction
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
- 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
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Devoluções
null | PerformanceEvent
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