X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futils%2FPerformanceStatistics.ts;h=02b2854e185d7bc794cb4ba5184908366e19141e;hb=b652b0c3a8be2600bd603a7744141088de97b666;hp=0c68fa73027b1169886394abc191a7fc2e73723f;hpb=9fbc92f7bbead3a303a2a5718d65b0ffd545e24d;p=e-mobility-charging-stations-simulator.git diff --git a/src/utils/PerformanceStatistics.ts b/src/utils/PerformanceStatistics.ts index 0c68fa73..02b2854e 100644 --- a/src/utils/PerformanceStatistics.ts +++ b/src/utils/PerformanceStatistics.ts @@ -1,54 +1,73 @@ +// Partial Copyright Jerome Benoit. 2021. All Rights Reserved. + import { CircularArray, DEFAULT_CIRCULAR_ARRAY_SIZE } from './CircularArray'; -import CommandStatistics, { CommandStatisticsData, PerfEntry } from '../types/CommandStatistics'; import { IncomingRequestCommand, RequestCommand } from '../types/ocpp/Requests'; +import { PerformanceEntry, PerformanceObserver, performance } from 'perf_hooks'; +import Statistics, { StatisticsData } from '../types/Statistics'; import Configuration from './Configuration'; import { MessageType } from '../types/ocpp/MessageType'; -import { PerformanceEntry } from 'perf_hooks'; +import { Storage } from './performance-storage/Storage'; +import { StorageFactory } from './performance-storage/StorageFactory'; import Utils from './Utils'; import logger from './Logger'; export default class PerformanceStatistics { + private static storage: Storage; private objId: string; - private commandsStatistics: CommandStatistics; + private performanceObserver: PerformanceObserver; + private statistics: Statistics; + private displayInterval: NodeJS.Timeout; public constructor(objId: string) { this.objId = objId; - this.commandsStatistics = { id: this.objId ? this.objId : 'Object id not specified', commandsStatisticsData: {} }; + this.initializePerformanceObserver(); + this.statistics = { id: this.objId ?? 'Object id not specified', createdAt: new Date(), statisticsData: {} }; + } + + public static beginMeasure(id: string): string { + const beginId = 'begin' + id.charAt(0).toUpperCase() + id.slice(1); + performance.mark(beginId); + return beginId; } - public addMessage(command: RequestCommand | IncomingRequestCommand, messageType: MessageType): void { + public static endMeasure(name: string, beginId: string): void { + performance.measure(name, beginId); + performance.clearMarks(beginId); + } + + public addRequestStatistic(command: RequestCommand | IncomingRequestCommand, messageType: MessageType): void { switch (messageType) { case MessageType.CALL_MESSAGE: - if (this.commandsStatistics.commandsStatisticsData[command] && this.commandsStatistics.commandsStatisticsData[command].countRequest) { - this.commandsStatistics.commandsStatisticsData[command].countRequest++; + if (this.statistics.statisticsData[command] && this.statistics.statisticsData[command].countRequest) { + this.statistics.statisticsData[command].countRequest++; } else { - this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData; - this.commandsStatistics.commandsStatisticsData[command].countRequest = 1; + this.statistics.statisticsData[command] = {} as StatisticsData; + this.statistics.statisticsData[command].countRequest = 1; } break; case MessageType.CALL_RESULT_MESSAGE: - if (this.commandsStatistics.commandsStatisticsData[command]) { - if (this.commandsStatistics.commandsStatisticsData[command].countResponse) { - this.commandsStatistics.commandsStatisticsData[command].countResponse++; + if (this.statistics.statisticsData[command]) { + if (this.statistics.statisticsData[command].countResponse) { + this.statistics.statisticsData[command].countResponse++; } else { - this.commandsStatistics.commandsStatisticsData[command].countResponse = 1; + this.statistics.statisticsData[command].countResponse = 1; } } else { - this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData; - this.commandsStatistics.commandsStatisticsData[command].countResponse = 1; + this.statistics.statisticsData[command] = {} as StatisticsData; + this.statistics.statisticsData[command].countResponse = 1; } break; case MessageType.CALL_ERROR_MESSAGE: - if (this.commandsStatistics.commandsStatisticsData[command]) { - if (this.commandsStatistics.commandsStatisticsData[command].countError) { - this.commandsStatistics.commandsStatisticsData[command].countError++; + if (this.statistics.statisticsData[command]) { + if (this.statistics.statisticsData[command].countError) { + this.statistics.statisticsData[command].countError++; } else { - this.commandsStatistics.commandsStatisticsData[command].countError = 1; + this.statistics.statisticsData[command].countError = 1; } } else { - this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData; - this.commandsStatistics.commandsStatisticsData[command].countError = 1; + this.statistics.statisticsData[command] = {} as StatisticsData; + this.statistics.statisticsData[command].countError = 1; } break; default: @@ -57,31 +76,46 @@ export default class PerformanceStatistics { } } - public logPerformance(entry: PerformanceEntry, className: string): void { - this.addPerformanceTimer(entry.name as RequestCommand | IncomingRequestCommand, entry.duration); - const perfEntry: PerfEntry = { - name: entry.name, - entryType: entry.entryType, - startTime: entry.startTime, - duration: entry.duration - } ; - logger.info(`${this.logPrefix()} ${className} method(s) entry: %j`, perfEntry); + public start(): void { + this.startLogStatisticsInterval(); + if (Configuration.getPerformanceStorage().enabled) { + logger.info(`${this.logPrefix()} storage enabled: type ${Configuration.getPerformanceStorage().type}, URI: ${Configuration.getPerformanceStorage().URI}`); + } + } + + public stop(): void { + if (this.displayInterval) { + clearInterval(this.displayInterval); + } + performance.clearMarks(); + this.performanceObserver?.disconnect(); } - public start(): void { - this.displayInterval(); + public restart(): void { + this.stop(); + this.start(); + } + + private initializePerformanceObserver(): void { + this.performanceObserver = new PerformanceObserver((list) => { + this.addPerformanceEntryToStatistics(list.getEntries()[0]); + logger.debug(`${this.logPrefix()} '${list.getEntries()[0].name}' performance entry: %j`, list.getEntries()[0]); + }); + this.performanceObserver.observe({ entryTypes: ['measure'] }); } - private display(): void { - logger.info(this.logPrefix() + ' %j', this.commandsStatistics); + private logStatistics(): void { + logger.info(this.logPrefix() + ' %j', this.statistics); } - private displayInterval(): void { - if (Configuration.getStatisticsDisplayInterval() > 0) { - setInterval(() => { - this.display(); - }, Configuration.getStatisticsDisplayInterval() * 1000); - logger.info(this.logPrefix() + ' displayed every ' + Utils.secondsToHHMMSS(Configuration.getStatisticsDisplayInterval())); + private startLogStatisticsInterval(): void { + if (Configuration.getLogStatisticsInterval() > 0) { + this.displayInterval = setInterval(() => { + this.logStatistics(); + }, Configuration.getLogStatisticsInterval() * 1000); + logger.info(this.logPrefix() + ' logged every ' + Utils.secondsToHHMMSS(Configuration.getLogStatisticsInterval())); + } else { + logger.info(this.logPrefix() + ' log interval is set to ' + Configuration.getLogStatisticsInterval().toString() + '. Not logging statistics'); } } @@ -89,7 +123,7 @@ export default class PerformanceStatistics { if (Array.isArray(dataSet) && dataSet.length === 1) { return dataSet[0]; } - const sortedDataSet = dataSet.slice().sort(); + const sortedDataSet = dataSet.slice().sort((a, b) => (a - b)); const middleIndex = Math.floor(sortedDataSet.length / 2); if (sortedDataSet.length % 2) { return sortedDataSet[middleIndex / 2]; @@ -97,6 +131,28 @@ export default class PerformanceStatistics { return (sortedDataSet[(middleIndex - 1)] + sortedDataSet[middleIndex]) / 2; } + // TODO: use order statistics tree https://en.wikipedia.org/wiki/Order_statistic_tree + private percentile(dataSet: number[], percentile: number): number { + if (percentile < 0 && percentile > 100) { + throw new RangeError('Percentile is not between 0 and 100'); + } + if (Utils.isEmptyArray(dataSet)) { + return 0; + } + const sortedDataSet = dataSet.slice().sort((a, b) => (a - b)); + if (percentile === 0) { + return sortedDataSet[0]; + } + if (percentile === 100) { + return sortedDataSet[sortedDataSet.length - 1]; + } + const percentileIndex = ((percentile / 100) * sortedDataSet.length) - 1; + if (Number.isInteger(percentileIndex)) { + return (sortedDataSet[percentileIndex] + sortedDataSet[percentileIndex + 1]) / 2; + } + return sortedDataSet[Math.round(percentileIndex)]; + } + private stdDeviation(dataSet: number[]): number { let totalDataSet = 0; for (const data of dataSet) { @@ -111,33 +167,42 @@ export default class PerformanceStatistics { return Math.sqrt(totalGeometricDeviation / dataSet.length); } - private addPerformanceTimer(command: RequestCommand | IncomingRequestCommand, duration: number): void { - // Map to proper command name - const MAP_COMMAND = { - sendMeterValues: RequestCommand.METER_VALUES, - startTransaction: RequestCommand.START_TRANSACTION, - stopTransaction: RequestCommand.STOP_TRANSACTION, - }; - if (MAP_COMMAND[command]) { - command = MAP_COMMAND[command] as RequestCommand | IncomingRequestCommand; + private addPerformanceEntryToStatistics(entry: PerformanceEntry): void { + let entryName = entry.name; + // Rename entry name + const MAP_NAME: Record = {}; + if (MAP_NAME[entryName]) { + entryName = MAP_NAME[entryName]; } // Initialize command statistics - if (!this.commandsStatistics.commandsStatisticsData[command]) { - this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData; + if (!this.statistics.statisticsData[entryName]) { + this.statistics.statisticsData[entryName] = {} as StatisticsData; + } + // Update current statistics + this.statistics.lastUpdatedAt = new Date(); + this.statistics.statisticsData[entryName].countTimeMeasurement = this.statistics.statisticsData[entryName].countTimeMeasurement ? this.statistics.statisticsData[entryName].countTimeMeasurement + 1 : 1; + this.statistics.statisticsData[entryName].currentTimeMeasurement = entry.duration; + this.statistics.statisticsData[entryName].minTimeMeasurement = this.statistics.statisticsData[entryName].minTimeMeasurement ? (this.statistics.statisticsData[entryName].minTimeMeasurement > entry.duration ? entry.duration : this.statistics.statisticsData[entryName].minTimeMeasurement) : entry.duration; + this.statistics.statisticsData[entryName].maxTimeMeasurement = this.statistics.statisticsData[entryName].maxTimeMeasurement ? (this.statistics.statisticsData[entryName].maxTimeMeasurement < entry.duration ? entry.duration : this.statistics.statisticsData[entryName].maxTimeMeasurement) : entry.duration; + this.statistics.statisticsData[entryName].totalTimeMeasurement = this.statistics.statisticsData[entryName].totalTimeMeasurement ? this.statistics.statisticsData[entryName].totalTimeMeasurement + entry.duration : entry.duration; + this.statistics.statisticsData[entryName].avgTimeMeasurement = this.statistics.statisticsData[entryName].totalTimeMeasurement / this.statistics.statisticsData[entryName].countTimeMeasurement; + Array.isArray(this.statistics.statisticsData[entryName].timeMeasurementSeries) ? this.statistics.statisticsData[entryName].timeMeasurementSeries.push(entry.duration) : this.statistics.statisticsData[entryName].timeMeasurementSeries = new CircularArray(DEFAULT_CIRCULAR_ARRAY_SIZE, entry.duration); + this.statistics.statisticsData[entryName].medTimeMeasurement = this.median(this.statistics.statisticsData[entryName].timeMeasurementSeries); + this.statistics.statisticsData[entryName].ninetyFiveThPercentileTimeMeasurement = this.percentile(this.statistics.statisticsData[entryName].timeMeasurementSeries, 95); + this.statistics.statisticsData[entryName].stdDevTimeMeasurement = this.stdDeviation(this.statistics.statisticsData[entryName].timeMeasurementSeries); + if (Configuration.getPerformanceStorage().enabled) { + this.getStorage().storePerformanceStatistics(this.statistics); } - // Update current statistics timers - this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement ? this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement + 1 : 1; - this.commandsStatistics.commandsStatisticsData[command].currentTimeMeasurement = duration; - this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement ? (this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement > duration ? duration : this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement) : duration; - this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement ? (this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement < duration ? duration : this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement) : duration; - this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement ? this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement + duration : duration; - this.commandsStatistics.commandsStatisticsData[command].avgTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement / this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement; - Array.isArray(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries) ? this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries.push(duration) : this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries = new CircularArray(DEFAULT_CIRCULAR_ARRAY_SIZE, duration); - this.commandsStatistics.commandsStatisticsData[command].medTimeMeasurement = this.median(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries); - this.commandsStatistics.commandsStatisticsData[command].stdDevTimeMeasurement = this.stdDeviation(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries); } private logPrefix(): string { return Utils.logPrefix(` ${this.objId} | Performance statistics`); } + + private getStorage(): Storage { + if (!PerformanceStatistics.storage) { + PerformanceStatistics.storage = StorageFactory.getStorage(Configuration.getPerformanceStorage().type ,Configuration.getPerformanceStorage().URI, this.logPrefix()); + } + return PerformanceStatistics.storage; + } }