src/utils/PerformanceStatistics.ts

   1 import { CircularArray, DEFAULT_CIRCULAR_ARRAY_SIZE } from './CircularArray';
   2 import CommandStatistics, { CommandStatisticsData, PerfEntry } from '../types/CommandStatistics';
   3 import { IncomingRequestCommand, RequestCommand } from '../types/ocpp/Requests';
   4
   5 import Configuration from './Configuration';
   6 import { MessageType } from '../types/ocpp/MessageType';
   7 import { PerformanceEntry } from 'perf_hooks';
   8 import Utils from './Utils';
   9 import logger from './Logger';
  10
  11 export default class PerformanceStatistics {
  12   private objId: string;
  13   private commandsStatistics: CommandStatistics;
  14
  15   public constructor(objId: string) {
  16     this.objId = objId;
  17     this.commandsStatistics = { id: this.objId ? this.objId : 'Object id not specified', commandsStatisticsData: {} };
  18   }
  19
  20   public addMessage(command: RequestCommand | IncomingRequestCommand, messageType: MessageType): void {
  21     switch (messageType) {
  22       case MessageType.CALL_MESSAGE:
  23         if (this.commandsStatistics.commandsStatisticsData[command] && this.commandsStatistics.commandsStatisticsData[command].countRequest) {
  24           this.commandsStatistics.commandsStatisticsData[command].countRequest++;
  25         } else {
  26           this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData;
  27           this.commandsStatistics.commandsStatisticsData[command].countRequest = 1;
  28         }
  29         break;
  30       case MessageType.CALL_RESULT_MESSAGE:
  31         if (this.commandsStatistics.commandsStatisticsData[command]) {
  32           if (this.commandsStatistics.commandsStatisticsData[command].countResponse) {
  33             this.commandsStatistics.commandsStatisticsData[command].countResponse++;
  34           } else {
  35             this.commandsStatistics.commandsStatisticsData[command].countResponse = 1;
  36           }
  37         } else {
  38           this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData;
  39           this.commandsStatistics.commandsStatisticsData[command].countResponse = 1;
  40         }
  41         break;
  42       case MessageType.CALL_ERROR_MESSAGE:
  43         if (this.commandsStatistics.commandsStatisticsData[command]) {
  44           if (this.commandsStatistics.commandsStatisticsData[command].countError) {
  45             this.commandsStatistics.commandsStatisticsData[command].countError++;
  46           } else {
  47             this.commandsStatistics.commandsStatisticsData[command].countError = 1;
  48           }
  49         } else {
  50           this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData;
  51           this.commandsStatistics.commandsStatisticsData[command].countError = 1;
  52         }
  53         break;
  54       default:
  55         logger.error(`${this.logPrefix()} wrong message type ${messageType}`);
  56         break;
  57     }
  58   }
  59
  60   public logPerformance(entry: PerformanceEntry, className: string): void {
  61     this.addPerformanceTimer(entry.name as RequestCommand | IncomingRequestCommand, entry.duration);
  62     const perfEntry: PerfEntry = {} as PerfEntry;
  63     perfEntry.name = entry.name;
  64     perfEntry.entryType = entry.entryType;
  65     perfEntry.startTime = entry.startTime;
  66     perfEntry.duration = entry.duration;
  67     logger.info(`${this.logPrefix()} ${className} method(s) entry: %j`, perfEntry);
  68   }
  69
  70   public start(): void {
  71     this.displayInterval();
  72   }
  73
  74   private display(): void {
  75     logger.info(this.logPrefix() + ' %j', this.commandsStatistics);
  76   }
  77
  78   private displayInterval(): void {
  79     if (Configuration.getStatisticsDisplayInterval() > 0) {
  80       setInterval(() => {
  81         this.display();
  82       }, Configuration.getStatisticsDisplayInterval() * 1000);
  83       logger.info(this.logPrefix() + ' displayed every ' + Utils.secondsToHHMMSS(Configuration.getStatisticsDisplayInterval()));
  84     }
  85   }
  86
  87   private median(dataSet: number[]): number {
  88     if (Array.isArray(dataSet) && dataSet.length === 1) {
  89       return dataSet[0];
  90     }
  91     const sortedDataSet = dataSet.slice().sort();
  92     const middleIndex = Math.floor(sortedDataSet.length / 2);
  93     if (sortedDataSet.length % 2) {
  94       return sortedDataSet[middleIndex / 2];
  95     }
  96     return (sortedDataSet[(middleIndex - 1)] + sortedDataSet[middleIndex]) / 2;
  97   }
  98
  99   private stdDeviation(dataSet: number[]): number {
 100     let totalDataSet = 0;
 101     for (const data of dataSet) {
 102       totalDataSet += data;
 103     }
 104     const dataSetMean = totalDataSet / dataSet.length;
 105     let totalGeometricDeviation = 0;
 106     for (const data of dataSet) {
 107       const deviation = data - dataSetMean;
 108       totalGeometricDeviation += deviation * deviation;
 109     }
 110     return Math.sqrt(totalGeometricDeviation / dataSet.length);
 111   }
 112
 113   private addPerformanceTimer(command: RequestCommand | IncomingRequestCommand, duration: number): void {
 114     // Map to proper command name
 115     const MAPCOMMAND = {
 116       sendMeterValues: RequestCommand.METER_VALUES,
 117       startTransaction: RequestCommand.START_TRANSACTION,
 118       stopTransaction: RequestCommand.STOP_TRANSACTION,
 119     };
 120     if (MAPCOMMAND[command]) {
 121       command = MAPCOMMAND[command] as RequestCommand | IncomingRequestCommand;
 122     }
 123     // Initialize command statistics
 124     if (!this.commandsStatistics.commandsStatisticsData[command]) {
 125       this.commandsStatistics.commandsStatisticsData[command] = {} as CommandStatisticsData;
 126     }
 127     // Update current statistics timers
 128     this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement ? this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement + 1 : 1;
 129     this.commandsStatistics.commandsStatisticsData[command].currentTimeMeasurement = duration;
 130     this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement ? (this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement > duration ? duration : this.commandsStatistics.commandsStatisticsData[command].minTimeMeasurement) : duration;
 131     this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement ? (this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement < duration ? duration : this.commandsStatistics.commandsStatisticsData[command].maxTimeMeasurement) : duration;
 132     this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement ? this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement + duration : duration;
 133     this.commandsStatistics.commandsStatisticsData[command].avgTimeMeasurement = this.commandsStatistics.commandsStatisticsData[command].totalTimeMeasurement / this.commandsStatistics.commandsStatisticsData[command].countTimeMeasurement;
 134     Array.isArray(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries) ? this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries.push(duration) : this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries = new CircularArray<number>(DEFAULT_CIRCULAR_ARRAY_SIZE, duration);
 135     this.commandsStatistics.commandsStatisticsData[command].medTimeMeasurement = this.median(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries);
 136     this.commandsStatistics.commandsStatisticsData[command].stdDevTimeMeasurement = this.stdDeviation(this.commandsStatistics.commandsStatisticsData[command].timeMeasurementSeries);
 137   }
 138
 139   private logPrefix(): string {
 140     return Utils.logPrefix(` ${this.objId} | Performance statistics`);
 141   }
 142 }