Nagios XI 5.7 API Documentation Help

This support forum board is for support questions relating to Nagios XI, our flagship commercial network monitoring solution.
Locked
HooverM
Posts: 3
Joined: Thu Jun 25, 2020 1:11 pm

Nagios XI 5.7 API Documentation Help

Post by HooverM »

I am new to Nagios XI and my group is looking to create an external web site using the API for status of specific hosts/services for specific groups.

I was looking into the API documentation and found I can pull back all the necessary information I need...BUT...I have no real definition to decipher it. I was wondering if there was any thorough documentation for using the new REST API. I looked under HELP > API Docs and it gives me the URL and an example of the return, but it doesn't tell me what the items mean or the possible results for them.
for example:

Host Status --
"current_state":"0"

I've seen before with the old CGI-BIN JSON there was an enumerate format option that could be used to get Up, Down, etc. but I have tried using &formatoptions=enumerate and that does not seem to be a valid option.

Any help would be appreciated.
User avatar
jbrunkow
Posts: 441
Joined: Fri Mar 13, 2020 10:45 am

Re: Nagios XI 5.7 API Documentation Help

Post by jbrunkow »

The API within XI interacts with objects defined in the Nagios core. I believe you will find the definitions you are looking for in the Nagios core documentation.

Possible state types in Nagios include OK, WARNING, UP, DOWN, and UNKNOWN. Please see the documentation linked below for a more in depth explanation.
NAGIOS STATE TYPES

You may also be interested to look at the object definitions page in the core docs.
OBJECT DEFINITIONS

I hope that helps! Let me know if I can answer any more questions.
As of May 25th, 2018, all communications with Nagios Enterprises and its employees are covered under our new Privacy Policy.

Be sure to check out our Knowledgebase for helpful articles and solutions!
HooverM
Posts: 3
Joined: Thu Jun 25, 2020 1:11 pm

Re: Nagios XI 5.7 API Documentation Help

Post by HooverM »

Thank you, this did help a lot, it lead me down the right path. I ended up coming across this page
https://assets.nagios.com/downloads/nag ... #hoststate

And that set me on the right path of what I was looking for --
My For Example:
$HOSTSTATEID$ A number that corresponds to the current state of the host: 0=UP, 1=DOWN, 2=UNREACHABLE.

Thank you again! I do appreciate the information and if I run into any further items I will come back to here for help!
User avatar
lmiltchev
Bugs find me
Posts: 13589
Joined: Mon May 23, 2011 12:15 pm

Re: Nagios XI 5.7 API Documentation Help

Post by lmiltchev »

I am glad your question has been answered! I am closing this topic. If you have any further questions, please start a new thread.
Be sure to check out our Knowledgebase for helpful articles and solutions!
Locked