Performance Intervals

The PerformanceManager defines performance intervals which specify the period of time between collection events, how much data will be collected, and how long the collected data will be saved.

  • An ESXi server has a built-in performance interval that produces discrete data values from counter instances sampled every 20 seconds. The server will maintain this instance data for one hour.
  • Additional data collection is specified by historical performance intervals which produce data aggregated from counter instances according to the individual intervals.

The PerformanceManager.historicalInterval property is an array of PerfInterval objects. The following table lists the PerfInterval properties.

Property Description
samplingPeriod Number of seconds for the interval. You can modify this property on a vCenter Server only.
length Period of time for which the server will save the data that it collects. You can modify this property on a vCenter Server only.
level Level at which the Server collects data. The interval level corresponds to the performance counter level (PerfCounterInfo.level). The Server will collect data for all counters with levels that match PerfInterval.level, and for all counters with levels lower than PerfInterval.level. You can modify this property on a vCenter Server only.
enable Enable/disable performance data collection. You can modify this property on a vCenter Server only.
key Unique identifier for the interval. You cannot modify this property.
name Label for the historical interval; one of the following strings:
  • "Past Day"
  • "Past Week"
  • "Past Month"
  • "Past Year"

The PerformanceManager uses the samplingPeriod, level, and length properties to determine its collection behavior. It does not interpret the name string. You cannot modify this property.