Back to the list of connectors

IBM Director Agent 4.x - Linux

Description

This connector provides hardware monitoring through the IBM Director Agent version 4.x which supports some (not all) xSeries servers.

Connector ID: Director4Linux

Target

Typical platform: IBM xSeries

Operating system: Linux

Prerequisites

Leverages: IBM Director Agent 4.x

Technology and protocols: WBEM

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

  • /opt/IBM/director/CIMOM/bin/cimcli

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 hwsagent account:

hwsagent ALL=(root) NOPASSWD: /opt/IBM/director/CIMOM/bin/cimcli

Examples

CLI

hws HOSTNAME -t linux -f Director4Linux --wbem -u USER

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ Director4Linux ] # Optional, to load only this connector
  wbem:
    protocol: https
    port: 5989
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt

Connector Activation Criteria

The IBM Director Agent 4.x - Linux connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

  • Operating System is Linux
  • At least one process for which the command line matches with the regular expression below is running:
    cimserver
  • The command below succeeds on the monitored host
    • Command: ls /opt/IBM/director/CIMOM/bin/cimcli
    • Output contains: ^/opt/IBM/director/CIMOM/bin/cimcli$ (regex)
  • The WBEM query below to the managed host succeeds:
    • Namespace: root
    • WQL Query: SELECT Name FROM __NAMESPACE
    • Result contains: ^ibmsd;$ (regex)
  • The WBEM query below to the managed host succeeds:
    • Namespace: root/ibmsd
    • WQL Query: SELECT Name FROM IBMPSG_ComputerSystemDetails

Metrics

Type Collected Metrics Specific Attributes (Labels)
Enclosure
  • hw.status{hw.type="enclosure",state="open"}
  • hw.status{hw.type="enclosure",state="present"}
  • model
  • serial_number
  • type
  • vendor
Disk Controller
  • hw.status{hw.type="disk_controller",state="present"}
  • bios_version
  • driver_version
  • model
  • vendor
Processor
  • hw.cpu.speed.limit{limit_type="max"}
  • hw.status{hw.type="cpu",state="ok|degraded|failed"}
  • hw.status{hw.type="cpu",state="present"}
  • model
  • vendor
Fan
  • hw.fan.limit{limit_type="high.critical"}
  • hw.fan.limit{limit_type="high.degraded"}
  • hw.fan.speed
  • hw.status{hw.type="fan",state="present"}
  • sensor_location
Logical Disk, RAID
  • hw.logical_disk.limit
  • hw.status{hw.type="logical_disk",state="ok|degraded|failed"}
  • hw.status{hw.type="logical_disk",state="present"}
  • raid_level
Memory Module
  • hw.memory.limit
  • hw.status{hw.type="memory",state="ok|degraded|failed"}
  • hw.status{hw.type="memory",state="present"}
  • serial_number
  • type
  • vendor
Physical Disk
  • hw.physical_disk.size
  • hw.status{hw.type="physical_disk",state="ok|degraded|failed"}
  • hw.status{hw.type="physical_disk",state="present"}
  • model
  • serial_number
  • vendor
Power Supply
  • hw.status{hw.type="power_supply",state="ok|degraded|failed"}
  • hw.status{hw.type="power_supply",state="present"}
    Temperature Sensor
    • hw.status{hw.type="temperature",state="present"}
    • hw.temperature
    • hw.temperature.limit{limit_type="high.critical"}
    • hw.temperature.limit{limit_type="high.degraded"}
    • sensor_location
    Voltage Sensor
    • hw.status{hw.type="voltage",state="present"}
    • hw.voltage
    • hw.voltage.limit{limit_type="high.critical"}
    • hw.voltage.limit{limit_type="low.critical"}
    • sensor_location
    No results.