PerformanceClient class
Constructores
| Performance |
Crea una instancia de PerformanceClient, una clase abstracta que contiene la lógica de telemetría de rendimiento principal. |
Métodos
| add |
Guarda información adicional que se va a emitir cuando se vacían las medidas. |
| add |
Registra una función de devolución de llamada para recibir eventos de rendimiento. |
| add |
Agrega el tiempo de medición de cola a la matriz QueueMeasurements para el identificador de correlación especificado. |
| calculate |
Calcula la diferencia entre la hora actual y la hora en que se puso en cola la función. Nota: Es posible tener 0 como tiempo de cola si la hora actual y la hora en cola eran iguales. |
| discard |
Quita las medidas y los datos auxiliares de un identificador de correlación determinado. |
| emit |
Emite eventos a todas las devoluciones de llamada registradas. |
| end |
Detiene la medición del rendimiento de una operación. Las clases PerformanceClient solo deben llamarlas directamente, ya que los consumidores deben usar la función devuelta por startMeasurement. Agrega un nuevo campo denominado "[nombre de evento]DurationMs" para las subtareas, completa y emite un evento de lo contrario. |
| generate |
Genera y devuelve un identificador único, normalmente un guid. |
| get |
Obtiene el mapa de los tiempos previos a la cola por identificador de correlación. |
| increment |
Contadores de incremento que se van a emitir cuando se vacían las medidas |
| remove |
Quita una devolución de llamada registrada con addPerformanceCallback. |
| set |
Establece el tiempo previo a la cola por identificador de correlación |
| start |
Comienza a medir el rendimiento de una operación determinada. Devuelve una función que se debe usar para finalizar la medida. |
| start |
Inicia y devuelve una implementación específica de la plataforma de IPerformanceMeasurement. Nota: esta función se puede cambiar para que se abstraa en el siguiente salto de versión principal. |
Detalles del constructor
PerformanceClient(string, string, Logger, string, string, ApplicationTelemetry, Set<string>, Map<string, string>)
Crea una instancia de PerformanceClient, una clase abstracta que contiene la lógica de telemetría de rendimiento principal.
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. de cliente de la aplicación
- authority
-
string
Autoridad usada por la aplicación
- logger
- Logger
Registrador usado por la aplicación
- libraryName
-
string
Nombre de la biblioteca
- libraryVersion
-
string
Versión de la biblioteca
- applicationTelemetry
- ApplicationTelemetry
nombre y versión de la aplicación
- intFields
-
Set<string>
campos enteros que se van a truncar
- abbreviations
-
Map<string, string>
abreviaturas de nombre de evento
Detalles del método
addFields({[key: string]: {} | undefined}, string)
Guarda información adicional que se va a emitir cuando se vacían las medidas.
function addFields(fields: {[key: string]: {} | undefined}, correlationId: string)
Parámetros
- fields
-
{[key: string]: {} | undefined}
- correlationId
-
string
addPerformanceCallback(PerformanceCallbackFunction)
Registra una función de devolución de llamada para recibir eventos de rendimiento.
function addPerformanceCallback(callback: PerformanceCallbackFunction): string
Parámetros
- callback
- PerformanceCallbackFunction
Devoluciones
string
addQueueMeasurement(string, string, number, boolean)
Agrega el tiempo de medición de cola a la matriz QueueMeasurements para el identificador de correlación especificado.
function addQueueMeasurement(eventName: string, correlationId?: string, queueTime?: number, manuallyCompleted?: boolean)
Parámetros
- eventName
-
string
- correlationId
-
string
- queueTime
-
number
- manuallyCompleted
-
boolean
indicador de medidas de cola completadas manualmente
calculateQueuedTime(number, number)
Calcula la diferencia entre la hora actual y la hora en que se puso en cola la función. Nota: Es posible tener 0 como tiempo de cola si la hora actual y la hora en cola eran iguales.
function calculateQueuedTime(preQueueTime: number, currentTime: number): number
Parámetros
- preQueueTime
-
number
- currentTime
-
number
Devoluciones
number
discardMeasurements(string)
Quita las medidas y los datos auxiliares de un identificador de correlación determinado.
function discardMeasurements(correlationId: string)
Parámetros
- correlationId
-
string
emitEvents(PerformanceEvent[], string)
Emite eventos a todas las devoluciones de llamada registradas.
function emitEvents(events: PerformanceEvent[], correlationId?: string)
Parámetros
- events
- correlationId
-
string
endMeasurement(PerformanceEvent, unknown, AccountInfo)
Detiene la medición del rendimiento de una operación. Las clases PerformanceClient solo deben llamarlas directamente, ya que los consumidores deben usar la función devuelta por startMeasurement. Agrega un nuevo campo denominado "[nombre de evento]DurationMs" para las subtareas, completa y emite un evento de lo contrario.
function endMeasurement(event: PerformanceEvent, error?: unknown, account?: AccountInfo): null | PerformanceEvent
Parámetros
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Devoluciones
null | PerformanceEvent
generateId()
Genera y devuelve un identificador único, normalmente un guid.
function generateId(): string
Devoluciones
string
getPreQueueTime(string, string)
Obtiene el mapa de los tiempos previos a la cola por identificador de correlación.
function getPreQueueTime(eventName: string, correlationId: string): number | void
Parámetros
- eventName
-
string
- correlationId
-
string
Devoluciones
number | void
incrementFields({[key: string]: number | undefined}, string)
Contadores de incremento que se van a emitir cuando se vacían las medidas
function incrementFields(fields: {[key: string]: number | undefined}, correlationId: string)
Parámetros
- fields
-
{[key: string]: number | undefined}
{string[]}
- correlationId
-
string
Identificador de correlación de {string}
removePerformanceCallback(string)
Quita una devolución de llamada registrada con addPerformanceCallback.
function removePerformanceCallback(callbackId: string): boolean
Parámetros
- callbackId
-
string
Devoluciones
boolean
setPreQueueTime(PerformanceEvents, string)
Establece el tiempo previo a la cola por identificador de correlación
function setPreQueueTime(eventName: PerformanceEvents, correlationId?: string)
Parámetros
- eventName
- PerformanceEvents
- correlationId
-
string
startMeasurement(string, string)
Comienza a medir el rendimiento de una operación determinada. Devuelve una función que se debe usar para finalizar la medida.
function startMeasurement(measureName: string, correlationId?: string): InProgressPerformanceEvent
Parámetros
- measureName
-
string
- correlationId
-
string
Devoluciones
startPerformanceMeasurement(string, string)
Advertencia
Esta API ya está en desuso.
This method will be removed in the next major version
Inicia y devuelve una implementación específica de la plataforma de IPerformanceMeasurement. Nota: esta función se puede cambiar para que se abstraa en el siguiente salto de versión principal.
function startPerformanceMeasurement(measureName: string, correlationId: string): IPerformanceMeasurement
Parámetros
- measureName
-
string
- correlationId
-
string