Documentation OVH

Use prometheus remote-read and remote-write

Get an overview on how to use prometheus remote-read and remote-write for Metrics

Last updated 14 November, 2019


Prometheus is a well known services and systems monitoring tool which allow code instrumentation. Collecting more and more data can lead to store a huge amount of data on local prometheus. It then become possible to configure your Prometheus instance to use another storage layer.

The read/write protocol support is available on OVH Metrics. It allows you to keep your prometheus instance, add another ones if needed and mutualise storage part.

Why should you do that ?

  • Ability to scale Prometheus instances count with a shared storage
  • Extends series retention
  • ability to replace and perform a maintenance on instances without data loss



  • An active OVH Metrics account (xs plan at least)
  • A working Prometheus instance


Grep some tokens

Let's go to your OVH Metrics manager. The tokens tab is located on your Metrics product. Craft two dedicated tokens (one for read, one for write) for your Prometheus instance, keep them for the next step.

Configure Prometheus instance

Edit prometheus.yml configuration file, this file contains the global instance configuration.

You can find this file by greping the process which use it.

ps aux | grep prometheus | grep -v 'grep'

The process arg --config.file contains the configuration file path.

To setup prometheus remote configuration add the following lines (replace captitals strings by your tokens):

  - url:
      username: ''
      password: 'OVH_METRICS_READ_TOKEN'
  - url:
      username: ''
      password: 'OVH_METRICS_WRITE_TOKEN'

This example assume your are on gra1 Metrics region, your OVH Metrics service can be on another one (like bhs1). You can see it in your OVH Metrics manager under platforms.

Don't forget to restart your Prometheus instance to apply modifications.

Going further

How to make PromQL queries on OVH Metrics

You can exchange with our community of users on OVH Comunnity or directly with us with our gitter room.

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