Grafana

Overview

Grafana is a multi-platform open-source analytics and interactive visualization web application. Entitle has self-hosted installation capabilities in the platform.

Entitle can manage the following resource types in Grafana:

• Teams - Admins and Members
• Organizations - Admins, Editors and Viewers

This page will provide you with instructions on how to integrate Entitle and Grafana.

General guidelines

To integrate your Grafana with Entitle, you will need the following information:

1. Your Host and Port in Grafana
2. The Username and Password of your admin account.

Prerequisites

• Please make sure that the Grafana user you wish to integrate with Entitle has Grafana Admin and Organization Admin permissions for every organization managed by the permissions. Below you will find step-by-step instructions to check that out and configure an admin account if needed.

Set up Grafana to work with Entitle

Stage 1: Extract the host and port

Surf to the login screen of your Grafana instance, and then extract the following values from the URL:

• The Host would be either a domain or an IP address on the left side of the URL.
• The Port is the number found on the right side of the URL, after the semicolon “:” (usually 3000).

Stage 2: Extract the username and password

Note: Please check that the Grafana user you wish to integrate with Entitle has Grafana Admin and Organization Admin permissions for every organization managed by the permissions before going forward with the integration.

In case the chosen user does not have these permissions, please create a New User (which will be explained in the next steps) and provide it with these permissions.

1. To check that your user has the required permissions, on the home page in the left-side menu, click the Server admin tab and choose Users from the available options.

2. Here, you will be able to view all of your users and check if they have the required permissions - Grafana Admin and Organization Admin.

In case you wish to change the permissions for any of your users in Grafana, click on the desired user, and under the Permissions section click the change button.

3. In case you need to create a new user, click the New User button at the Users screen fill in its Name, Email, Username, and Password fields, and then click Create user. Once done, follow the previous step to grant Grafana admin and organization Admin permissions.

4. In case your user has the two required permissions, copy and paste its Username and Password (whether from your existing user or the new user you created) in the connection JSON found later in this guide.

Creating the integration in Entitle

All that is left to do is create an integration on the Entitle application.

1. Log into Entitle and navigate to the Integrations page.
2. After clicking the Add Integration button, type Grafana in the Application field.
3. Don’t forget to set the Save on field with your configuration, i.e. your own hosted agent or Entitle’s cloud.

4. In the connection section JSON, host, and port fields - paste the values from stage 1.
5. In the username and password fields, paste the values from stage 2**, whether from your existing user from the new user you created.

Example connection JSON:

{
    "host": "<EXAMPLE_HOST>",
    "port": "<EXAMPLE_PORT>", (usually 3000)
    "username": "<EXAMPLE_username>"
	  "password": "<EXAMPLE_password>"
}

6. Click Save, you are done!🎉