Skip to main content

Oracle/Sun Solaris - Non-Sun Disks

Description

This connector provides physical disk information (status and error count) on Sun Solaris systems through the iostat -En utility. Supports only non-Sun official disks.

hardware solaris storage sun

Enterprise Connector

This connector requires the Enterprise edition of MetricsHub.

Target

Typical platform: Sun/Oracle Servers

Operating system: Oracle Solaris

Prerequisites

Leverages: Sun Solaris system commands (iostat, dd)

Technology and protocols: Commands

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

  • /usr/bin/dd

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/bin/dd

Examples

CLI

metricshub HOSTNAME -t solaris -c +SunIostatNonSun --ssh -u USER --sudo-command-list /usr/bin/dd

metricshub.yaml

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

Connector Activation Criteria

The Oracle/Sun Solaris - Non-Sun Disks 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: SunOS, Solaris
  • The command below succeeds on the monitored host:
    • Command: /usr/bin/iostat -En
    • Output contains: Soft [Ee]rrors.*Hard [Ee]rrors.*Transport [Ee]rrors (regex)

Metrics

TypeCollected MetricsSpecific Attributes
disk_controllerhw.status{hw.type="disk_controller", state="present"}controller_number
hw.parent.type
id
model
name
physical_diskhw.errors{hw.type="physical_disk", hw.error.type="device_not_ready"}
hw.errors{hw.type="physical_disk", hw.error.type="hard"}
hw.errors{hw.type="physical_disk", hw.error.type="illegal_request"}
hw.errors{hw.type="physical_disk", hw.error.type="media"}
hw.errors{hw.type="physical_disk", hw.error.type="no_device"}
hw.errors{hw.type="physical_disk", hw.error.type="recoverable"}
hw.errors{hw.type="physical_disk", hw.error.type="transport"}
hw.errors{hw.type="physical_disk"}
hw.physical_disk.size
hw.status{hw.type="physical_disk", state="degraded|failed|ok"}
hw.status{hw.type="physical_disk", state="predicted_failure"}
hw.status{hw.type="physical_disk", state="present"}
hw.parent.id
hw.parent.type
id
name
serial_number
vendor