PerformanceClient class
Costruttori
| Performance |
Crea un'istanza di PerformanceClient, una classe astratta contenente la logica di telemetria delle prestazioni di base. |
Metodi
| add |
Salva informazioni aggiuntive da generare quando le misurazioni vengono scaricate |
| add |
Registra una funzione di callback per ricevere eventi di prestazioni. |
| add |
Aggiunge il tempo di misurazione della coda alla matrice QueueMeasurements per l'ID di correlazione specificato. |
| calculate |
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. |
| discard |
Rimuove le misurazioni e i dati dell'esperienza utente per un ID di correlazione specificato. |
| emit |
Genera eventi a tutti i callback registrati. |
| end |
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. |
| generate |
Genera e restituisce un ID univoco, in genere un GUID. |
| get |
Ottiene la mappa dei tempi di pre-coda in base all'ID di correlazione |
| increment |
Contatori di incremento da generare quando le misurazioni vengono scaricate |
| remove |
Rimuove un callback registrato con addPerformanceCallback. |
| set |
Imposta il tempo di pre-coda in base all'ID correlazione |
| start |
Avvia la misurazione delle prestazioni per una determinata operazione. Restituisce una funzione che deve essere utilizzata per terminare la misurazione. |
| start |
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
- callback
- PerformanceCallbackFunction
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
- 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
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Valori restituiti
null | PerformanceEvent
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