Documentation OVH

Overview of supported protocols

Get an overview on supported protocols for Metrics

Last updated 15th May, 2018

Choose yours, no vendor lock-in!

Metrics is protocol agnostic, it means that you can push your data with OpenTSDB, and query it with Warp 10™ or vice versa. Metrics doesn't enforce you to a proprietary protocol. Instead, we believe the plurality of existing protocols from Open Source solutions can be used to achieve Pushing and Querying the platform.

Supported protocols

Each protocol provides different capabilities. Some will be easier than others but may have less features. We've tried to summary them with this simple table :

Protocol Push Query Protocol documentation Features Corresponding Open Source project
Graphite Metrics Graphite
InfluxDB Metrics Influx
Metrics2.0 Metrics 2.0 spec
OpentSDB Metrics OpenTSDB
Prometheus Metrics Prometheus
SQL Metrics SQL
Warp 10™ Metrics Warp 10™

Most of the protocols don't include authentification, so you need to add the tokens in the Basic Auth field.

If you're wondering which protocol to choose, here is a simple guideline :

  • You want to push json? -> OpenTSDB
  • You want to instrument your code? -> Prometheus SDK & Beamium
  • You want powerful analytics? -> Warp 10™ & WarpScript™
  • You want BI tools integration like Tableau, Power BI, Qlik? -> SQL

Authentification and endpoints

Metrics has builtin security to secure your data. In the Start section you've learnt where to get them from the manager. We've generated a default pair of tokens :

  • a READ token to Query
  • a WRITE token to Push Data

Except for Warp 10™ (where it's provided as a specific Header for push and in the DSL payload for queries), this token will be used as the password in the Basic Auth.

Most of the protocols are available through HTTPS endpoints. Here's the logic for pushing:

https://token:[write token]@[protocol].[region]

For example :

The user in the basic authenfication is discarded.

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