PerformanceClient class
Constructeurs
| Performance |
Crée une instance de PerformanceClient, une classe abstraite contenant la logique de télémétrie de performances de base. |
Méthodes
| add |
Enregistre des informations supplémentaires à émettre lorsque les mesures sont vidées |
| add |
Inscrit une fonction de rappel pour recevoir des événements de performances. |
| add |
Ajoute le temps de mesure de file d’attente au tableau QueueMeasurements pour un ID de corrélation donné. |
| calculate |
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. |
| discard |
Supprime les mesures et les données aux pour un ID de corrélation donné. |
| emit |
Émet des événements à tous les rappels inscrits. |
| end |
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. |
| generate |
Génère et retourne un ID unique, généralement un guid. |
| get |
Obtient la carte des heures de pré-file d’attente par ID de corrélation |
| increment |
Incrémenter les compteurs à émettre lorsque les mesures sont vidées |
| remove |
Supprime un rappel inscrit avec addPerformanceCallback. |
| set |
Définit le temps de pré-file d’attente par ID de corrélation |
| start |
Commence à mesurer les performances d’une opération donnée. Retourne une fonction qui doit être utilisée pour mettre fin à la mesure. |
| start |
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
- callback
- PerformanceCallbackFunction
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
- 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
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Retours
null | PerformanceEvent
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