Moogsoft Docs

Configure Grafana Example

This document outlines how to install and configure an on-premise instance of Grafana alongside Moogsoft AIOps.

These instructions relate to Grafana v5.0.4. You may need to make changes if you are installing another version of Grafana.

Before You Begin

Before you begin to install and configure Grafana, ensure you have met the following requirements:

  • You have set up Moogsoft AIOps on RHEL /Centos 7. See Pre-install Moogsoft AIOps for details.

  • You have the SSL certificate used by Moogsoft AIOps.

  • You have the URL for Grafana. In this example configuration we can use the IP address of the Moogsoft AIOps machine. For example, 192.0.2.0.

Install Grafana

To begin the integration setup, install Grafana and enable SSL. For more information see the Grafana installation documentation.

  1. Connect to your Moogsoft AIOps instance and download the Grafana installation file:

    wget https://s3-us-west-2.amazonaws.com/grafana-releases/release/grafana-5.2.4-1.x86_64.rpm
  2. Install Grafana:

    sudo yum -y localinstall grafana-5.2.4-1.x86_64.rpm
  3. To enable SSL, edit the Grafana configuration file at /etc/grafana/grafana.ini. Remove the semicolons (;) used to comment properties in .ini files:

    Field

    Value

    protocol

    HTTPS

    root_url

    <Your full Grafana URL> https://<ip>:3000

    cert_file

    /etc/nginx/ssl/certificate.pem

    cert_key

    /etc/nginx/ssl/certificate.key

    For example:

    [server]
    protocol = https
    root_url = https://example.grafana.com:3000
    cert_file = /etc/nginx/ssl/mycertificate.pem
    cert_key = /etc/nginx/ssl/mycertificate.key

    The default port is 3000. If you want to configure a different port or change any of the other properties see the Grafana configuration documentation.

  4. Restart Grafana:

    service grafana-server restart

If you want to configure a custom base URL for your Grafana instance see Configure Grafana Base URL.

Install the App

You must install the "Moogsoft AIOps App" to connect Grafana to Moogsoft AIOps. For more information about the app see Moogsoft AIOps Plugin.

  1. To install the app for a local instance of Grafana, use this CLI command:

    grafana-cli plugins install moogsoft-aiops-app
  2. Restart the Grafana server:

    service grafana-server restart
Configure the App

After you have installed the app, configure it to pass data from Moogsoft AIOps to Grafana.

  1. Log in to your Grafana instance at https://<ip>:3000. The default login credentials are admin:admin.

  2. Navigate to Plugins and find the app.

  3. Edit the settings as follows:

    Field

    Value

    URL

    <your Moogsoft AIOps url>

    Username

    <Graze username>

    Password

    <Graze password>

    The default Graze credentials are graze:graze.

  4. Enable the app. A 'Test Success' message appears if successful.

After enabling the app, Moogsoft AIOps is automatically set up as a data source. If you want to change the data source later, you can edit Data Sources.