XML reference for SPIs
You can create or edit XML files to import HP OM Smart Plug-Ins (SPIs) into Infrastructure Management for monitoring and analysis. This topic describes the XML elements and attributes required to import an SPI into Infrastructure Management.
An XML generation tool is provided, through the command-line interface, to help create XML files for agent types that are not provided with the installation. For information about the
pw ovxmlgenerator command, see
After you choose a provided XML specification file, or create your own, you can edit the file to reflect your environment and requirements.
The following example shows the elements and attributes used in the XML file for SPIs.
The following list describes the elements and attributes in the XML file.
The <SPI> root element contains the SPI group and parameter details.
The value of the name attribute is the name of the SPI, exactly as it is provided by HP OM.
The value of the calculation attribute indicates whether one or more parameters in the SPI require mathematical manipulation.
Use one or more <GROUP> elements to define group details and to contain the parameter details of the group. If the SPI does not contain a group, add a group by using the SPI name as the group name. The <GROUP> element contains the following attributes: name, parent, hasInstances, label, nameIdentifier, and groupIdentifier.
The value of the name attribute is the name of the group, exactly as it is provided by HP OM.
The value of the parent attribute is the name of the SPI, exactly as it is provided by HP OM. The attribute is reserved for future subgroup functionality of the adapter for HP OM.
The value of the hasInstances attribute indicates whether the group of parameters can have more than one instance.
The value of the label attribute is the name of the group that appears in the Operations Console.
The value of the
The value of the
Use one or more <parameter> elements to define the name of each parameter and to contain elements with the parameter properties.
The adapter for HP OM can use only numeric parameters for metric analysis. Do not add parameters with string values.
The <parameter> element contains the name attribute.
The value of the name attribute specifies the name of the parameter, exactly as it is provided by HP OM.
The content of the <type> element is always 2, indicating a numerical value that you can use to generate a graph.
Type the content of the <description> element to add a description of the parameter and to identify it in the Operations Console.
Type the contents of the <unit> element to specify the units of the parameter; for example, sec., #, or days, which causes the units to be displayed with the parameter in the Operations Console.
Type the contents of the <style> element to specify whether the parameter appears at its current value or as the difference since the previous collection. Use one of the following contents for the element:
The <factor> element is a non-zero normalizing value.
If the content of the <factor> element does not equal 1 for any parameter in the SPI, ensure that the value of the calculation attribute in the <SPI> root element is yes.