Adding or removing a sensor from an existing automated configuration

IBM Spectrum Scale™ version 4.2.2 has two new sensors: GPFSPool and GPFSFileset for the pmsensor service. If an older version of the IBM Spectrum Scale performance monitoring system is upgraded, these sensors are not automatically enabled. This is because automatically enabling the sensors might cause the collectors to consume more main memory than what was set aside for monitoring. Changing the memory footprint of the collector database might cause issues for the users if the collectors are tightly configured.

The performance monitoring system can be configured manually or through an automated process. To add a set of sensors for an automatic configuration, generate a file containing the sensors and the configuration parameters to be used. The following example shows a file /tmp/new-pmsensors.conf that is used to add a new sensor GPFSPool that is not activated yet (period=0), and another sensor GPFSFileset whose metrics are reported every 10 seconds (period=10):

/tmp/new-pmsensors.conf:

sensors = {
        name = "GPFSPool"
        period = 0
}, {
	name = "GPFSFileset"
	period = 10
}

After creating this file, run the mmperfmon command to add these sensors to the configuration:

prompt# mmperfmon config add --sensors /tmp/new-pmsensors.conf

Ensure that the sensors are added and listed as part of the performance monitoring configuration. If any of the sensors mentioned in the file exist already, they are mentioned in the output for the command and those sensors are ignored, and the existing sensor configuration is kept. After the sensor is added to the configuration file, its configuration settings can be updated using mmperfmon config update command.

Run the following command to delete a sensor from the configuration:

prompt# mmperfmon config delete --sensors Sensor[,Sensor...]

Note: For information on how to manually configure the performance monitoring system (file-managed configuration), see Manual configuration.