Documentation OVH

Use InfluxDB

Get an overview on how to use InfluxDB for Metrics

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

API Method Supported
/write POST

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


Cette documentation vous a-t-elle été utile ?

Génial ! Ravi d'avoir pu vous aider.

Images, contenu, structure... N'hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !

Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..


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