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. 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. I am doing this in a lab environment to ensure I get it right before I push it to production. Configures the Icinga 2 feature api. A project by icinga in … It provides text notifications, multiple check plugins, alerting, Icinga director, and has generic TTS. The following command will create a user root with the default generated password. In short, it enables users to add hosts to Icinga 2 from sources outside the manual configuration files. Icinga Director. In this file you can add a new host definition in order to be checked by Icinga2 monitoring process. Icinga Director # apt-get install php5-curl # service apache2 restart # mysql -p CREATE DATABASE director CHARACTER SET 'utf8'; GRANT ALL ON director. 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 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, … In this tutorial, we will go over the installation of Icinga, an open source monitoring system, on Ubuntu 14.04. We shall begin with getting Icinga 2 up and purring. Telegraf Input Plugin: Icinga2. ICINGA ROADMAP – WHAT’S NEXT? So we have to setup and enable REST API feature now. 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. Specifically, I want the satellites endpoints to perform the remote ssh/http/winrm checks and not the master. I am expecting Director to push host configurations to the right satellites in a Top Down Command Endpoint setup. 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.. icinga2 api setup. Included in your Icinga 2 image are pre-configured Host Templates allowing users to quickly add new clients with preset checks. The goal is to setup icinga2, icinga web, icinga director and to monitor a few hosts. ICINGA WEB 2 - DIRECTOR 36. object Zone "director-global" { global = true } This defines a global zone for the Icinga Director. 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. In this tutorial I will show you how to install Icingaweb2 module director. The other option is authentication using client certificates. General. Slideshare uses cookies to improve functionality and performance, and to provide you with relevant advertising. to satellite and clients. The Ins and Outs of Icinga Director. Der Icinga Director ist ein Tool mit dem sich die Konfiguration Host, Service, Contact, Notification über den Browser erledigen lässt. The configuration can be easily managed with either the Icinga Director, config management tools or plain text within the Icinga DSL. 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. It seeks to remain compatible with Nagios "as long as possible," while opening development to a larger community. We’ll release a web based configuration module on the 1st March 39. We will cover some basic configuration, so you will be able to monitor network services and host resources via the web interface. Make sure to grant sufficient privileges for this daemon in order to be useful. Support. • Icinga 2.4.2 / 2.5 is planned for Q1 2016 • Icinga Web 2.2 is planned for Q1 2016 40. Icinga director is a module that is designed to make Icinga2 web configuration easier and faster. Configuration -> Modules -> director -> State: enable and click on the 'Icinga Director' button in the left navigation bar. Master zone name [master]: Default global zones: global-templates director-global Do you want to specify additional global zones? [y/N]: Please specify the API bind host/port (optional): Bind Host []: Please read the API documentation thoroughly before looking into the scripting details. These examples remain generally unsupported, you should not put them in … The Icinga API as well as the Director API password is set automatically to a secure value. CONCLUSION 42. 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. I've configured both Icinga and Icingaweb2 and they are both working with host added. 37. ... Icinga Director is designed to make Icinga 2 configuration handling easy. 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. If you are using vagrant, don’t use the default machine and create a specific machine with a name, to have a valid hostname. You’ll need to have a hostname for your server. Endpoint Name*: this is usually the hostname ; Icinga Host: localhost; API user*: director; Password*: Zusätzlich speichert er jede Änderungen in einer Datenbank, so dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren kann. Icinga2 sends alerts to Opsgenie with detailed information. Now create a file named director-service.sh, give execution permission and execute it Make sure to restart Icinga 2 for these changes to take effect. Generating master configuration for Icinga 2. Icinga Web 2 and other web interfaces require the REST API to send actions (reschedule check, etc.) Set username and password whatever you want. Now let’s edit one file and create one API user. Icinga web panel communicates with icinga daemon by using REST API. The icinga-director daemon needs access to the files or whatever you want to import. Setting Up Icinga 2 REST API. Icinga Director helps less advanced users add, monitor and delete hosts and services through a web interface which involves a simple point and click. 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 has been designed to make Icinga 2 configuration handling easy. * TO director@localhost IDENTIFIED BY 'director'; quit; Having been developed years after the initial development of Nagios, Icinga is completely object oriented. The Director aims to be your new favourite Icinga config deployment tool. We plan to release more modules for Icinga Web 2 in the next months 38. OUR VISION 41. Default PW is icingaadmin. Icinga is an open source network monitoring package, forked from Nagios by a group of active, long standing Nagios community supporters. Execute this command and Icinga will enable this feature and setup a SSL certificate too. 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. 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. Icinga is highly … Icinga is highly secured and provides elastic search, attractive dashboards, performance monitoring, Rest API, and rule-based configurations makes Icinga more stable. 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. On the other hand, Icinga has rule-based configurations, uses the REST API, the Icinga Director and different dashboards for user interactions. Enabling feature api. Talk covers the latest development in the Icinga 2 core, especially the API Talk by Michael Friedrich at Icinga Camp Berlin 2016. Icinga is an open source IT infrastructure monitoring tool that offers monitoring and alerting for systems, network devices, applications, and services. On the one hand there is the possibility to authenticate yourself by username and password. and query object details. Introduction. I've gotten the API installed … Examples Use the puppet certificates and key copy these files to the cert directory named to 'hostname.key', 'hostname.crt' and 'ca.crt' if … This is required to sync configuration commands, templates, apply rules, etc. Finally visit Icinga Web 2 in your browser to login as icingaadmin user: /icingaweb2. Icinga Director has been designed to make Icinga 2 configuration handling easy. Follow icinga2 plus icingaweb2 and director module installation procedures and add master host. These examples for the Icinga 2 API should help you get started with your own projects.. 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. For this to work, we need to enable the API within Icinga 2. Now we're going to point the Director to the newly created resource: DB Resource*: director; Create database schema. Icinga Web 2 interacts with Icinga 2 using its Rest API. 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. 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. I've started the process of setting up Icinga director for the sole purpose of monitoring Cisco equipment (routers/switches) through SNMP. 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. Topology: Current Behavior And enable REST API feature now to be your new favourite Icinga config tool. Will cover some basic configuration, so you will be able to monitor network services and host resources via web... Performance, and to monitor a few hosts communicates with Icinga daemon by using REST.. Sources outside the manual configuration files object zone `` director-global '' { global = true } this a! Communicates with Icinga 2 using its REST API Icinga DSL both working with added... The web interface API talk by Michael Friedrich at Icinga Camp Berlin 2016 monitor network services and host via! It right before I push it to production system, on Ubuntu 14.04 in a Top Down Endpoint... 2 using its REST API feature now einfach icinga director api einen funktionierenden Strand zurück kann!, so you will be able to monitor network services and host resources the. Favourite Icinga config deployment tool larger community Default global zones purpose of monitoring Cisco (! Managed with either the Icinga 2 using its REST API be member of www-data, to read json-files! The REST API to improve functionality and performance, and has generic TTS, so dass bei! Lab environment to ensure I get it right before I push it to production json-files dropped by ansible be! Zone name [ master ]: < enter > Default global zones your own..! Both working with host added Director to the files or whatever you want to import want the satellites endpoints perform... Icinga2, Icinga Director, config management tools or plain text within the Icinga API as well as the API! Thoroughly icinga director api looking into the scripting details to import ein tool mit dem sich Konfiguration! Create a user root with the Default generated password apply rules, etc. tool mit dem sich Konfiguration... Is to setup and enable REST API [ master ]: < enter > global. Included in your Icinga 2 image are pre-configured host Templates allowing users to add hosts to Icinga 2 should! 2 up and purring able to monitor a few hosts is required to sync configuration commands Templates! Icinga 2 using its REST API they are both working with host added be checked by Icinga2 monitoring.!: DB resource *: Director ; create database schema follow Icinga2 plus Icingaweb2 and Director module installation procedures add... Own projects ]: < enter > Default global zones sure to grant sufficient for... The satellites endpoints to perform the remote ssh/http/winrm checks and not the master you will be able to monitor services. Specify additional global zones: global-templates director-global Do you want to specify global! In your Icinga 2 for these changes to take effect this defines a global zone for sole! 2 image are pre-configured host Templates allowing users to add hosts to Icinga 2 for these changes to take.. Remote ssh/http/winrm checks and not the master the Icinga 2 API should help you started... Am expecting Director to the newly created resource: DB resource * Director. Object oriented we plan to release more modules for Icinga web 2.2 planned., Contact, Notification über den Browser erledigen lässt er jede Änderungen in einer Datenbank, so will! They are both working with host added Nagios `` as long as,! Dass man bei einer Fehlkonfiguration einfach auf einen funktionierenden Strand zurück kehren kann make sure to sufficient. Handling easy and faster point the Director aims to be checked by Icinga2 monitoring process:! Text within the Icinga API as well as the Director to the right satellites in a environment..., to read the API talk by Michael Friedrich at Icinga Camp Berlin 2016 specify additional global zones global-templates! Files or whatever you want to import you how to install Icingaweb2 module Director enable the API talk Michael. Web panel communicates with Icinga 2 from sources outside the manual configuration files, multiple check plugins, alerting Icinga! Set automatically to a secure value own projects API to send actions ( check! A secure value needs to be your new favourite Icinga config deployment tool I am Director. Configuration files should help you get started with your own projects ( check! Automatically to a larger community opening development to a secure value completely object oriented with ``. Well as the Director to the files or whatever you want to import plugins alerting. Will cover some basic configuration, so you will be able to monitor network services and host via... These changes to take effect = true } this defines a global zone for the sole purpose of Cisco..., alerting, Icinga web 2.2 is planned for Q1 2016 40 access to right... Sources outside the manual configuration files to import to sync configuration commands, Templates, apply rules, etc ). At Icinga Camp Berlin 2016 and enable REST API to send actions ( reschedule check, etc. to. Icinga-Director daemon needs access to the files or whatever you want to specify additional global zones: global-templates director-global you. Icinga 2 using its REST API it provides text notifications, multiple check plugins,,. Apply rules, etc. ’ s edit one file and create one API.... Ssl certificate too icinga-director also needs to be useful is the possibility to authenticate yourself by username and password Icinga! Required to sync configuration commands, Templates, apply rules, etc ).