Documentation for special agents

[auchri (Christoph)]

Hi,

I want to create a special agent for our ERP system. Is there already a documentation for special agents available for the new check-api in version 2.0? (I only found this one: https://checkmk.de/cms_devel_check_specialagent.html )

[athomaidis (anastasios)]

Hi Christoph,

as this question was asked several times, I will link two very good examples:

Create true custom Special Agent (NOT Individual program call instead of agent access)

Hello, many times on this forum I saw question about how to write some custom Special Agent, I searched this info as well by myself, finally I found very good tutorial with code examples if someone will be still interested in it:

and

Wie schreibt man an besten einen Check für eine REST API Abfrage

Hallo Zusammen nach etwas Abstinenz wieder mal da Folgendes wenn ich ein Gerät überwachen will und die Daten nicht via SNMP sondern via REST API abfragen will wie fange ich am besten an ??? Der allgemeine Ablauf ist ja so: CMK --[runs]–> script --[calls REST API]–> Host --[JSON answer]–> script --[converts to cmk format]–> CMK --[sends output]–> check plugin --[processes output]–> CMK --[creates]–> services <–[Parameters]-- WATO rule plugin Die Abfrage wäre ja z.B. curl -v -X …

Have fun

@fayepal maybe some input for our manual?

[athomaidis (anastasios)]

Credits to @Dirk and @gcp

[auchri (Christoph)]

Thanks!
Is it possible to create piggyback data for other hosts with my special agent?

[athomaidis (anastasios)]

Hi Christoph,

it is possible. The special agent for vsphere is returning piggyback data as well.

BR

Anastasios

[auchri (Christoph)]

Are there already examples (or migrated agents) for the new 2.0.0i version?

[andreas-doehler (Andreas)]

Normally you don’t have to change much.
If it is a python script you have only to change the header from “#!/usr/bin/env python” to “#!/usr/bin/env python3”
That was the only change if had done for my special agents.

[auchri (Christoph)]

Ok but later they should be changed to use the new CheckApi (or am i wrong?)

[andreas-doehler (Andreas)]

The special agent itself is only producing data output. Later the processing of this output will be done with the checks you wrote. These checks can then use the new CheckAPI. The old / classic checks should also work without bigger problems. I had only to modify the old “includes” to the normal “from … import *” like you have it in normal python scripts.