Support for DCIM systems

Performance Reports includes support for Data Center Infrastructure Management (DCIM) systems.

You can output all the metrics generated by the Performance Reports to a script using the –dcim-output argument. By default, the pr-dcim script is called and the collected metrics are sent to Ganglia (a system monitoring tool).

The pr-dcim script looks for a gmetric implementation as part of the Ganglia software, and calls it as many times as there are metrics.

Customize your DCIM script

The default pr-dcim script is located in {installation-directory}/performance-reports/ganglia-connector/pr-dcim.

However, you can use your own custom script by specifying the ALLINEA_DCIM_SCRIPT environment variable.

This option is recommended if you are using a system monitoring tool other than Ganglia.

Use arguments as described below in your scripts. Each argument can be specified once per metric:

  • -V{METRIC}={VALUE} (mandatory) specifies that the metric METRIC has the value VALUE.
  • -U{METRIC}={UNITS} (optional) specifies that the metric METRIC is expressed in UNITS.
  • -T{METRIC}={TITLE} (optional) specifies that the metric METRIC has title TITLE.
  • -t{METRIC}={TYPE} (optional) specifies that the metric METRIC has TYPE data type.

Customize the gmetric location

You can specify the path to your gmetric implementation by using the ALLINEA_GMETRIC environment variable.

Your gmetric version must accept the following command-line arguments:

  • -n {NAME} (mandatory) specifies the name of the metric (starts with com.allinea).
  • -t {TYPE} (mandatory) specifies the type of the metric (for example, double or int32).
  • -v {VALUE} (mandatory) specifies the value of the metric.
  • -g {GROUP} (optional) specifies which groups the metric belongs to (for example allinea).
  • -u {UNIT} (optional) specifies the unit of the metric. For example, %, Watts, Seconds, and so on.
  • -T {TITLE} (optional) specifies the title of the metric.