Use InfluxDB

Last updated 23th August, 2019

Objective

InfluxDB is a proprietary time series database that integrates the open source collector Telegraf. In this guide, you will learn how to push using the Influx protocol with Metrics.

Requirements

• a valid OVH Metrics account.

Instructions

Compatibility

InfluxDB has the notion of databases. This concept doesn't exist within Metrics. If you need segmentation, you can use different Metrics project or isolate with an additional label.

Metrics currently doesn't support Influx Query Language.

Data Model

InfluxDB uses it own data model :

 <measurement>[,<tag_key>=<tag_value>[,<tag_key>=<tag_value>]] <field_key>=<field_value>[,<field_key>=<field_value>] [<timestamp>]

How to push data

The full documentation is available at https://docs.influxdata.com/influxdb/v1.2/guides/writing_data/

Authentification

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

https://metrics:[WRITE_TOKEN]@influxdb.[region].metrics.ovh.net

Pushing datapoints using curl

 $ curl -i -XPOST \
     'https://DESC:TOKEN_WRITE@influxdb.gra1.metrics.ovh.net/write' \
     --data-binary \
     'cpu_load_short,host=server01,region=us-west value=0.64 1434055562000000000'

How to query data

InfluxDB has its own Query DSL, that mimics SQL without being plain ANSI SQL.

 SELECT <field_key>[,<field_key>,<tag_key>] FROM <measurement_name>[,<measurement_name>]

Metrics currently doesn't support yet Influx Query Language.

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...