PerformanceClient class

Konstruktoren

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.

Methoden

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

Speichert zusätzliche Informationen, die ausgegeben werden sollen, wenn die Maße geleert werden

addPerformanceCallback(PerformanceCallbackFunction)

Registriert eine Rückruffunktion, um Leistungsereignisse zu empfangen.

addQueueMeasurement(string, string, number, boolean)

Fügt dem QueueMeasurements-Array für die angegebene Korrelations-ID Die Warteschlangenmesszeit hinzu.

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.

discardMeasurements(string)

Entfernt Maße und Aux-Daten für eine bestimmte Korrelations-ID.

emitEvents(PerformanceEvent[], string)

Gibt Ereignisse an alle registrierten Rückrufe aus.

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.

generateId()

Generiert und gibt eine eindeutige ID zurück, in der Regel eine GUID.

getPreQueueTime(string, string)

Ruft die Zuordnung von Vorwarteschlangenzeiten nach Korrelations-ID ab.

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

Inkrementzähler, die ausgegeben werden sollen, wenn die Maße geleert werden

removePerformanceCallback(string)

Entfernt einen mit addPerformanceCallback registrierten Rückruf.

setPreQueueTime(PerformanceEvents, string)

Legt die Zeit vor der Warteschlange nach Korrelations-ID fest.

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.

startPerformanceMeasurement(string, string)

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

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

PerformanceEvent[]

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

error

unknown

account
AccountInfo

Gibt zurück

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

Gibt zurück