From OpenNMS

Configuration File Details

• File : categories.xml
• You must restart OpenNMS for changes in this file to take effect

This file allows you to configure categories of device masted on the mixture of services they run. You can also set expected uptime and warning levels when the uptime drops bellow a certain percentage.

These categories show up on the dashboard page when you first log in to OpenNMS provided they are also named in the viewsdisplay.xml file.

The schema for this config file is opennms-config/src/main/castor/categories.xsd

The configuration allows you to limit certain services to certain categories or even more complex matching based on things like the sysObjID. Example:

<catinfo>
    <header>
    </header>
    <categorygroup>
        <name>WebConsole</name>
        <comment>Service Level Availability by Functional Group</comment>
        <common>
            <rule><![CDATA[IPADDR != '0.0.0.0']]></rule>
        </common>
        <categories>
            <category>
                <label><![CDATA[Overall Service Availability]]></label>
                <comment>This category reflects availability of all services currently being monitored by OpenNMS.</comment>
                <normal>99.99</normal>
                <warning>97</warning>
                <rule><![CDATA[IPADDR != '0.0.0.0']]></rule>
            </category>

            <category>
                <label><![CDATA[Network Interfaces]]></label>
                <comment>This category reflects the ability to 'ping' managed devices and SNMP agents.  'Ping', using the ICMP protocol, tests a devices network connectivity/availability.</comment>
                <normal>99.99</normal>
                <warning>97</warning>
                <service>ICMP</service>
                <service>SNMP</service>
                <rule><![CDATA[(isICMP | isSNMP) & (IPADDR != '0.0.0.0')]]></rule>
            </category>

            <category>
                <label><![CDATA[VectaStar Elements]]></label>
                <comment>This category includes all managed interfaces which are related to the VectaStar system.</comment>
                <normal>99.99</normal>
                <warning>97</warning>
                <rule><![CDATA[(nodeSysOID like '.1.3.6.1.4.1.5419.1.3500.%')]]></rule>
            </category>
         </categories>
    </categorygroup>
</catinfo>