PerformanceClient class

Costruttori

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

Crea un'istanza di PerformanceClient, una classe astratta contenente la logica di telemetria delle prestazioni di base.

Metodi

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

Salva informazioni aggiuntive da generare quando le misurazioni vengono scaricate

addPerformanceCallback(PerformanceCallbackFunction)

Registra una funzione di callback per ricevere eventi di prestazioni.

addQueueMeasurement(string, string, number, boolean)

Aggiunge il tempo di misurazione della coda alla matrice QueueMeasurements per l'ID di correlazione specificato.

calculateQueuedTime(number, number)

Calcola la differenza tra l'ora corrente e l'ora in cui è stata accodata la funzione. Nota: è possibile avere 0 come ora della coda se l'ora corrente e l'ora in coda erano uguali.

discardMeasurements(string)

Rimuove le misurazioni e i dati dell'esperienza utente per un ID di correlazione specificato.

emitEvents(PerformanceEvent[], string)

Genera eventi a tutti i callback registrati.

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Interrompe la misurazione delle prestazioni per un'operazione. Deve essere chiamato direttamente dalle classi PerformanceClient, perché i consumer devono usare invece la funzione restituita da startMeasurement. Aggiunge un nuovo campo denominato "[nome evento]DurationMs" per le misurazioni secondarie, completa e genera un evento in caso contrario.

generateId()

Genera e restituisce un ID univoco, in genere un GUID.

getPreQueueTime(string, string)

Ottiene la mappa dei tempi di pre-coda in base all'ID di correlazione

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

Contatori di incremento da generare quando le misurazioni vengono scaricate

removePerformanceCallback(string)

Rimuove un callback registrato con addPerformanceCallback.

setPreQueueTime(PerformanceEvents, string)

Imposta il tempo di pre-coda in base all'ID correlazione

startMeasurement(string, string)

Avvia la misurazione delle prestazioni per una determinata operazione. Restituisce una funzione che deve essere utilizzata per terminare la misurazione.

startPerformanceMeasurement(string, string)

Avvia e restituisce un'implementazione specifica della piattaforma di IPerformanceMeasurement. Nota: questa funzione può essere modificata in modo da astrarre al successivo urto della versione principale.

Dettagli costruttore

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

Crea un'istanza di PerformanceClient, una classe astratta contenente la logica di telemetria delle prestazioni di base.

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

Parametri

clientId

string

ID client dell'applicazione

authority

string

Autorità usata dall'applicazione

logger
Logger

Logger usato dall'applicazione

libraryName

string

Nome della libreria

libraryVersion

string

Versione della libreria

applicationTelemetry
ApplicationTelemetry

nome e versione dell'applicazione

intFields

Set<string>

campi integer da troncare

abbreviations

Map<string, string>

abbreviazioni dei nomi degli eventi

Dettagli metodo

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

Salva informazioni aggiuntive da generare quando le misurazioni vengono scaricate

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

Parametri

fields

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

correlationId

string

addPerformanceCallback(PerformanceCallbackFunction)

Registra una funzione di callback per ricevere eventi di prestazioni.

function addPerformanceCallback(callback: PerformanceCallbackFunction): string

Parametri

Valori restituiti

string

addQueueMeasurement(string, string, number, boolean)

Aggiunge il tempo di misurazione della coda alla matrice QueueMeasurements per l'ID di correlazione specificato.

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

Parametri

eventName

string

correlationId

string

queueTime

number

manuallyCompleted

boolean

indicatore per le misurazioni della coda completate manualmente

calculateQueuedTime(number, number)

Calcola la differenza tra l'ora corrente e l'ora in cui è stata accodata la funzione. Nota: è possibile avere 0 come ora della coda se l'ora corrente e l'ora in coda erano uguali.

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

Parametri

preQueueTime

number

currentTime

number

Valori restituiti

number

discardMeasurements(string)

Rimuove le misurazioni e i dati dell'esperienza utente per un ID di correlazione specificato.

function discardMeasurements(correlationId: string)

Parametri

correlationId

string

emitEvents(PerformanceEvent[], string)

Genera eventi a tutti i callback registrati.

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

Parametri

events

PerformanceEvent[]

correlationId

string

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Interrompe la misurazione delle prestazioni per un'operazione. Deve essere chiamato direttamente dalle classi PerformanceClient, perché i consumer devono usare invece la funzione restituita da startMeasurement. Aggiunge un nuovo campo denominato "[nome evento]DurationMs" per le misurazioni secondarie, completa e genera un evento in caso contrario.

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

Parametri

error

unknown

account
AccountInfo

Valori restituiti

generateId()

Genera e restituisce un ID univoco, in genere un GUID.

function generateId(): string

Valori restituiti

string

getPreQueueTime(string, string)

Ottiene la mappa dei tempi di pre-coda in base all'ID di correlazione

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

Parametri

eventName

string

correlationId

string

Valori restituiti

number | void

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

Contatori di incremento da generare quando le misurazioni vengono scaricate

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

Parametri

fields

{[key: string]: number | undefined}

{string[]}

correlationId

string

Identificatore di correlazione {string}

removePerformanceCallback(string)

Rimuove un callback registrato con addPerformanceCallback.

function removePerformanceCallback(callbackId: string): boolean

Parametri

callbackId

string

Valori restituiti

boolean

setPreQueueTime(PerformanceEvents, string)

Imposta il tempo di pre-coda in base all'ID correlazione

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

Parametri

eventName
PerformanceEvents
correlationId

string

startMeasurement(string, string)

Avvia la misurazione delle prestazioni per una determinata operazione. Restituisce una funzione che deve essere utilizzata per terminare la misurazione.

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

Parametri

measureName

string

correlationId

string

Valori restituiti

startPerformanceMeasurement(string, string)

Avviso

Questa API è ora deprecata.

This method will be removed in the next major version

Avvia e restituisce un'implementazione specifica della piattaforma di IPerformanceMeasurement. Nota: questa funzione può essere modificata in modo da astrarre al successivo urto della versione principale.

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

Parametri

measureName

string

correlationId

string

Valori restituiti