Check qts-temperatures

Overview

Checks system and CPU temperatures on QNAP appliances running QTS via the HTTP API. All temperatures are expressed in Celsius. Temperature thresholds are determined automatically from the QTS system configuration.

Important Notes:

  • 3rd party Python module xmltodict required

  • Tested on QuTScloud v4.5.6+

  • The user used for monitoring must be a member of the „administrators“ group. It is not sufficient to be a member of the „everyone“ group.

Data Collection:

  • Authenticates against the QTS API and fetches system information via /cgi-bin/management/manaRequest.cgi

  • Reads system temperature (sys_tempc), CPU temperature (cpu_tempc), and the corresponding warning/error thresholds from the QTS configuration

Fact Sheet

Fact

Value

Check Plugin Download

https://github.com/Linuxfabrik/monitoring-plugins/tree/main/check-plugins/qts-temperatures

Nagios/Icinga Check Name

check_qts_temperatures

Check Interval Recommendation

Every minute

Can be called without parameters

No (--password and --url are required)

Runs on

Cross-platform

Compiled for Windows

No

3rd Party Python modules

xmltodict

Help

usage: qts-temperatures [-h] [-V] [--always-ok] [--insecure] [--no-proxy]
                        --password PASSWORD [--timeout TIMEOUT] --url URL
                        [--username USERNAME]

Checks system and disk temperatures on QNAP appliances running QTS via the
API. Alerts when temperatures exceed the configured thresholds.

options:
  -h, --help           show this help message and exit
  -V, --version        show program's version number and exit
  --always-ok          Always returns OK.
  --insecure           This option explicitly allows insecure SSL connections.
  --no-proxy           Do not use a proxy.
  --password PASSWORD  QTS API password.
  --timeout TIMEOUT    Network timeout in seconds. Default: 6 (seconds)
  --url URL            QTS-based appliance URL. Example:
                       `--url=https://192.168.1.1:8080`.
  --username USERNAME  QTS API username. Default: admin

Usage Examples

./qts-temperatures --url http://qts:8080 --username admin --password linuxfabrik --insecure

Output:

Sys: 59°C (Thresholds: 60/70°C), CPU: 82°C (Thresholds: 80/85°C) [WARNING]

States

  • OK if both system and CPU temperatures are below the QTS-configured thresholds.

  • WARN if the system or CPU temperature exceeds the warning threshold configured in QTS.

  • CRIT if the system or CPU temperature exceeds the error threshold configured in QTS.

  • --always-ok suppresses all alerts and always returns OK.

Perfdata / Metrics

Name

Type

Description

cputemp

Number

CPU temperature, in degrees Celsius.

systemp

Number

System temperature, in degrees Celsius.

Credits, License