Skip to content

Latest commit

 

History

History
377 lines (250 loc) · 8.3 KB

README.md

File metadata and controls

377 lines (250 loc) · 8.3 KB
Raw

Zabbix Template: QEMU Guest Agent

class: software target: qemu-ga vendor: RaBe version: 6.4

Monitoring of the QEMU Guest Agent.

This template is part of RaBe's Zabbix template and helpers collection.

Items

Item: qemu-ga: process summary

component: raw

Get info about qemu-ga processes

proc.get[qemu-ga,root,,summary]

Settings:

Item Setting Value
Type ZABBIX_ACTIVE
Value type TEXT

Item: qemu-ga: Unit active state

component: service

State value that reflects whether the unit is currently active or not. The following states are currently defined: "active", "reloading", "inactive", "failed", "activating", and "deactivating".

rabe.qemu-ga.active_state

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item systemd.unit.get["qemu-guest-agent.service"]

Preprocessing steps:

Type Parameters
JSONPATH ["$.ActiveState.state"]
DISCARD_UNCHANGED_HEARTBEAT ["30m"]

Item: qemu-ga: CPU seconds (system)

component: qemu-ga

Total CPU seconds (system) of qemu-ga processes.

rabe.qemu-ga.cputime_system

Settings:

Item Setting Value
Type DEPENDENT
Value type FLOAT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].cputime_system.first()"]
SIMPLE_CHANGE [""]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: CPU seconds (user)

component: qemu-ga

Total CPU seconds (user) of qemu-ga processes.

rabe.qemu-ga.cputime_user

Settings:

Item Setting Value
Type DEPENDENT
Value type FLOAT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].cputime_user.first()"]
SIMPLE_CHANGE [""]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: Service load state

component: service

State value that reflects whether the configuration file of this unit has been loaded. The following states are currently defined: "loaded", "error", and "masked".

rabe.qemu-ga.load_state

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item systemd.unit.get["qemu-guest-agent.service"]

Preprocessing steps:

Type Parameters
JSONPATH ["$.LoadState.state"]
DISCARD_UNCHANGED_HEARTBEAT ["30m"]

Item: qemu-ga: Number of processes

component: qemu-ga

Number of qemu-ga processes.

rabe.qemu-ga.processes

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].processes.first()"]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: Memory usage (RSS)

component: qemu-ga

Memory usage of qemu-ga processes.

rabe.qemu-ga.rss

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].rss.first()"]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: Swap usage

component: qemu-ga

Swap usage of qemu-ga processes.

rabe.qemu-ga.swap

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].swap.first()"]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: Number of threads

component: qemu-ga

Number of qemu-ga threads.

rabe.qemu-ga.threads

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item proc.get[qemu-ga,root,,summary]

Preprocessing steps:

Type Parameters
JSONPATH ["$[*].threads.first()"]
DISCARD_UNCHANGED_HEARTBEAT ["5m"]

Item: qemu-ga: Unit file state

component: service

Encodes the install state of the unit file of FragmentPath. It currently knows the following states: "enabled", "enabled-runtime", "linked", "linked-runtime", "masked", "masked-runtime", "static", "disabled", and "invalid".

rabe.qemu-ga.unitfile_state

Settings:

Item Setting Value
Type DEPENDENT
History 7d
Source item systemd.unit.get["qemu-guest-agent.service"]

Preprocessing steps:

Type Parameters
JSONPATH ["$.UnitFileState.state"]
DISCARD_UNCHANGED_HEARTBEAT ["30m"]

Item: qemu-ga: Uptime

component: service

Number of seconds since unit entered the active state.

rabe.qemu-ga.uptime

Settings:

Item Setting Value
Type DEPENDENT
Value type FLOAT in uptime
History 7d
Source item systemd.unit.get["qemu-guest-agent.service"]

Preprocessing steps:

Type Parameters
JAVASCRIPT ["data = JSON.parse(value);\nif (data.ActiveEnterTimestamp > data.ActiveExitTimestamp) {\n return Math.floor(Date.now() / 1000) - Number(data.ActiveEnterTimestamp) / 1000000;\n}\nreturn null;\n"]

Item: qemu-ga: unit info

component: raw component: unit

Get unit info from systemd

systemd.unit.get["qemu-guest-agent.service"]

Settings:

Item Setting Value
Type ZABBIX_ACTIVE
Value type TEXT

Triggers

Trigger: qemu-ga: Service is not running

scope: availability

Settings:

Trigger Setting Values
Priority WARNING
Manual close YES 
last(/qemu-ga/rabe.qemu-ga.active_state)<>1

Trigger: qemu-ga: No running processes

scope: availability

No running qemu-ga processes. Settings:

Trigger Setting Values
Priority HIGH 
last(/qemu-ga/rabe.qemu-ga.processes)<{$QEMUGA.THRESHOLD.MIN_PROC}

Trigger: qemu-ga: has been restarted

scope: notice

Settings:

Trigger Setting Values
Priority INFO
Manual close YES 
last(/qemu-ga/rabe.qemu-ga.uptime)<=10m

Macros

The following Zabbix macros are configured via this template.

Macro: {$QEMUGA.THRESHOLD.MIN_PROC}

Minimum amount of processes expected to be running at all times.

Default:

1

Dashboards

The following Zabbix dashboards are included in this template.

  • qemu-ga: Overview

License

This template is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, version 3 of the License.

Copyright

Copyright (c) 2017 - 2024 Radio Bern RaBe