Skip to main content

IBM AIX System

Description​

Collects system metrics from Aix 6.1 TL9+ hosts and later. It relies on LibPerfStat C library for AIX and AIX commands. Implements the OpenTelemetry semantic conventions for system metrics.

aix ibm power system

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Target​

Typical platform: IBM POWER

Operating system: IBM AIX

Prerequisites​

Leverages: IBM AIX LibPerfStat

Technology and protocols: Commands

Examples​

CLI​

metricshub HOSTNAME -t aix -c +Aix --ssh -u USER

metricshub.yaml​

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: aix
        connectors: [ +Aix ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt

Connector Activation Criteria​

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

  • The command below succeeds on the monitored host:
    • Command: /usr/bin/uname || /bin/uname
    • Output contains: AIX (regex)

Metrics​

TypeCollected MetricsSpecific Attributes
cpuhw.status{hw.type="cpu", state="present"}
system.cpu.frequency
system.cpu.time{system.cpu.state="idle"}
system.cpu.time{system.cpu.state="iowait"}
system.cpu.time{system.cpu.state="system"}
system.cpu.time{system.cpu.state="user"}
system.cpu.utilization{system.cpu.state="idle"}
system.cpu.utilization{system.cpu.state="iowait"}
system.cpu.utilization{system.cpu.state="system"}
system.cpu.utilization{system.cpu.state="user"}		id
name
system.cpu.logical_number
file_systemsystem.filesystem.limit
system.filesystem.usage{system.filesystem.state="free"}
system.filesystem.usage{system.filesystem.state="reserved"}
system.filesystem.usage{system.filesystem.state="used"}
system.filesystem.utilization{system.filesystem.state="free"}
system.filesystem.utilization{system.filesystem.state="reserved"}
system.filesystem.utilization{system.filesystem.state="used"}		id
system.device
system.filesystem.mode
system.filesystem.mountpoint
system.filesystem.type
memoryhw.status{hw.type="memory", state="present"}
system.memory.limit
system.memory.usage{system.memory.state="cached"}
system.memory.usage{system.memory.state="free"}
system.memory.usage{system.memory.state="used"}
system.memory.utilization{system.memory.state="cached"}
system.memory.utilization{system.memory.state="free"}
system.memory.utilization{system.memory.state="used"}		id
networkhw.status{hw.type="network", state="present"}
system.network.bandwidth.limit
system.network.dropped{network.io.direction="receive"}
system.network.dropped{network.io.direction="transmit"}
system.network.errors{network.io.direction="receive"}
system.network.errors{network.io.direction="transmit"}
system.network.io{network.io.direction="receive"}
system.network.io{network.io.direction="transmit"}
system.network.packets{network.io.direction="receive"}
system.network.packets{network.io.direction="transmit"}		id
network.interface.name
pagingsystem.paging.usage{system.paging.state="free"}
system.paging.usage{system.paging.state="used"}
system.paging.utilization{system.paging.state="free"}
system.paging.utilization{system.paging.state="used"}		id
system.device
paging_activitysystem.paging.faults{system.paging.type="major"}
system.paging.faults{system.paging.type="minor"}
system.paging.operations{system.paging.direction="in"}
system.paging.operations{system.paging.direction="out"}		id
physical_diskhw.status{hw.type="physical_disk", state="present"}
system.disk.io{disk.io.direction="read"}
system.disk.io{disk.io.direction="write"}
system.disk.limit		id
system.device
systemsystem.cpu.logical.count
system.cpu.physical.count
system.processes.count
system.processes.created
system.uptime		id
name
os_version
version