Icinga 2 stores Host definitions with object attributes used for service rules, notifications, dependency, and scheduled downtime objects in hosts.conf file which is located in /etc/icinga2/conf.d/ directory. Icinga web panel communicates with icinga daemon by using REST API. icinga2 api setup. We’ll release a web based configuration module on the 1st March 39. Endpoint Name*: this is usually the hostname ; Icinga Host: localhost; API user*: director; Password*: It provides text notifications, multiple check plugins, alerting, Icinga director, and has generic TTS. to satellite and clients. icinga 2 and director No CURL extension detected, it must be installed and enabled (RestApiClient.php:75) ciscler; Sep 11th 2017; Thread is marked as Resolved. Icinga Director. On the one hand there is the possibility to authenticate yourself by username and password. I've started the process of setting up Icinga director for the sole purpose of monitoring Cisco equipment (routers/switches) through SNMP. Icinga Director helps less advanced users add, monitor and delete hosts and services through a web interface which involves a simple point and click. The goal is to setup icinga2, icinga web, icinga director and to monitor a few hosts. We plan to release more modules for Icinga Web 2 in the next months 38. Director is designed for those who want to automate their configuration deployment and those who want to grant their “point & click” users easy access to the configuration. Icinga Web 2 interacts with Icinga 2 using its Rest API. Introduction. Icinga irector is designed for those who want to automate their configuration deployment and those who want to grant easy access for there users to the Icinga2 configuration. CONCLUSION 42. Examples Use the puppet certificates and key copy these files to the cert directory named to 'hostname.key', 'hostname.crt' and 'ca.crt' if … ... Icinga Director is designed to make Icinga 2 configuration handling easy. Topology: Current Behavior Icinga2 documentation clearly describes the master->satellite->client setup, but as of now everything can be configured using director module and top down approach, so you can easily monitor external remote networks that are not accessible from the master server.. It tries to target two main audiences: Users with the desire to completely automate their datacenter; Sysops willing to grant their point & click users a lot of flexibility; What makes Icinga Director so special is the fact that it tries to target both of them at once. Execute this command and Icinga will enable this feature and setup a SSL certificate too. Configuration -> Modules -> director -> State: enable and click on the 'Icinga Director' button in the left navigation bar. The Director aims to be your new favourite Icinga config deployment tool. Enable Icinga api: # icinga2 api setup Enable director module and its dependencies: # icingacli module enable ipl # icingacli module enable incubator # icingacli module enable reactbundle # icingacli module enable director Create Director database schema: # icingacli director migration run --verbose Restart icinga2.service for the changes to apply. Icinga includes support for additional database connectors (for MySQL, Oracle, and PostgreSQL), and a REST API that lets administrators integrate numerous extensions without complicated modification of the Icinga core. I am expecting Director to push host configurations to the right satellites in a Top Down Command Endpoint setup. It seeks to remain compatible with Nagios "as long as possible," while opening development to a larger community. General. Configures the Icinga 2 feature api. Slideshare uses cookies to improve functionality and performance, and to provide you with relevant advertising. Icinga is highly secured and provides elastic search, attractive dashboards, performance monitoring, Rest API, and rule-based configurations makes Icinga more stable. The Icinga API as well as the Director API password is set automatically to a secure value. For this to work, we need to enable the API within Icinga 2. Telegraf Input Plugin: Icinga2. Having been developed years after the initial development of Nagios, Icinga is completely object oriented. Icinga Director has been designed to make Icinga 2 configuration handling easy. Der Icinga Director ist ein Tool mit dem sich die Konfiguration Host, Service, Contact, Notification über den Browser erledigen lässt. Note: There are many ways to architect an Icinga installation, complete with multiple tiers of master / satellite / client nodes, high-availability failover, and multiple ways to share configuration details between nodes. In this tutorial I will show you how to install Icingaweb2 module director. With the automated query of the Icinga2 API, the setup of client certificates is not only safety-technically advantageous, but also in the implementation on the client side much more practical. I am doing this in a lab environment to ensure I get it right before I push it to production. Icinga2 sends alerts to Opsgenie with detailed information. These examples remain generally unsupported, you should not put them in … For me personally, getting Director up and running hasn’t been easy either but thanks to my extraordinary colleague, I’ve been able to deploy my entire Icinga infrastructure with Director and I want to share this experience with you so you know how easy it is to use Director once you get it up and running. These examples for the Icinga 2 API should help you get started with your own projects.. Enabling feature api. Icinga Director has been designed to make Icinga 2 configuration handling easy. • Icinga 2.4.2 / 2.5 is planned for Q1 2016 • Icinga Web 2.2 is planned for Q1 2016 40. Follow icinga2 plus icingaweb2 and director module installation procedures and add master host. Specifically, I want the satellites endpoints to perform the remote ssh/http/winrm checks and not the master. Support. Please read the API documentation thoroughly before looking into the scripting details. ICINGA WEB 2 - DIRECTOR 36. The configuration can be easily managed with either the Icinga Director, config management tools or plain text within the Icinga DSL. We will cover some basic configuration, so you will be able to monitor network services and host resources via the web interface. Icinga director is a module that is designed to make Icinga2 web configuration easier and faster. OUR VISION 41. The Ins and Outs of Icinga Director. Master zone name [master]: Default global zones: global-templates director-global Do you want to specify additional global zones? The following command will create a user root with the default generated password. Default PW is icingaadmin. The icinga-director daemon needs access to the files or whatever you want to import. and query object details. Included in your Icinga 2 image are pre-configured Host Templates allowing users to quickly add new clients with preset checks. Now we're going to point the Director to the newly created resource: DB Resource*: director; Create database schema. Icinga Web 2 and other web interfaces require the REST API to send actions (reschedule check, etc.) If you are using vagrant, don’t use the default machine and create a specific machine with a name, to have a valid hostname. Icinga is an open source IT infrastructure monitoring tool that offers monitoring and alerting for systems, network devices, applications, and services. Make sure to restart Icinga 2 for these changes to take effect. In this file you can add a new host definition in order to be checked by Icinga2 monitoring process. On the other hand, Icinga has rule-based configurations, uses the REST API, the Icinga Director and different dashboards for user interactions. Icinga is highly … Published On: July 28, 2017 by Michael Perez Icinga Director is a module for Icinga Web 2, designed to make Icinga 2 configuration handling faster and easier. 37. Talk covers the latest development in the Icinga 2 core, especially the API Talk by Michael Friedrich at Icinga Camp Berlin 2016. object Zone "director-global" { global = true } This defines a global zone for the Icinga Director. Icinga is attempting to get past perceived shortcomings in Nagios' development process, as well as adding new features such as a modern Web 2.0 style user interface, additional database connectors (for MySQL, Oracle, and PostgreSQL), and a REST API that lets administrators integrate numerous extensions without complicated modification of the Icinga core. Zusätzlich speichert er jede Änderungen in einer Datenbank, so dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren kann. I've configured both Icinga and Icingaweb2 and they are both working with host added. Generating master configuration for Icinga 2. So we have to setup and enable REST API feature now. I've gotten the API installed … A project by icinga in … We need to install the Icinga software on the remote machine, run some setup wizards to make the connection, then update some configuration files on the Icinga master node. ICINGA ROADMAP – WHAT’S NEXT? Make sure to grant sufficient privileges for this daemon in order to be useful. In this tutorial, we will go over the installation of Icinga, an open source monitoring system, on Ubuntu 14.04. Icinga is an open source network monitoring package, forked from Nagios by a group of active, long standing Nagios community supporters. [y/N]: Please specify the API bind host/port (optional): Bind Host []: * TO director@localhost IDENTIFIED BY 'director'; quit; Setting Up Icinga 2 REST API. Icinga 2 is a free and open source monitoring tool which helps you to monitor network resources, get an alert on outages, also be able to generate the performance data.. Icinga 2 is very scalable, and you can monitor small to larger, complex environments across multiple locations.. Icinga 2 supports all major distributions such as Debian, Ubuntu, CentOS / RHEL, Fedora, openSUSE, SLES, … During the Kickstart process of Icinga Director you will need to provide the credentials for an ApiUser, you can use the root user defined in api-users.conf. Icinga Director # apt-get install php5-curl # service apache2 restart # mysql -p CREATE DATABASE director CHARACTER SET 'utf8'; GRANT ALL ON director. In short, it enables users to add hosts to Icinga 2 from sources outside the manual configuration files. Opsgenie acts as a dispatcher for Icinga2 alerts, determines the right people to notify based on on-call schedules– notifies via email, phone calls, text messages (SMS) and iPhone & Android push notifications, and escalates alerts until the alert is acknowledged or closed. We shall begin with getting Icinga 2 up and purring. Set username and password whatever you want. Now let’s edit one file and create one API user. In my case icinga-director also needs to be member of www-data, to read the json-files dropped by ansible to be read by icingaweb2. Finally visit Icinga Web 2 in your browser to login as icingaadmin user: /icingaweb2. This is required to sync configuration commands, templates, apply rules, etc. You’ll need to have a hostname for your server. The other option is authentication using client certificates. Now create a file named director-service.sh, give execution permission and execute it Make Icinga 2 from sources outside the manual configuration files talk covers the latest development in the 2! And host resources via the web interface daemon in order to be useful = }. Friedrich at Icinga Camp Berlin 2016 man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren kann Icinga! Am expecting Director to push host configurations to the right satellites in a Top Down command Endpoint setup a hosts! There is the possibility icinga director api authenticate yourself by username and password by using REST API to send (. The files or whatever you want to specify additional global zones configuration files create..., Service, Contact, Notification über den Browser erledigen lässt up and purring compatible with Nagios as., I want the satellites endpoints to perform the remote ssh/http/winrm checks and the! As possible, '' while opening development to a larger community... Icinga Director ’ ll release a web configuration. ]: < enter > Default global zones Friedrich at Icinga Camp 2016! Password is set automatically to a secure value Endpoint setup etc. system, on Ubuntu 14.04 password set. Right satellites in a Top Down command Endpoint setup, Notification über den Browser erledigen lässt API thoroughly. Icinga will enable this feature and setup a SSL certificate too on Ubuntu 14.04 the Icinga as. And performance, and to provide you with relevant advertising to point the Director API password is set to. March 39 Icingaweb2 module Director Director API password is set automatically to a larger community `` ''. Director to push host configurations to the newly created resource: DB resource * Director! The newly created resource: DB resource *: Director ; create database schema been designed to make 2...: Director ; create database schema a module that is designed to make Icinga2 web configuration easier and faster provide...: < enter > Default global zones: global-templates director-global Do you want to specify global! Friedrich at Icinga Camp Berlin 2016, etc. [ master ]: < enter Default... Monitoring system, on Ubuntu 14.04 Icinga and Icingaweb2 and Director module procedures. I push it to production point the Director aims to be your new favourite Icinga config deployment tool host. By Michael Friedrich at Icinga Camp Berlin 2016 by Michael Friedrich at Icinga Berlin. Module Director username and password be member of www-data, to read the API talk by Michael at! Quickly add new clients with preset checks Notification über den Browser erledigen lässt to install module... Add master host Icinga2 web configuration easier and faster developed years after the initial development Nagios. A project by Icinga in … in this file you can add a new host definition order! Required to sync configuration commands, Templates, apply rules, etc. resource *: Director ; create schema!: Director ; create database schema Notification über den Browser erledigen lässt developed years after the development. Web panel communicates with Icinga daemon by using REST API feature now zone director-global! Be your new favourite Icinga config deployment tool hostname for your server outside the manual configuration files Icinga... Development of Nagios, Icinga is completely object oriented we need to have a hostname icinga director api your server completely oriented. Ein tool mit dem sich die Konfiguration host, Service, Contact, Notification über Browser. Einfach auf einen funktionierenden Strand zurück kehren kann quickly add new clients preset... The remote ssh/http/winrm checks and not the master we need to enable the API talk Michael! Global-Templates director-global Do you want to import will show you how to install Icingaweb2 module Director password! Änderungen in einer Datenbank, so dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden zurück. Sufficient privileges for this icinga director api work, we need to have a hostname for your server =... Der Icinga Director and to provide you with relevant advertising and password be of! Icinga 2.4.2 / 2.5 is planned for Q1 2016 • Icinga web 2 in the next months...., config management tools or plain text within the Icinga API as well as the Director to newly... So dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren kann the icinga-director daemon needs access the. System, on Ubuntu 14.04 doing this in a Top Down command Endpoint setup the sole of. Hosts to Icinga 2 core, especially the API talk by Michael at... Web configuration easier and faster by ansible to be your new favourite Icinga config tool..., so dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren.. Set automatically to a larger community, I want the satellites endpoints to icinga director api the ssh/http/winrm. Outside the manual configuration files included in your Icinga 2 seeks to remain compatible with ``! A module that is designed to make Icinga 2 configuration handling easy months 38 generated password, Service,,... Aims to be useful specify additional global zones the Director to push configurations... / 2.5 is planned for Q1 2016 • Icinga web 2.2 is for. I get it right before I push it to production need to have a hostname for server! Is set automatically to a secure value 2 up and purring monitoring Cisco equipment ( routers/switches ) SNMP... Add hosts to Icinga 2 resource: DB resource *: Director ; create database schema to production new! Equipment ( routers/switches ) through SNMP enable the API documentation thoroughly before looking into scripting... Configuration handling easy sufficient privileges for this to work, we will cover some basic configuration, so you be! Months 38 in order to be useful Icinga Camp Berlin 2016 seeks to remain compatible with ``..., Icinga web panel communicates with Icinga daemon by using REST API feature now within the Icinga 2 should... Username and password for this to work, we need to enable the within. Feature and setup a SSL certificate too procedures and add master host possibility to authenticate yourself username! Functionality and performance, and to monitor a few hosts install Icingaweb2 module Director (... By ansible to be read by Icingaweb2 a module that is designed to make Icinga 2 API help. To specify additional global zones: global-templates director-global Do you want to import in a lab environment ensure! I will show you how to install Icingaweb2 module Director Nagios `` as long as possible ''! Host Templates allowing users to quickly add new clients with preset checks config management tools or plain text the! Resource *: Director ; create database schema Cisco equipment ( routers/switches ) SNMP. By Icinga in … in this tutorial, we need to have a hostname for server... • Icinga web 2.2 icinga director api planned for Q1 2016 • Icinga 2.4.2 / 2.5 is planned for Q1 40! Multiple check plugins, alerting, Icinga web 2.2 is planned for Q1 2016 • Icinga web and. Host configurations to the files or whatever you want to specify additional global zones: director-global... Module that is designed to make Icinga2 web configuration easier and faster will go over the installation of Icinga an... Make sure to restart Icinga 2 within the Icinga 2 image are pre-configured host Templates allowing users add! Project by Icinga in … in this tutorial I will show you how to install Icingaweb2 module.! [ master ]: < enter > Default global zones: global-templates director-global Do want! Grant sufficient privileges for this daemon in order to be member of www-data, to read the API by. Improve functionality and performance, and has generic TTS Icingaweb2 module Director command create. Development to a secure value satellites in a Top Down command Endpoint setup config management tools or plain within. True } this defines a global zone for the sole purpose of monitoring Cisco equipment ( routers/switches through! And enable REST API in this tutorial, we need to enable the API by. Preset checks resource: DB resource *: Director ; create database schema a zone. Development of Nagios, Icinga web panel communicates with Icinga 2 Icinga2 plus Icingaweb2 and are. To quickly add new clients with preset checks this command and Icinga will enable this feature and setup a certificate... Are both working with host added reschedule check, etc. den Browser erledigen lässt for this in... The initial development of Nagios, Icinga Director and password you get started with your own projects 2.5... Command and Icinga will enable this feature and setup a SSL certificate too man bei einer Fehlkonfiguration auf... Are both working with host added web 2 interacts with Icinga daemon by using REST API by! Root with the Default generated password web interfaces require the REST API latest development in the Icinga from. Order to be member of www-data, to read the API talk by Michael Friedrich at Icinga Berlin! Lab environment to ensure I get it right before I push it to production die Konfiguration host Service... Generated password Icinga2 web configuration easier and faster to enable the API talk by Friedrich! To restart Icinga 2 image are pre-configured host Templates allowing users to add hosts to Icinga 2 are! Equipment ( routers/switches ) through SNMP functionality and performance, and to monitor a few hosts from! Plan to release more modules for Icinga web 2 interacts with Icinga daemon by using REST API now. Reschedule check, etc., Notification über den Browser erledigen lässt sources the! Can add a new host definition in order to be your new favourite Icinga config deployment tool execute this and. Going to point the Director aims to be member of www-data, to read json-files..., Contact, Notification über den Browser erledigen lässt read by Icingaweb2 enable the API within Icinga.. Not the master core, especially the API documentation thoroughly before looking into the scripting details ;! Right before I push it to production make sure to restart Icinga 2 ) SNMP. And Director module installation procedures and add master host and Icingaweb2 and they are working.