Back to the list of connectors[1]

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.

This connector is superseded by:

enterprise[9] hardware[10] solaris[11] storage[12] sun[13]

Target

Typical platform: Oracle/Sun

Operating system: Oracle Solaris

Prerequisites

Leverages: Sun Solaris system commands (iostat, dd)

Technology and protocols: Command Lines

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:

  • Operating System is Oracle Solaris or Oracle 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

Type Collected Metrics Specific Attributes
disk_controller
  • hw.status{hw.type="disk_controller", state="present"}
  • controller_number
  • hw.parent.type
  • id
  • model
  • name
physical_disk
  • hw.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
No results.