Use Graphite

Last updated 23th August, 2019

Objective

Graphite is the first Time Series platform with analytics capabilities. In this guide, you will learn how to use Graphite protocol with Metrics.

Requirements

• a valid OVH Metrics account.

Instructions

Compatibility

The Graphite API documentation is available at http://graphite-api.readthedocs.io/en/latest/api.html.

We are currently supporting this calls:

Data Model

Graphite's data model uses a dot-separated format that describes a metric name, e.g. :

 servers.srv_1.dc.gra1.cpu0.nice;

How to Push data

Since Graphite doesn't support authentication, we've developed a small proxy that fits on your host and accept pushes to TCP:2003 like Graphite.

It's named Fossil and it's Open Source.

How to query

Authentification

To query data to the platform, you will need a READ TOKEN. Use Basic Auth directly inside the URL to pass it properly, like this :

https://metrics:[READ_TOKEN]@graphite.[region].metrics.ovh.net

Query using curl

Queries over Graphite are performed with URL based query parameters, json payload or form payload.

The full documentation is available at http://graphite-api.readthedocs.io/en/latest/.

For example:

$ curl 'https://metrics:TOKEN_READ@graphite.gra1.metrics.ovh.net/render?target=maximumAbove(os.cpu, 1048576)'

To authenticate requests basic auth is used. You must fill the basic auth password with the read token available in your OVH Metrics Data Platform manager.

Go further

• Documentation: Guides
• Vizualize your data: https://grafana.metrics.ovh.net/login
• Community hub: https://community.ovh.com
• Create an account: Try it free!

Ces guides pourraient également vous intéresser...