p39718465
/
zabbix
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'e2557dd2e7'
${ noResults }
zabbix/templates/server/smart_agent2/README.md

16 KiB
Raw Blame History

SMART by Zabbix agent 2

Overview

This template is designed for the effortless deployment of SMART monitoring by Zabbix via Zabbix agent 2 and doesn't require any external scripts.

It collects metrics by Zabbix agent 2 version 5.0 and later with Smartmontools version 7.1 and later. Disk discovery LLD rule finds all HDD, SSD, NVMe disks with S.M.A.R.T. enabled. Attribute discovery LLD rule have pre-defined Vendor Specific Attributes for each disk, and will be discovered if attribute is present.

Requirements

Zabbix version: 7.0 and higher.

Tested versions

This template has been tested on:

  • Smartmontools 7.1 and later

Configuration

Zabbix should be configured according to the instructions in the Templates out of the box section.

Setup

Install the Zabbix agent 2 and Smartmontools 7.1. Grant Zabbix agent 2 super/admin user privileges for smartctl utility.

Linux example:

sudo dnf install smartmontools sudo visudo

zabbix ALL=(ALL) NOPASSWD:/usr/sbin/smartctl

Plugin parameters list

Macros used

Name Description Default
{$SMART.TEMPERATURE.MAX.WARN}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 50
{$SMART.TEMPERATURE.MAX.CRIT}

This macro is used for trigger expression. It can be overridden on the host or linked on the template level.

 65
{$SMART.DISK.NAME.MATCHES}

This macro is used in the filter of attribute and disk discoveries. It can be overridden on the host or linked on the template level.

 ^.*$
{$SMART.DISK.NAME.NOT_MATCHES}

This macro is used in the filter of attribute and disk discoveries. It can be overridden on the host or linked on the template level.

 CHANGE_IF_NEEDED

LLD rule Disk discovery

Name Description Type Key and additional info
Disk discovery

Discovery SMART disks.

 Zabbix agent smart.disk.discovery

Item prototypes for Disk discovery

