Back to the list of connectors[1]

IBM AIX - Common

Description

This connector provides hardware status information on IBM AIX systems (processors, memory modules, network interfaces).

This connector is superseded by:

aix[3] enterprise[4] hardware[5] ibm[6]

Target

Typical platform: IBM POWER

Operating system: IBM AIX

Prerequisites

Leverages: IBM AIX system commands (lsdev, entstat, etc.)

Technology and protocols: Command Lines

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

  • /usr/sbin/netstat -D

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/sbin/netstat -D

Examples

CLI

metricshub HOSTNAME -t aix -c +IBMAIX --ssh -u USER --sudo-command-list /usr/sbin/netstat -D

metricshub.yaml

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

Connector Activation Criteria

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

  • Operating System is IBM AIX
  • The command below succeeds on the monitored host
    • Command: /usr/bin/ls /usr/sbin/lsdev
    • Output contains: ^/usr/sbin/lsdev$ (regex)

Metrics

Type Collected Metrics Specific Attributes
cpu
  • hw.cpu.speed.limit{limit_type="max"}
  • hw.status{hw.type="cpu", state="degraded|failed|ok"}
  • hw.status{hw.type="cpu", state="present"}
  • hw.parent.type
  • id
  • model
  • name
enclosure
  • hw.status{hw.type="enclosure", state="degraded|failed|ok"}
  • hw.status{hw.type="enclosure", state="present"}
  • bios_version
  • id
  • info
  • model
  • name
  • serial_number
  • type
  • vendor
memory
  • hw.errors{hw.type="memory"}
  • hw.memory.limit
  • hw.status{hw.type="memory", state="degraded|failed|ok"}
  • hw.status{hw.type="memory", state="present"}
  • hw.parent.type
  • id
  • info
  • name
  • serial_number
network
  • hw.errors{hw.type="network"}
  • hw.network.bandwidth.limit
  • hw.network.full_duplex
  • hw.network.io{direction="receive"}
  • hw.network.io{direction="transmit"}
  • hw.network.packets{direction="receive"}
  • hw.network.packets{direction="transmit"}
  • hw.network.up
  • hw.status{hw.type="network", state="degraded|failed|ok"}
  • hw.status{hw.type="network", state="present"}
  • bandwidth
  • device_type
  • hw.parent.type
  • id
  • info
  • model
  • name
  • physical_address
  • physical_address_type
No results.