Back to the list of connectors

SmartMon Tools

Description

Gives S.M.A.R.T.-enabled physical disk information through the smartd/smartctl utility under Linux.

Connector ID: SmartMonLinux

This connector is superseded by:

Target

Typical platform: Any system with SmartMon

Operating system: Linux

Prerequisites

Leverages: SmartMon Tools

Technology and protocols: System Commands

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

  • /bin/dd
  • /usr/sbin/smartctl

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 commands listed above.

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

hwsagent ALL=(root) NOPASSWD: /bin/dd
hwsagent ALL=(root) NOPASSWD: /usr/sbin/smartctl

Examples

CLI

hws HOSTNAME -t linux -f SmartMonLinux --ssh -u USER --sudo-command-list /bin/dd,/usr/sbin/smartctl

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ SmartMonLinux ] # Optional, to load only this connector
  ssh:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt
    useSudo: true
    useSudoCommands: [ "/bin/dd", "/usr/sbin/smartctl" ]

Connector Activation Criteria

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

  • Operating System is Linux
  • The command below succeeds on the monitored host
    • Command: /bin/ls /usr/sbin/smartd
    • Output contains: ^/usr/sbin/smartd$ (regex)
  • The command below succeeds on the monitored host
    • Command: /bin/ls /usr/sbin/smartctl
    • Output contains: ^/usr/sbin/smartctl$ (regex)
  • The command below succeeds on the monitored host
    • Command: /usr/sbin/smartd -c;/usr/sbin/smartd -q onecheck
    • Output contains: Device: .* opened (regex)
  • The command below succeeds on the monitored host
    • Command: /usr/sbin/smartd -c;/usr/sbin/smartd -q onecheck
    • Output contains: Device: .* is SMART capable (regex)

Metrics

Type Collected Metrics Specific Attributes (Labels)
Physical Disk
  • hw.status{hw.type="physical_disk",state="ok|degraded|failed"}
  • hw.status{hw.type="physical_disk",state="predicted_failure"}
  • hw.status{hw.type="physical_disk",state="present"}
  • serial_number
  • vendor
Temperature Sensor
  • hw.status{hw.type="temperature",state="present"}
  • hw.temperature
  • hw.temperature.limit{limit_type="high.degraded"}
  • sensor_location
No results.