Name Description Type Key and additional info
SMART [{#NAME}]: Smartctl error

This metric will contain smartctl errors.

 Dependent item smart.disk.error[{#NAME}]

Preprocessing

  • JSON Path: $.error

  • Discard unchanged with heartbeat: 1h
SMART [{#NAME}]: Get disk attributes Zabbix agent smart.disk.get[{#PATH},"{#RAIDTYPE}"]
SMART [{#NAME}]: Device model Dependent item smart.disk.model[{#NAME}]

Preprocessing

  • JSON Path: $.model_name

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Serial number Dependent item smart.disk.sn[{#NAME}]

Preprocessing

  • JSON Path: $.serial_number

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Self-test passed

The disk is passed the SMART self-test or not.

 Dependent item smart.disk.test[{#NAME}]

Preprocessing

  • JSON Path: $.self_test_passed

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Temperature

Current drive temperature.

 Dependent item smart.disk.temperature[{#NAME}]

Preprocessing

  • JSON Path: $.temperature

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Power on hours

Count of hours in power-on state. The raw value of this attribute

shows total count of hours (or minutes, or seconds, depending on manufacturer)

in power-on state. "By default, the total expected lifetime of a hard disk

in perfect condition is defined as 5 years (running every day and night on

all days). This is equal to 1825 days in 24/7 mode or 43800 hours." On some

pre-2005 drives, this raw value may advance erratically and/or "wrap around"

(reset to zero periodically). https://en.wikipedia.org/wiki/S.M.A.R.T.#Known_ATA_S.M.A.R.T._attributes

 Dependent item smart.disk.hours[{#NAME}]

Preprocessing

  • JSON Path: $.power_on_time

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Percentage used

Contains a vendor specific estimate of the percentage of NVM subsystem

life used based on the actual usage and the manufacturer's prediction of NVM

life. A value of 100 indicates that the estimated endurance of the NVM in

the NVM subsystem has been consumed, but may not indicate an NVM subsystem

failure. The value is allowed to exceed 100. Percentages greater than 254

shall be represented as 255. This value shall be updated once per power-on

hour (when the controller is not in a sleep state).

 Dependent item smart.disk.percentage_used[{#NAME}]

Preprocessing

  • JSON Path: $.percentage_used

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Critical warning

This field indicates critical warnings for the state of the controller.

 Dependent item smart.disk.critical_warning[{#NAME}]

Preprocessing

  • JSON Path: $.critical_warning

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Media errors

Contains the number of occurrences where the controller detected

an unrecovered data integrity error. Errors such as uncorrectable ECC, CRC

checksum failure, or LBA tag mismatch are included in this field.

 Dependent item smart.disk.media_errors[{#NAME}]

Preprocessing

  • JSON Path: $.media_errors

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Exit status

The exit statuses of smartctl are defined by a bitmask but in decimal value. The eight different bits in the exit status have the following meanings for ATA disks; some of these values may also be returned for SCSI disks.

Bit 0: Command line did not parse.

Bit 1: Device open failed, device did not return an IDENTIFY DEVICE structure, or device is in a low-power mode (see '-n' option above).

Bit 2: Some SMART or other ATA command to the disk failed, or there was a checksum error in a SMART data structure (see '-b' option above).

Bit 3: SMART status check returned "DISK FAILING".

Bit 4: We found prefail Attributes <= threshold.

Bit 5: SMART status check returned "DISK OK" but we found that some (usage or prefail) Attributes have been <= threshold at some time in the past.

Bit 6: The device error log contains records of errors.

Bit 7: The device self-test log contains records of errors. [ATA only] Failed self-tests outdated by a newer successful extended self-test are ignored.

 Dependent item smart.disk.es[{#NAME}]

Preprocessing

  • JSON Path: $.exit_status

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Raw_Read_Error_Rate

Stores data related to the rate of hardware read errors that occurred when reading data from a disk surface. The raw value has different structure for different vendors and is often not meaningful as a decimal number. For some drives, this number may increase during normal operation without necessarily signifying errors.

 Dependent item smart.disk.attribute.raw_read_error_rate[{#NAME}]

Preprocessing

  • JSON Path: $.raw_read_error_rate.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Spin_Up_Time

Average time of spindle spin up (from zero RPM to fully operational [milliseconds]).

 Dependent item smart.disk.attribute.spin_up_time[{#NAME}]

Preprocessing

  • JSON Path: $.spin_up_time.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Start_Stop_Count

A tally of spindle start/stop cycles. The spindle turns on, and hence the count is increased, both when the hard disk is turned on after having before been turned entirely off (disconnected from power source) and when the hard disk returns from having previously been put to sleep mode.

 Dependent item smart.disk.attribute.start_stop_count[{#NAME}]

Preprocessing

  • JSON Path: $.start_stop_count.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Power_Cycle_Count

This attribute indicates the count of full hard disk power on/off cycles.

 Dependent item smart.disk.attribute.power_cycle_count[{#NAME}]

Preprocessing

  • JSON Path: $.power_cycle_count.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Reported_Uncorrect

The count of errors that could not be recovered using hardware ECC.

 Dependent item smart.disk.attribute.reported_uncorrect[{#NAME}]

Preprocessing

  • JSON Path: $.reported_uncorrect.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Seek_Error_Rate

Rate of seek errors of the magnetic heads. If there is a partial failure in the mechanical positioning system, then seek errors will arise. Such a failure may be due to numerous factors, such as damage to a servo, or thermal widening of the hard disk. The raw value has different structure for different vendors and is often not meaningful as a decimal number. For some drives, this number may increase during normal operation without necessarily signifying errors.

 Dependent item smart.disk.attribute.seek_error_rate[{#NAME}]

Preprocessing

  • JSON Path: $.seek_error_rate.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Bad_Block_Rate

Percentage of used reserve blocks divided by total reserve blocks.

 Dependent item smart.disk.attribute.bad_block_rate[{#NAME}]

Preprocessing

  • JSON Path: $.bad_block_rate.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Program_Fail_Count_Chip

The total number of flash program operation failures since the drive was deployed.

 Dependent item smart.disk.attribute.program_fail_count_chip[{#NAME}]

Preprocessing

  • JSON Path: $.program_fail_count_chip.value

  • Discard unchanged with heartbeat: 6h
SMART [{#NAME}]: Reallocated_Sector_Ct

Disk discovered attribute.

 Dependent item smart.disk.attribute.reallocated_sector_ct[{#NAME}]

Preprocessing

  • JSON Path: $.reallocated_sector_ct.value

  • Discard unchanged with heartbeat: 6h

Trigger prototypes for Disk discovery

Name Description Expression Severity Dependencies and additional info
SMART [{#NAME}]: Disk has been replaced

Device serial number has changed. Acknowledge to close the problem manually.

 last(/SMART by Zabbix agent 2/smart.disk.sn[{#NAME}],#1)<>last(/SMART by Zabbix agent 2/smart.disk.sn[{#NAME}],#2) and length(last(/SMART by Zabbix agent 2/smart.disk.sn[{#NAME}]))>0 Info Manual close: Yes
SMART [{#NAME}]: Disk self-test is not passed last(/SMART by Zabbix agent 2/smart.disk.test[{#NAME}])="false" High
SMART [{#NAME}]: Average disk temperature is too high avg(/SMART by Zabbix agent 2/smart.disk.temperature[{#NAME}],5m)>{$SMART.TEMPERATURE.MAX.WARN} Warning Depends on:
  • SMART [{#NAME}]: Average disk temperature is critical
SMART [{#NAME}]: Average disk temperature is critical avg(/SMART by Zabbix agent 2/smart.disk.temperature[{#NAME}],5m)>{$SMART.TEMPERATURE.MAX.CRIT} Average
SMART [{#NAME}]: NVMe disk percentage using is over 90% of estimated endurance last(/SMART by Zabbix agent 2/smart.disk.percentage_used[{#NAME}])>90 Average
SMART [{#NAME}]: Command line did not parse

Command line did not parse.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),1) = 1 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),1) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),1) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),1) ) High Manual close: Yes
SMART [{#NAME}]: Device open failed

Device open failed, device did not return an IDENTIFY DEVICE structure, or device is in a low-power mode.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),2) = 2 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),2) = 2 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),2) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),2) ) High Manual close: Yes
SMART [{#NAME}]: Some command to the disk failed

Some SMART or other ATA command to the disk failed,
or there was a checksum error in a SMART data structure.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),4) = 4 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),4) = 4 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),4) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),4) ) High Manual close: Yes
SMART [{#NAME}]: Check returned "DISK FAILING"

SMART status check returned "DISK FAILING".

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),8) = 8 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),8) = 8 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),8) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),8) ) High Manual close: Yes
SMART [{#NAME}]: Some prefail Attributes <= threshold

We found prefail Attributes <= threshold.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),16) = 16 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),16) = 16 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),16) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),16) ) High Manual close: Yes
SMART [{#NAME}]: Some Attributes have been <= threshold

SMART status check returned "DISK OK" but we found that some (usage
or prefail) Attributes have been <= threshold at some time in the past.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),32) = 32 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),32) = 32 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),32) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),32) ) High Manual close: Yes
SMART [{#NAME}]: Error log contains records

The device error log contains records of errors.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),64) = 64 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),64) = 64 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),64) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),64) ) High Manual close: Yes
SMART [{#NAME}]: Self-test log contains records

The device self-test log contains records of errors. [ATA only]
Failed self-tests outdated by a newer successful extended self-test are ignored.

 ( count(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2) = 1 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),128) = 128 ) or ( bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),128) = 128 and bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}]),128) > bitand(last(/SMART by Zabbix agent 2/smart.disk.es[{#NAME}],#2),128) ) High Manual close: Yes

Feedback

Please report any issues with the template at https://support.zabbix.com

You can also provide feedback, discuss the template, or ask for help at ZABBIX forums