PerformanceClient class

Constructeurs

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

Crée une instance de PerformanceClient, une classe abstraite contenant la logique de télémétrie de performances de base.

Méthodes

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

Enregistre des informations supplémentaires à émettre lorsque les mesures sont vidées

addPerformanceCallback(PerformanceCallbackFunction)

Inscrit une fonction de rappel pour recevoir des événements de performances.

addQueueMeasurement(string, string, number, boolean)

Ajoute le temps de mesure de file d’attente au tableau QueueMeasurements pour un ID de corrélation donné.

calculateQueuedTime(number, number)

Calcule la différence entre l’heure actuelle et l’heure à laquelle la fonction a été mise en file d’attente. Remarque : il est possible d’avoir 0 comme heure de file d’attente si l’heure actuelle et l’heure mise en file d’attente étaient identiques.

discardMeasurements(string)

Supprime les mesures et les données aux pour un ID de corrélation donné.

emitEvents(PerformanceEvent[], string)

Émet des événements à tous les rappels inscrits.

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Arrête de mesurer les performances d’une opération. Doit uniquement être appelé directement par les classes PerformanceClient, car les consommateurs doivent utiliser plutôt la fonction retournée par startMeasurement. Ajoute un nouveau champ nommé « [nom d’événement]DurationMs » pour les sous-mesures, termine et émet un événement dans le cas contraire.

generateId()

Génère et retourne un ID unique, généralement un guid.

getPreQueueTime(string, string)

Obtient la carte des heures de pré-file d’attente par ID de corrélation

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

Incrémenter les compteurs à émettre lorsque les mesures sont vidées

removePerformanceCallback(string)

Supprime un rappel inscrit avec addPerformanceCallback.

setPreQueueTime(PerformanceEvents, string)

Définit le temps de pré-file d’attente par ID de corrélation

startMeasurement(string, string)

Commence à mesurer les performances d’une opération donnée. Retourne une fonction qui doit être utilisée pour mettre fin à la mesure.

startPerformanceMeasurement(string, string)

Démarre et retourne une implémentation spécifique à la plateforme d’IPerformanceMeasurement. Remarque : cette fonction peut être modifiée pour être abstraite à l’étape suivante de la version principale.

Détails du constructeur

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

Crée une instance de PerformanceClient, une classe abstraite contenant la logique de télémétrie de performances de base.

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

Paramètres

clientId

string

ID client de l’application

authority

string

Autorité utilisée par l’application

logger
Logger

Enregistreur d’événements utilisé par l’application

libraryName

string

Nom de la bibliothèque

libraryVersion

string

Version de la bibliothèque

applicationTelemetry
ApplicationTelemetry

nom et version de l’application

intFields

Set<string>

champs entiers à tronquer

abbreviations

Map<string, string>

abréviations de nom d’événement

Détails de la méthode

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

Enregistre des informations supplémentaires à émettre lorsque les mesures sont vidées

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

Paramètres

fields

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

correlationId

string

addPerformanceCallback(PerformanceCallbackFunction)

Inscrit une fonction de rappel pour recevoir des événements de performances.

function addPerformanceCallback(callback: PerformanceCallbackFunction): string

Paramètres

Retours

string

addQueueMeasurement(string, string, number, boolean)

Ajoute le temps de mesure de file d’attente au tableau QueueMeasurements pour un ID de corrélation donné.

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

Paramètres

eventName

string

correlationId

string

queueTime

number

manuallyCompleted

boolean

indicateur pour les mesures de file d’attente effectuées manuellement

calculateQueuedTime(number, number)

Calcule la différence entre l’heure actuelle et l’heure à laquelle la fonction a été mise en file d’attente. Remarque : il est possible d’avoir 0 comme heure de file d’attente si l’heure actuelle et l’heure mise en file d’attente étaient identiques.

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

Paramètres

preQueueTime

number

currentTime

number

Retours

number

discardMeasurements(string)

Supprime les mesures et les données aux pour un ID de corrélation donné.

function discardMeasurements(correlationId: string)

Paramètres

correlationId

string

emitEvents(PerformanceEvent[], string)

Émet des événements à tous les rappels inscrits.

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

Paramètres

events

PerformanceEvent[]

correlationId

string

endMeasurement(PerformanceEvent, unknown, AccountInfo)

Arrête de mesurer les performances d’une opération. Doit uniquement être appelé directement par les classes PerformanceClient, car les consommateurs doivent utiliser plutôt la fonction retournée par startMeasurement. Ajoute un nouveau champ nommé « [nom d’événement]DurationMs » pour les sous-mesures, termine et émet un événement dans le cas contraire.

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

Paramètres

error

unknown

account
AccountInfo

Retours

generateId()

Génère et retourne un ID unique, généralement un guid.

function generateId(): string

Retours

string

getPreQueueTime(string, string)

Obtient la carte des heures de pré-file d’attente par ID de corrélation

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

Paramètres

eventName

string

correlationId

string

Retours

number | void

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

Incrémenter les compteurs à émettre lorsque les mesures sont vidées

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

Paramètres

fields

{[key: string]: number | undefined}

{string[]}

correlationId

string

Identificateur de corrélation {string}

removePerformanceCallback(string)

Supprime un rappel inscrit avec addPerformanceCallback.

function removePerformanceCallback(callbackId: string): boolean

Paramètres

callbackId

string

Retours

boolean

setPreQueueTime(PerformanceEvents, string)

Définit le temps de pré-file d’attente par ID de corrélation

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

Paramètres

eventName
PerformanceEvents
correlationId

string

startMeasurement(string, string)

Commence à mesurer les performances d’une opération donnée. Retourne une fonction qui doit être utilisée pour mettre fin à la mesure.

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

Paramètres

measureName

string

correlationId

string

Retours

startPerformanceMeasurement(string, string)

Avertissement

Cette API est à présent déconseillée.

This method will be removed in the next major version

Démarre et retourne une implémentation spécifique à la plateforme d’IPerformanceMeasurement. Remarque : cette fonction peut être modifiée pour être abstraite à l’étape suivante de la version principale.

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

Paramètres

measureName

string

correlationId

string

Retours