Zabbix template for Runecast monitoring

Overview

The template to monitor Runecast by Zabbix 6.x using HTTP agent.

Setup

See Zabbix templates importing for basic instructions on how to import a template.

1. Create a new host
2. Set/change the host macros required for Runecast API authentication:

{$RUNECAST_API_TOKEN}

3. Link the template to host created early

Zabbix configuration

No specific Zabbix configuration is required

Macros used

Name	Description	Default
{$RUNECAST_API_TOKEN}	Runecast API token. (go to Runecast server > Settings > API Access Token to generate one; token only needs read permissions)

Template links

There are no template links in this template.

Discovery rules

Name	Description	Type	Key and additional info
Analysis discovery	Discovery of analysis details, e.g. status, timestamp, issues	DEPENDENT	runecast.analysis.discovery Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: 6h
License detail discovery	Discovery of license details	DEPENDENT	runecast.license.discovery Preprocessing: - JSONPath: $.licenses - DISCARD_UNCHANGED_HEARTBEAT: 6h
vCenter discovery	Discovery of connected vCenters	DEPENDENT	runecast.vcenter.discovery Preprocessing: - DISCARD_UNCHANGED_HEARTBEAT: 6h

Items collected

Name	Description	Type	Key and additional info
Runecast: Analysis results		HTTP_Agent	runecast.analysis.results Preprocessing: - JSONPath: $.results
Runecast: License info		HTTP_Agent	runecast.license.info
Runecast: licensed hosts cpus		DEPENDENT	runecast.license.info.licensed.hostcpus Preprocessing: - JSONPath: $.licensedHostCPUs
Runecast: licensed hosts		DEPENDENT	runecast.license.info.licensed.hosts Preprocessing: - JSONPath: $.licensedHosts
Runecast: unlicensed hosts cpus		DEPENDENT	runecast.license.info.unlicensed.hostcpus Preprocessing: - JSONPath: $.unlicensedHostCPUs
Runecast: unlicensed hosts		DEPENDENT	runecast.license.info.unlicensed.hosts Preprocessing: - JSONPath: $.unlicensedHosts
Runecast: vCenter info		HTTP_Agent	runecast.vcenter.info Preprocessing: - JSONPath: $.vcenters
Runecast: Analysis issues		DEPENDENT	runecast.analysis.issues["{#ANALYSIS_UID}"] Preprocessing: - JSONPath: $.[?(@.uid== "{#ANALYSIS_UID}")].issues.first() - DISCARD_UNCHANGED_HEARTBEAT: 6h
Runecast: Analysis scan status		DEPENDENT	runecast.analysis.scanstatus["{#ANALYSIS_UID}"] Preprocessing: - JSONPath: $.[?(@.uid== "{#ANALYSIS_UID}")].scanStatus.status.first()
Runecast: last analysis scan		DEPENDENT	runecast.analysis.scantimestamp["{#ANALYSIS_UID}"] Preprocessing: - JSONPath: $.[?(@.uid== "{#ANALYSIS_UID}")].scanStatus.timestamp.first()
Runecast: License allowed CPUs		DEPENDENT	runecast.license.detail.allowedcpus["{#LICENSE_ID}"] Preprocessing: - JSONPath: $.licenses.[?(@.id== "{#LICENSE_ID}")].allowedCPUs.first() - DISCARD_UNCHANGED_HEARTBEAT: 6h
Runecast: License used CPUs		DEPENDENT	runecast.license.detail.usedcpus["{#LICENSE_ID}"] Preprocessing: - JSONPath: $.licenses.[?(@.id== "{#LICENSE_ID}")].usedCPUs.first()
Runecast: License valid until		DEPENDENT	runecast.license.detail.validuntil["{#LICENSE_ID}"] Preprocessing: - JSONPath: $.licenses.[?(@.id== "{#LICENSE_ID}")].validUntil.first()
Runecast: {#VCENTER_ADDR}: plugin installed		DEPENDENT	runecast.vcenter.rcplugin.installed["{#VCENTER_ADDR}"] Preprocessing: - JSONPath: $.[?(@.address == "{#VCENTER_ADDR}")].webClientPluginStatus.installed.first()
Runecast: {#VCENTER_ADDR}: plugin latest		DEPENDENT	runecast.vcenter.rcplugin.latest["{#VCENTER_ADDR}"] Preprocessing: - JSONPath: $.[?(@.address == "{#VCENTER_ADDR}")].webClientPluginStatus.latest.first()
Runecast: {#VCENTER_ADDR}: plugin version		DEPENDENT	runecast.vcenter.rcplugin.version["{#VCENTER_ADDR}"] Preprocessing: - JSONPath: $.[?(@.address == "{#VCENTER_ADDR}")].webClientPluginStatus.version.first()

Triggers

Appropriate triggers are associated with the items

Feedback

Please report any issues with the template here in the "Issues" tab.

ToDo

1. monitor Issue events/details