API XML

[Former user]

Hello, i've got a little question about API monit.

The "monit status" command line give some textual informations about status, monitoring status, monitoring mode. These informations is different if it's about service or filesystem.

The API (http://192.168.151.237:2812/_status?format=json) doesn't give result json format, then i use this one instead : http://192.168.151.237:2812/_status?format=xml.

Is there a way to get information about different values of these elements :

monitorstate (Monitoring Status) monitormode (Monitoring mode) status (Status)

I mean, api give 0, 1, 2, 3.... code, what is the correspondence in text ?

Thanks for your help

[Tildeslash]

Hello,

the XML interface is documented just in the source code, you can check the src/http/xml.c file and related header files (src/monit.h).

Best regards, The Monit team

[plegrand]

Sorry to insist but i cant find the different value that can take the "status" element. In "monit service manager", i can see for example "Running" or "Accessible". But in the xml it's only number.

In fact i found on internet that :

service[$i]->monitor
0: Off
1: On
2: Initializing
3: Waiting

service[$i]->monitormode
0: Active
1: Passive
2: Manual

I would like to know the same for System, Process, FileSystem service[$i]->status

and i cant find it inside the file you propose. Thanks for your help

[Tildeslash]

The text in CLI is generated by these functions: https://bitbucket.org/tildeslash/monit/src/cdc99f0475a45e76a4bc73be30380a2b2c516a75/src/http/cervlet.c#cervlet.c-2534 https://bitbucket.org/tildeslash/monit/src/cdc99f0475a45e76a4bc73be30380a2b2c516a75/src/http/cervlet.c#cervlet.c-2583

[plegrand]

Thanks for your answer but in this function, i cant see the strings

"Running" for system status
"Running " for process status
"Accessible" for FileSystem status

Where these strings are defined and where the correspondence between codes and strings are defined also.

Thanks again for your help

[Tildeslash]

you have probably older monit version, the latest prints just "OK" if the service has no errors. If you need to see how it's generated, see the source code of the corresponding monit version

[plegrand]

Yes i've got 5.20 version. I see in "monit-5.20.0/src/monit.c" on line 142 the different value of "statusname" :

char *statusnames[] = {"Accessible", "Accessible", "Accessible", "Running", "Online with all services", "Running", "Accessible", "Status ok", "UP"};

Does it means that status is always "positive" ?

Thanks again

[Tildeslash]

No, the statusnames was just used when there was no error. When the service has some error, the status is composed of event description (the events are set in the s->error bitmap): https://bitbucket.org/tildeslash/monit/src/cdc99f0475a45e76a4bc73be30380a2b2c516a75/src/http/cervlet.c#cervlet.c-2583

[plegrand]

thanks again for your answers. just the last ;-) what is the meaning of "bitmap", my English is little poor. Is there a list of events status ?
i understand that "<status>0</status>" means status OK. But status can have other value ?

It will be my last question Thanks again for your help

[Tildeslash]

https://en.wikipedia.org/wiki/Bit_field

[plegrand]

that means it's a file ? then what is the name of this file ?

[Tildeslash]

no, the s->error is uint32_t variable and is used as a 32-bit bitmap, where each bit corresponds to specific event. If that bit is set to 1, the given error is active (0 = no problem).

In the case that the service has some error, monit walks this bitmap and add the event description to the status text. You can see the event definition in src/event.c and src/event.h

[plegrand]

Thanks for all your answers . It's OK for me now. Thanks again. You can close this issue now.