PerformanceClient class
Konstruktoren
| Performance |
Erstellt eine Instanz von PerformanceClient, einer abstrakten Klasse, die kernige Leistungstelemetrielogik enthält. |
Methoden
| add |
Speichert zusätzliche Informationen, die ausgegeben werden sollen, wenn die Maße geleert werden |
| add |
Registriert eine Rückruffunktion, um Leistungsereignisse zu empfangen. |
| add |
Fügt dem QueueMeasurements-Array für die angegebene Korrelations-ID Die Warteschlangenmesszeit hinzu. |
| calculate |
Berechnet die Differenz zwischen der aktuellen Uhrzeit und der Uhrzeit, zu der die Funktion in die Warteschlange eingereiht wurde. Hinweis: Es ist möglich, 0 als Warteschlangenzeit zu haben, wenn die aktuelle Uhrzeit und die in die Warteschlange eingereihte Zeit identisch waren. |
| discard |
Entfernt Maße und Aux-Daten für eine bestimmte Korrelations-ID. |
| emit |
Gibt Ereignisse an alle registrierten Rückrufe aus. |
| end |
Beendet die Messung der Leistung für einen Vorgang. Sollte nur direkt von PerformanceClient-Klassen aufgerufen werden, da Consumer stattdessen die von startMeasurement zurückgegebene Funktion verwenden sollten. Fügt ein neues Feld mit dem Namen "[Ereignisname]DurationMs" für Untermessungen hinzu, schließt ein Ereignis ab und gibt es andernfalls aus. |
| generate |
Generiert und gibt eine eindeutige ID zurück, in der Regel eine GUID. |
| get |
Ruft die Zuordnung von Vorwarteschlangenzeiten nach Korrelations-ID ab. |
| increment |
Inkrementzähler, die ausgegeben werden sollen, wenn die Maße geleert werden |
| remove |
Entfernt einen mit addPerformanceCallback registrierten Rückruf. |
| set |
Legt die Zeit vor der Warteschlange nach Korrelations-ID fest. |
| start |
Beginnt mit der Messung der Leistung für einen bestimmten Vorgang. Gibt eine Funktion zurück, die zum Beenden der Messung verwendet werden soll. |
| start |
Startet und gibt eine plattformspezifische Implementierung von IPerformanceMeasurement zurück. Hinweis: Diese Funktion kann beim nächsten Hauptversionsstoß in abstrahieren geändert werden. |
Details zum Konstruktor
PerformanceClient(string, string, Logger, string, string, ApplicationTelemetry, Set<string>, Map<string, string>)
Erstellt eine Instanz von PerformanceClient, einer abstrakten Klasse, die kernige Leistungstelemetrielogik enthält.
new PerformanceClient(clientId: string, authority: string, logger: Logger, libraryName: string, libraryVersion: string, applicationTelemetry: ApplicationTelemetry, intFields?: Set<string>, abbreviations?: Map<string, string>)
Parameter
- clientId
-
string
Client-ID der Anwendung
- authority
-
string
Von der Anwendung verwendete Autorität
- logger
- Logger
Von der Anwendung verwendete Logger
- libraryName
-
string
Name der Bibliothek
- libraryVersion
-
string
Version der Bibliothek
- applicationTelemetry
- ApplicationTelemetry
Anwendungsname und -version
- intFields
-
Set<string>
Ganze Zahlenfelder, die abgeschnitten werden sollen
- abbreviations
-
Map<string, string>
Abkürzungen für Ereignisnamen
Details zur Methode
addFields({[key: string]: {} | undefined}, string)
Speichert zusätzliche Informationen, die ausgegeben werden sollen, wenn die Maße geleert werden
function addFields(fields: {[key: string]: {} | undefined}, correlationId: string)
Parameter
- fields
-
{[key: string]: {} | undefined}
- correlationId
-
string
addPerformanceCallback(PerformanceCallbackFunction)
Registriert eine Rückruffunktion, um Leistungsereignisse zu empfangen.
function addPerformanceCallback(callback: PerformanceCallbackFunction): string
Parameter
- callback
- PerformanceCallbackFunction
Gibt zurück
string
addQueueMeasurement(string, string, number, boolean)
Fügt dem QueueMeasurements-Array für die angegebene Korrelations-ID Die Warteschlangenmesszeit hinzu.
function addQueueMeasurement(eventName: string, correlationId?: string, queueTime?: number, manuallyCompleted?: boolean)
Parameter
- eventName
-
string
- correlationId
-
string
- queueTime
-
number
- manuallyCompleted
-
boolean
Indikator für manuell abgeschlossene Warteschlangenmessungen
calculateQueuedTime(number, number)
Berechnet die Differenz zwischen der aktuellen Uhrzeit und der Uhrzeit, zu der die Funktion in die Warteschlange eingereiht wurde. Hinweis: Es ist möglich, 0 als Warteschlangenzeit zu haben, wenn die aktuelle Uhrzeit und die in die Warteschlange eingereihte Zeit identisch waren.
function calculateQueuedTime(preQueueTime: number, currentTime: number): number
Parameter
- preQueueTime
-
number
- currentTime
-
number
Gibt zurück
number
discardMeasurements(string)
Entfernt Maße und Aux-Daten für eine bestimmte Korrelations-ID.
function discardMeasurements(correlationId: string)
Parameter
- correlationId
-
string
emitEvents(PerformanceEvent[], string)
Gibt Ereignisse an alle registrierten Rückrufe aus.
function emitEvents(events: PerformanceEvent[], correlationId?: string)
Parameter
- events
- correlationId
-
string
endMeasurement(PerformanceEvent, unknown, AccountInfo)
Beendet die Messung der Leistung für einen Vorgang. Sollte nur direkt von PerformanceClient-Klassen aufgerufen werden, da Consumer stattdessen die von startMeasurement zurückgegebene Funktion verwenden sollten. Fügt ein neues Feld mit dem Namen "[Ereignisname]DurationMs" für Untermessungen hinzu, schließt ein Ereignis ab und gibt es andernfalls aus.
function endMeasurement(event: PerformanceEvent, error?: unknown, account?: AccountInfo): null | PerformanceEvent
Parameter
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Gibt zurück
null | PerformanceEvent
generateId()
Generiert und gibt eine eindeutige ID zurück, in der Regel eine GUID.
function generateId(): string
Gibt zurück
string
getPreQueueTime(string, string)
Ruft die Zuordnung von Vorwarteschlangenzeiten nach Korrelations-ID ab.
function getPreQueueTime(eventName: string, correlationId: string): number | void
Parameter
- eventName
-
string
- correlationId
-
string
Gibt zurück
number | void
incrementFields({[key: string]: number | undefined}, string)
Inkrementzähler, die ausgegeben werden sollen, wenn die Maße geleert werden
function incrementFields(fields: {[key: string]: number | undefined}, correlationId: string)
Parameter
- fields
-
{[key: string]: number | undefined}
{string[]}
- correlationId
-
string
Korrelationsbezeichner für {string}
removePerformanceCallback(string)
Entfernt einen mit addPerformanceCallback registrierten Rückruf.
function removePerformanceCallback(callbackId: string): boolean
Parameter
- callbackId
-
string
Gibt zurück
boolean
setPreQueueTime(PerformanceEvents, string)
Legt die Zeit vor der Warteschlange nach Korrelations-ID fest.
function setPreQueueTime(eventName: PerformanceEvents, correlationId?: string)
Parameter
- eventName
- PerformanceEvents
- correlationId
-
string
startMeasurement(string, string)
Beginnt mit der Messung der Leistung für einen bestimmten Vorgang. Gibt eine Funktion zurück, die zum Beenden der Messung verwendet werden soll.
function startMeasurement(measureName: string, correlationId?: string): InProgressPerformanceEvent
Parameter
- measureName
-
string
- correlationId
-
string
Gibt zurück
startPerformanceMeasurement(string, string)
Warnung
Diese API ist nun veraltet.
This method will be removed in the next major version
Startet und gibt eine plattformspezifische Implementierung von IPerformanceMeasurement zurück. Hinweis: Diese Funktion kann beim nächsten Hauptversionsstoß in abstrahieren geändert werden.
function startPerformanceMeasurement(measureName: string, correlationId: string): IPerformanceMeasurement
Parameter
- measureName
-
string
- correlationId
-
string