Complimentary Gartner® Report! 'A CTO's Guide to Open-Source Software: Answering the Top 10 FAQs.'Read more

Prometheus Remote Write

Supported Types

LogsMetricsTraces

Configuration Table

ParameterTypeDefaultDescription
hostname*stringThe hostname or IP address for the remote write backend.
port*int9009The port remote write backend.
path*stringThe API Path of the remote write URL. Ex: api/v1/metrics.
headersmapAdditional headers to attach to each HTTP Request. The following headers cannot be changed: Content-Encoding, Content-Type, X-Prometheus-Remote-Write-Version, and User-Agent.
external_labelsmapLabel names and values to be attached as metric attributes.
namespacestring""Prefix to attach to each metric name.
enable_resource_to_telemetry_conversionboolfalseWhen enabled, it will convert all resource attributes to metric attributes.
enable_write_ahead_logboolfalseWhether or not to enable a Write Ahead Log for the exporter.
wal_buffer_sizeint300Number of objects to store in Write Ahead Log before truncating. Applicable if enable_write_ahead_log is true.
wal_truncate_frequencyint60Sets how often, in seconds, the Write Ahead Log should be truncated. Applicable if enable_write_ahead_log is true.
enable_tlsboolfalseWhether or not to use TLS.
strict_tls_verifyboolfalseStrict TLS Certificate Verification.
ca_filestringCertificate authority used to validate TLS certificates. This is not required if the collector's operating system already trusts the certificate authority.
cert_filestringA TLS certificate used for client authentication if mutual TLS is enabled.
key_filestringA TLS private key used for client authentication if mutual TLS is enabled.
*required field

Supported Retry and Queuing Settings

This destination supports the following retry and queuing settings:

Sending QueuePersistent QueueRetry on Failure

In order to buffer metrics to disk, the Write Ahead Log (WAL) may be enabled.