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