Prometheus Remote Storage

Prometheus Remote Storage

Configuring Prometheus Remote Storage

Remote Storage

You can configure Prometheus to use remote storage. Prometheus’s local storage is limited by single nodes in its scalability and durability. Instead of trying to solve clustered storage in Prometheus itself, Prometheus has a set of interfaces that allow integrating with remote storage systems.

The remote write and remote read features of Prometheus allow transparently sending and receiving samples. This is primarily intended for long term storage. It is recommended that you perform careful evaluation of any solution in this space to confirm it can handle your data volumes.

The following is an example of the configuration that deploys Prometheus with a remote write feature. You can create a similar configuration for remote read:

  "prometheus": {
    "remote_write": {
      "url": "",
      "remote_timeout": "30s",
      "basic_auth": {
        "username": "username",
        "password": "password"
      "tls_config": {
        "enabled": true,
        "ca_file": "CA",
        "cert_file": "CERT",
        "key_file": "KEY",
        "insecure_skip_verify": "false"
      "queue_config": {
        "capacity": "500",
        "max_shards": "1000",
        "min_shards": "1",
        "max_samples_per_send": "100",
        "batch_send_deadline": "5s",
        "min_backoff": "30ms",
        "max_backoff": "100ms"

Note: You must configure the secrets for the ca_file,cert_file,key_file bearer_token_file files and provide the path in above configuration.

Refer to remote-storage-integrations doremote-endpoints-and-storage remote_write remote_read for more details about remote storage.