Using Grafana with Logs Data Platform

Last updated 27th July, 2020

Objective

Grafana provides a powerful and elegant way to create, explore, and share dashboards and data with your team and the world. Since release 2.5, Grafana is able to communicate with Elasticsearch and so allow you to mix data from Logs Data Platform and other data sources like IoT at the same place. This guide will show you how to achieve this.

Requirements

This is what you need to know to get you started:

  • you are already sending logs on a stream you own see the quick start tutorial
  • Your have access to the port 9200 to your cluster (head to the Home page in manager to know the address of your cluster).

After some training you will be able to create this kind of dashboard:

Grafana Dashboard

Instructions

Select your Stream Alias

To access your logs from Grafana, you will need to setup an Elasticsearch Alias and link them to your Graylog streams, so here we go again :

  1. Go back to your manager.
  2. In the Alias panel, click on the Add an alias button
  3. Choose a name and define a description for your alias
  4. Save the entry by clicking the Save button
  5. Once the alias has been created. Use the ... menu at the right and select Attach content to the alias option.
  6. Define there the graylog streams you want to associate to your alias
  7. That's it.

Alias creation

So here you go, now Logs Data Platform knows what stream you want to browse. Now let’s configure Grafana and see if it works!

Setup your own grafana

Get the latest Grafana release here: http://grafana.org/download/ (v7.1.1 2020-07-24 at the time of writing). Then follow the Grafana installation guide according your platform: http://docs.grafana.org/installation/

Launch it!

If everything is setup properly, launch your favorite browser, and point it to http://localhost:3000 Once logged in with your grafana credentials, reach data sources panel to setup your Logs Data Platform datasource:

Data source

To make the magic happens, please ensure to:

  • Set https://<your_cluster>.logs.ovh.com:9200 as Url value
  • Set your Logs Data Platform credentials for Basic auth values
  • Set your Logs Data Platform alias name as Grafana Index name value
  • Change default Time field name to timestamp
  • Set 6.0+ as Elasticsearch version
  • Register your data source and test it.

Test it!

Now let's add a simple counter of your logs to a new dashboard.

  1. On dashboard page, click on the green left button and select Add panel => Singlestat
  2. On the bottom right, select your datasource.
  3. That's it :)

If you want to know what you can do with Grafana and Elasticsearch, you can fly to the official documentation or to this very good resource: How to effectively use the Elasticsearch data source in Grafana and solutions to common pitfalls

Go further


Did you find this guide useful?

Please feel free to give any suggestions in order to improve this documentation.

Whether your feedback is about images, content, or structure, please share it, so that we can improve it together.

Your support requests will not be processed via this form. To do this, please use the "Create a ticket" form.

Thank you. Your feedback has been received.


These guides might also interest you...

OVHcloud Community

Access your community space. Ask questions, search for information, post content, and interact with other OVHcloud Community members.

Discuss with the OVHcloud community

In accordance with the 2006/112/CE Directive, modified on 01/01/2015, prices incl. VAT may vary according to the customer's country of residence
(by default, the prices displayed are inclusive of the UK VAT in force).