Zabbix agent support for Notakey Authentication Appliance (NtkAA)

[Ingemārs Ašmanis]

Starting from CLI version 4.2.32 there is a possibility to run Zabix agent for monitoring NtkAA  services. This agent is based on stock zabbbix-agent  docker image from Zabbix LLC, alpine flavor.

Running agent

# First configure your zabbix server version
ntk cfg set zabbix.server_version 4.2

# Configure server address
ntk cfg set zabbix.server_fqdn zabbix.example.com

# Run update to load the correct version of agent
ntk sys update

# Start agent by running
ntk zbx start

Supported item keys

Keys that are reported by agent to zabbix server.

ntk.cluster.leader (string) - Reports leader node for NAA cluster in this datacenter (domain)

ntk.cluster.peercount (int) - Reports number of available nodes in NAA cluster in this datacenter (domain)

ntk.nas.v2.liccount (int) - Reports issued licence count in Notakey Authentication Server (NAS)

ntk.nas.v2.licused (int) - Reports issued licences issued in Notakey Authentication Server (NAS)

ntk.cluster.live (int) - Returns 1 if cluster container is running and quorum is reached (cluster is writable), otherwise 0

ntk.nas.live (int) - Returns 1 if NAS is running and responding to requests (this is the API provider container, not management), otherwise 0

ntk.sso.live (int) - Returns 1 if SSO container is running and responding to requests, 0 if there is a problem

ntk.ap.live (int) - Returns 1 if RADIUS proxy container is running and responding to requests, 0 if there is a problem

ntk.rp.live (int) - Returns 1 if reverse proxy container is running and responding to requests, otherwise 0

Additionaly standard alpine linux zabbix agent keys are supported.

Typical things to monitor include:

vfs.fs.size[/,pfree] (float) - Free disk percentage

vm.memory.size[pused] (float) - Free RAM memory, critical as there is no swap on NAA

system.cpu.load[,avg5] (float) - General CPU load

Disk IO load - https://share.zabbix.com/storage-devices/linux-disk-performance-monitoring or similar

Monitoring services
Monitor all services trigger expression in your Zabbix server:

{:ntk.nas.live.last()}<1 or {:ntk.sso.live.last()}<1 or {:ntk.cluster.live.last()}<1 or {:ntk.ap.live.last()}<1 or {:ntk.rp.live.last()}<1

Not all installations require running of all services, so adjust to your setup.

Documentation: http://docs.notakey.com/naa/#zabbix-agent-configuration

If you have any feedback or questions please leave comment below or reply to this message (your response will be publicly visible, except email address).