AIX SNMP

Pack Assets

Templates

The Centreon Plugin Pack AIX SNMP brings a host template:

• OS-AIX-SNMP-custom

It brings the following service templates:

Service Alias	Service Template	Service Description	Default	Discovery
Cpu	OS-AIX-Cpu-SNMP	Check the rate of utilization of CPU for the machine. This check can give the average CPU utilization rate and the rate per CPU for multi-core CPU	X
Disk-Generic-Id	OS-AIX-Disk-Generic-Id-SNMP	Check the rate of free space on the disk. For each checks the name of the disk will appear
Disk-Generic-Name	OS-AIX-Disk-Generic-Name-SNMP	Check the rate of free space on the disk. For each checks the mount pont of the disk will appear
Disk-Global	OS-AIX-Disk-Global-SNMP	Check the rate of free space on disks. For each checks the mount point of disks will appear		X
Process-Generic	OS-AIX-Process-Generic-SNMP	Check Linux process		X
Swap	OS-AIX-Swap-SNMP	Check virtual memory usage	X
Time	OS-AIX-Time-SNMP	Check NTP synchronization	X
Traffic-Generic-Id	OS-AIX-Traffic-Generic-Id-SNMP	Check the bandwidth of the interface. For each checks the name of the interface will appear
Traffic-Generic-Name	OS-AIX-Traffic-Generic-Name-SNMP	Check the bandwidth of the interface. For each checks the name of the interface will appear
Traffic-Global	OS-AIX-Traffic-Global-SNMP	Check the bandwidth of interfaces. For each checks the name of the interface will appear		X

Discovery rules

Rule Name	Description
OS-AIX-SNMP-Traffic-Name	Discover network interfaces and monitor bandwidth utilization
OS-AIX-SNMP-Disk-Name	Discover the disk partitions and monitor space occupation
OS-AIX-SNMP-Processes-Name	Discover processes and monitor their system usage

Collected metrics & status

Cpu

Metric Name	Unit
cpu.utilization.percentage	%
cpu_core#core.cpu.utilization.percentage	%

Disk-Generic-Id

Metric Name	Unit
storage.partitions.count	count
storage#storage.access.count	count
storage#storage.space.usage.bytes	bytes

Disk-Generic-Name

Metric Name	Unit
storage.partitions.count	count
storage#storage.access.count	count
storage#storage.space.usage.bytes	bytes

Disk-Global

Metric Name	Unit
storage.partitions.count	count
storage#storage.access.count	count
storage#storage.space.usage.bytes	bytes

Process-Generic

Metric Name	Unit
cpu_total	%
mem_avg	B
mem_total	B
nbproc

Swap

Metric Name	Unit
page.space.active.count	count
page.space.usage.bytes	B
swap#page.space.usage.bytes	B

Time

Metric Name	Unit
time.offset.seconds	s

Traffic-Generic-Id

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Traffic-Generic-Name

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Traffic-Global

Metric Name	Unit
int#interface.traffic.in.bitspersecond	b/s
int#interface.traffic.out.bitspersecond	b/s

Prerequisites

SNMP Configuration

To use this pack, the SNMP service must be properly configured on your AIX SNMP server. Please refer to the official documentation from IBM:

• IBM-AIX

Network flow

The target server must be reachable from the Centreon poller on the UDP/161 SNMP port.

Setup

Online License

1. Install the plugin package on every Centreon poller expected to monitor AIX SNMP resources:

yum install centreon-plugin-Operatingsystems-Aix-Snmp

2. On the Centreon web interface, on page Configuration > Plugin Packs, install the AIX SNMP Centreon Plugin Pack.

Offline License

1. Install the plugin package on every Centreon poller expected to monitor AIX SNMP resources:

yum install centreon-plugin-Operatingsystems-Aix-Snmp

2. Install the AIX SNMP Centreon Plugin Pack RPM on the Centreon central server:

yum install centreon-pack-operatingsystems-aix-snmp

3. On the Centreon web interface, on page Configuration > Plugin Packs, install the AIX SNMP Centreon Plugin Pack.

Configuration

Host

• Log into Centreon and add a new host through Configuration > Hosts.
• Fill the Name, Alias & IP Address/DNS fields according to your AIX SNMP server settings.
• Apply the OS-AIX-SNMP-custom template to the host.

When using SNMP v3, use the SNMPEXTRAOPTIONS Macro to add specific authentication parameters More information in the Troubleshooting SNMP section.

Mandatory	Macro	Description
	SNMPEXTRAOPTIONS	Configure your own SNMPv3 credentials combo

How to check in the CLI that the configuration is OK and what are the main options for?

Once the plugin is installed, log into your Centreon poller's CLI using the centreon-engine user account (su - centreon-engine) and test the plugin by running the following command:

/usr/lib/centreon/plugins//centreon_aix_snmp.pl \
    --plugin=os::aix::snmp::plugin \
    --mode=cpu \
    --hostname=10.0.0.1 \
    --snmp-version='2c' \
    --snmp-community='my-snmp-community' \
    --warning-average='80' \
    --critical-average='90' \
    --use-new-perfdata

The expected command output is shown below:

OK: All CPUs usage are OK | 'cpu.utilization.percentage'=9000%;80;90;0;100 'core.cpu.utilization.percentage'=9000%;;;0;100 

All available options for a given mode can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins//centreon_aix_snmp.pl \
    --plugin=os::aix::snmp::plugin \
    --mode=cpu \
    --help

All available modes can be displayed by adding the --list-mode parameter to the command:

/usr/lib/centreon/plugins//centreon_aix_snmp.pl \
    --plugin=os::aix::snmp::plugin \
    --list-mode

Troubleshooting

Please find the troubleshooting documentation for Centreon Plugins typical issues.