PerformanceClient class
Konstruktorer
| Performance |
Skapar en instans av PerformanceClient, en abstrakt klass som innehåller telemetrilogik för kärnprestanda. |
Metoder
| add |
Sparar extra information som ska genereras när mätningarna töms |
| add |
Registrerar en återanropsfunktion för att ta emot prestandahändelser. |
| add |
Lägger till kömätningstid i QueueMeasurements-matrisen för angivet korrelations-ID. |
| calculate |
Beräknar skillnaden mellan aktuell tid och tid när funktionen köades. Obs! Det går att ha 0 som kötid om den aktuella tiden och den köade tiden var densamma. |
| discard |
Tar bort mått och aux-data för ett visst korrelations-ID. |
| emit |
Genererar händelser till alla registrerade återanrop. |
| end |
Stoppar mätning av prestanda för en åtgärd. Bör bara anropas direkt av PerformanceClient-klasser, eftersom konsumenterna i stället bör använda funktionen som returneras av startMeasurement. Lägger till ett nytt fält med namnet "[event name]DurationMs" för undermätningar, slutför och genererar en händelse i annat fall. |
| generate |
Genererar och returnerar ett unikt ID, vanligtvis ett guid. |
| get |
Hämtar karta över tider före kön efter korrelations-ID |
| increment |
Öka räknare som ska genereras när mätningarna töms |
| remove |
Tar bort ett återanrop som registrerats med addPerformanceCallback. |
| set |
Anger tid före kö efter korrelations-ID |
| start |
Börjar mäta prestanda för en viss åtgärd. Returnerar en funktion som ska användas för att avsluta mätningen. |
| start |
Startar och returnerar en plattformsspecifik implementering av IPerformanceMeasurement. Obs! Den här funktionen kan ändras till abstrakt vid nästa större versionsuppbubbel. |
Konstruktorinformation
PerformanceClient(string, string, Logger, string, string, ApplicationTelemetry, Set<string>, Map<string, string>)
Skapar en instans av PerformanceClient, en abstrakt klass som innehåller telemetrilogik för kärnprestanda.
new PerformanceClient(clientId: string, authority: string, logger: Logger, libraryName: string, libraryVersion: string, applicationTelemetry: ApplicationTelemetry, intFields?: Set<string>, abbreviations?: Map<string, string>)
Parametrar
- clientId
-
string
Klient-ID för programmet
- authority
-
string
Utfärdare som används av programmet
- logger
- Logger
Logger som används av programmet
- libraryName
-
string
Bibliotekets namn
- libraryVersion
-
string
Version av biblioteket
- applicationTelemetry
- ApplicationTelemetry
programnamn och version
- intFields
-
Set<string>
heltalsfält som ska trunkeras
- abbreviations
-
Map<string, string>
förkortningar för händelsenamn
Metodinformation
addFields({[key: string]: {} | undefined}, string)
Sparar extra information som ska genereras när mätningarna töms
function addFields(fields: {[key: string]: {} | undefined}, correlationId: string)
Parametrar
- fields
-
{[key: string]: {} | undefined}
- correlationId
-
string
addPerformanceCallback(PerformanceCallbackFunction)
Registrerar en återanropsfunktion för att ta emot prestandahändelser.
function addPerformanceCallback(callback: PerformanceCallbackFunction): string
Parametrar
- callback
- PerformanceCallbackFunction
Returer
string
addQueueMeasurement(string, string, number, boolean)
Lägger till kömätningstid i QueueMeasurements-matrisen för angivet korrelations-ID.
function addQueueMeasurement(eventName: string, correlationId?: string, queueTime?: number, manuallyCompleted?: boolean)
Parametrar
- eventName
-
string
- correlationId
-
string
- queueTime
-
number
- manuallyCompleted
-
boolean
indikator för manuellt slutförda kömätningar
calculateQueuedTime(number, number)
Beräknar skillnaden mellan aktuell tid och tid när funktionen köades. Obs! Det går att ha 0 som kötid om den aktuella tiden och den köade tiden var densamma.
function calculateQueuedTime(preQueueTime: number, currentTime: number): number
Parametrar
- preQueueTime
-
number
- currentTime
-
number
Returer
number
discardMeasurements(string)
Tar bort mått och aux-data för ett visst korrelations-ID.
function discardMeasurements(correlationId: string)
Parametrar
- correlationId
-
string
emitEvents(PerformanceEvent[], string)
Genererar händelser till alla registrerade återanrop.
function emitEvents(events: PerformanceEvent[], correlationId?: string)
Parametrar
- events
- correlationId
-
string
endMeasurement(PerformanceEvent, unknown, AccountInfo)
Stoppar mätning av prestanda för en åtgärd. Bör bara anropas direkt av PerformanceClient-klasser, eftersom konsumenterna i stället bör använda funktionen som returneras av startMeasurement. Lägger till ett nytt fält med namnet "[event name]DurationMs" för undermätningar, slutför och genererar en händelse i annat fall.
function endMeasurement(event: PerformanceEvent, error?: unknown, account?: AccountInfo): null | PerformanceEvent
Parametrar
- event
- PerformanceEvent
- error
-
unknown
- account
- AccountInfo
Returer
null | PerformanceEvent
generateId()
Genererar och returnerar ett unikt ID, vanligtvis ett guid.
function generateId(): string
Returer
string
getPreQueueTime(string, string)
Hämtar karta över tider före kön efter korrelations-ID
function getPreQueueTime(eventName: string, correlationId: string): number | void
Parametrar
- eventName
-
string
- correlationId
-
string
Returer
number | void
incrementFields({[key: string]: number | undefined}, string)
Öka räknare som ska genereras när mätningarna töms
function incrementFields(fields: {[key: string]: number | undefined}, correlationId: string)
Parametrar
- fields
-
{[key: string]: number | undefined}
{string[]}
- correlationId
-
string
Korrelationsidentifierare för {string}
removePerformanceCallback(string)
Tar bort ett återanrop som registrerats med addPerformanceCallback.
function removePerformanceCallback(callbackId: string): boolean
Parametrar
- callbackId
-
string
Returer
boolean
setPreQueueTime(PerformanceEvents, string)
Anger tid före kö efter korrelations-ID
function setPreQueueTime(eventName: PerformanceEvents, correlationId?: string)
Parametrar
- eventName
- PerformanceEvents
- correlationId
-
string
startMeasurement(string, string)
Börjar mäta prestanda för en viss åtgärd. Returnerar en funktion som ska användas för att avsluta mätningen.
function startMeasurement(measureName: string, correlationId?: string): InProgressPerformanceEvent
Parametrar
- measureName
-
string
- correlationId
-
string
Returer
startPerformanceMeasurement(string, string)
Varning
Det här API:et är nu inaktuellt.
This method will be removed in the next major version
Startar och returnerar en plattformsspecifik implementering av IPerformanceMeasurement. Obs! Den här funktionen kan ändras till abstrakt vid nästa större versionsuppbubbel.
function startPerformanceMeasurement(measureName: string, correlationId: string): IPerformanceMeasurement
Parametrar
- measureName
-
string
- correlationId
-
string