IBM AIX - usysfault

Description

This connector provides the status of the System Attention LED of an IBM AIX server.

aix hardware ibm

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Target

Typical platform: IBM POWER

Operating system: IBM AIX

Prerequisites

Leverages: IBM AIX usysfault command

Technology and protocols: Commands

This connector requires advanced privileges on the managed host for the command below:

• /usr/lpp/diagnostics/bin/usysfault

This connector therefore needs to run as root or you need to configure a privilege-escalation mechanism like sudo on the managed host to allow the monitoring account to run the command listed above.

Sample of /etc/sudoers to allow the above command to be run as root by the metricshub account:

metricshub ALL=(root) NOPASSWD: /usr/lpp/diagnostics/bin/usysfault

Examples

CLI

metricshub HOSTNAME -t linux -c +IBMAIXusysfault --ssh -u USER --sudo-command-list /usr/lpp/diagnostics/bin/usysfault

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: linux
        connectors: [ +IBMAIXusysfault ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt
            useSudo: true
            useSudoCommands: [ "/usr/lpp/diagnostics/bin/usysfault" ]

Connector Activation Criteria

The IBM AIX - usysfault connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

• The device type must be one of: RS6000
• The command below succeeds on the monitored host:
  • Command: /usr/lpp/diagnostics/bin/usysfault
  • Output contains: ^\(normal\)\|\(fault\)$ (regex)

Metrics

Type	Collected Metrics	Specific Attributes
led	hw.status{hw.type="led", state="degraded|failed|ok"} hw.status{hw.type="led", state="present"}	color hw.parent.type id name