Zabbix Dashboard - Quick Integration

Overview of this Guide

This guide is a walkthrough to install and get started with RealOpInsight and Zabbix in a few minutes using a virtual machine.

For other installation options, i.e. using binary packages or a Docker image, please read the Installation Guide.

At the end of this guide you will see how RealOpInsight provides easy yet powerful alternative Zabbix dashboards for federation and application operations monitoring.

Before you begin

The below steps assume that:

  • You have a running Zabbix installation with its JSON-RPC API enabled. Zabbix version 1.8 or higher is required.
  • You have a Zabbix user account (username, password) having a read access to all trigger items. For more details refer to Zabbix API documentation.

Launch a RealOpInsight Virtual Machine

The following steps describe how to install RealOpInsight using an OVF image on Oracle VirtulaBox. You can easily adapt the steps if you use a VMware virtualization tool instead.

  • Go to the release page and get the latest OVF distribution archive.
  • Unzip the distribution archive, you will obtain an OVA (Open Virtualization Appliance) file.
  • If not yet the case download and install VirtualBox.
  • Launch VirtualBox and select the menu File -> Import Virtual Appliance.
  • Browse your file system and select the OVA file of RealOpInsight.
  • Review the default virtual machine settings. You would likely consider to change the hardware requirements according to your needs (i.e. memory, CPU, network, etc).
  • Validate the importation and wait that the process completes. That may take a few minutes.

Inside the virtual machine, binaries, logs, and many other configuration files are located at /opt/realopinsight/.

Connect to RealOpInsight Interface

Once the virtual machine started, the RealOpinsight web interface can be accessed on on your local machine at http://<VM_ADDR>:4583/realopinsight/ (replace <VM_ADDR> by the IP address or the hostname of the virtual machine).

The default administrator credentials are admin/password.

For a production setup and must be kept secured the default password must be changed as quick as possible.

Integrate Zabbix as Monitoring Source

Proceed as follows in order to integrate Zabbix as a monitoring data source:

  • Log into RealOpInsight as administrator.
  • Select the menu Monitoring Sources to fill in the monitoring source settings.
  • Set the property Monitor Source Type to Zabbix.
  • Set the property Monitor API Base URL with the URL of Zabbix web interface (e.g. https://zabbix-server/zabbix/, assuming that Zabbix is installed on a server named zabbix-server and accessible over HTTPS).
  • Check the property Don't verify SSL certificate only if you use a self-signed certificate.
  • Set the property Auth String with a string username:password corresponding to the credentials to connect to your Zabbix API. Note the colon : between username and password.
  • Click on the button Add as source.
  • When prompted, select Source0 as Source Id.
  • Click on Apply to save the changes.
  • On success you shall see a message confirming that.

For this quickstart a single source is enough, but you can repeat the above steps to add as many Zabbix sources as you want.

Getting Started With Zabbix Dashboard

In this section we’ll show a basic use cases of RealOpinsight, and then provide you links to move forward with more advanced use cases.

Autodiscovery & Host Group-based Dashboards

As a first and very simple way to get started with RealOpInsight and Zabbix is to use the automatic discovery and mapping capabilities of host groups from Zabbix. Indeed, after a successful configuration of your Zabbix source, RealOpInsight will automatically discover all monitored host groups in Zabbix and use them to create infrastructure-focused operations dashboards organized as below.

hostgroup
  |
  +---host1
  |        |
  |        +--trigger1
  |        |
  |        +--trigger2  
  |        |
  |        +--...    
  +---host2
  |        |
  |        +--trigger1
  |        |
  |        +--trigger2  
  |        |
  |        +--trigger3  
  |        |
  |        +--...  
  |        
  |---...      

You must note the tree-based relationships, that’s the foundation what is called Application Dashboard in RealOpinsight terminology. You will be able to see how that works when going further in this document.

Executive Dashboard

Ultimately, RealOpInsight allows you to setup monitoring views per operator basis that can be watched at the highest level as below. Each icon is associated, via a click, to an Application Dashboard.

This high level view of a monitored environment is called Executive Dashboard in RealOpinsight terminology. In you setup host group-based dashboards, you will be able to have Executive Dashboards looking as hereafter. You will be able to see how that works when going further in this document.

It’s worth to note that, this automatic group discovery and mapping feature is a very basic way to build and operate operations monitoring views using RealOpInsight. Its Web Editor offers richer and advanced features to allow you to build specific and highly customizable service trees to address your specific operations monitoring needs.

First Steps with Application Dashboard

One of key visualization concepts that RealOpInsight introduces is Application Dashboard, as illustrated on the figure below. It provides to administrators and operations staffs a comprehensive view of an application platform through: a Service Tree and a Service Map that represent services along with their dependencies; a Message Panel where status messages related low level services are displayed. In short, an Application Dashboard provides a flexible tool that simplifies incident impact analysis.

Please read our Overview about Application Dashboard if you needed more details.

Preview Application Dashboard as Administrator

As administrator you can preview and check the Application Dashboard for any single operation view before assigning it for operations.

  • Log into RealOpInsight as administrator.
  • Select the menu Manage Operations Views to see the list of managed views.
  • Select the menu Preview.
  • Select an entry in the list of managed views (e.g. select the entry you created above).
  • Click on Apply to display the Application Dashboard.
  • Click on the button to refresh the views (service map, service tree, message panel).

On this example we can see that there are problem on three items. The impact of each event is easily is highlighted using the tree view, the service map and the event console.

First Steps with Executive Dashboard

As a user defined as Operator in RealOpInsight, you have access to an Executive Dashboard that acts as home page on login. The Executive Dashboard can consist of no, one, or many items as illustrated by the following screenshot. It’s organized like a grid with configurable number of columns. The items displayed in the Executive Dashboard should be explicitely assigned to the operator by a user having administrator role in RealOpInsight.

Please read our Introduction about Executive Dashboard if you need more details.

The rest of this section will describe how to create Executive Dashboards and use them.

Create a Operator User

  • Log into RealOpInsight as administrator.
  • Select the menu New User.
  • Fill in the user information:
    • Password must have at least six (6) characters in two classes (upper/lower cases, digits, special characters, etc.).
    • Ensure to select Operator as User Role.
    • The property Dashboard Tiles Per Row allows to set the number of columns for the Executive Dashboard.
  • Click on Submit to save the changes.

Assign Operations Views

  • Log into RealOpInsight as administrator.
  • Select the menu Manage Operations Views.
  • Select an operator in the user selection list at left.
  • Select one or several items in the list of business applications at the right.
  • Cick on Assign to apply the changes.

Operate Executive Dashboard

  • Log in as operator
  • On login the operator Executive Dashboard will be displayed with the items assigned to him.
  • You can select a tile to displat the associated Application Dashboard.
  • When an Application Dashboard is active, you can select Executive View to go back to the Executive Dashboard.

This is the end of this quickstart of RealOpInsight, please follow the below links to move forward with advanced use.