prometheus-remote-writer

What it is and what it does

prometheus-remote-writer is a Python client library that implements the Prometheus Remote Write protocol, allowing you to push time-series metrics directly to Prometheus-compatible storage backends (such as Prometheus itself, Mimir, or other remote storage systems). It abstracts away the protocol details and HTTP communication, letting you focus on preparing and sending your metric data.

The library handles authentication (bearer tokens, basic auth), custom headers, SSL certificate verification, proxy configuration, request retries, and automatic timestamp conversion. It supports batching multiple time series per request and allows configuration of batch sizes and timeouts. The API is straightforward: create a RemoteWriter instance with your endpoint URL and optional auth/headers, then call send() with your metric data.

Use it for:

• Push application metrics from a Python service to a centralized Prometheus or Mimir instance for monitoring and alerting.
• Export custom time-series data from data processing pipelines to Prometheus-compatible storage for visualization and analysis.
• Integrate metrics collection into a Python application without running a local Prometheus scraper.
• Send batch metrics from periodic jobs or cron tasks to a remote Prometheus endpoint.
• Forward metrics through corporate proxies or to endpoints requiring custom authentication headers.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Sends time-series metrics to Prometheus-compatible remote storage backends using the Prometheus Remote Write protocol, with support for authentication, batching, and custom headers.

Yes, if you need to push metrics to Prometheus-compatible storage from Python and want a straightforward, low-friction client. The library is permissively licensed, has no known vulnerabilities, and supports current Python versions. The aging maintenance status is a minor concern—verify that the package still works with your target Prometheus endpoint and that the maintainer responds to issues before committing to a production dependency.

Install

prometheus-remote-writer on PyPI

pip install prometheus-remote-writer

uv add prometheus-remote-writer

poetry add prometheus-remote-writer

Installing prometheus-remote-writer

Before you install

Low friction installation with three runtime dependencies (grpcio-tools, requests, python-snappy). Package is aging (201 days since last release), so maintenance activity is limited but not abandoned.

License in practice

Licensed under Apache License 2.0 (permissive), so you can use, modify, and distribute the package freely in commercial and open-source projects with minimal restrictions.

Quickstart

pip install prometheus-remote-writer

from prometheus_remote_writer import RemoteWriter

writer = RemoteWriter(
    url='https://prometheus-server/api/v1/write',
    headers={'Authorization': 'Bearer TOKEN'}
)
writer.send([{
    'metric': {'__name__': 'cpu_usage', 'host': 'server1'},
    'values': [23.5],
    'timestamps': [1609459200000]
}])

Requires Python 3.9 or higher; grpcio-tools, requests, and python-snappy must be installable in your environment.

Verify before relying

• Whether grpcio-tools, requests, and python-snappy are lightweight or have their own heavy transitive dependencies that could increase install friction in practice.
• Actual maintenance status and responsiveness to issues, since 'aging' status (201 days) may indicate either stable maturity or dormancy.

Package facts

Evidence: prometheus_remote_writer-1.1.3-py3-none-any.whl

Tags

More Monitoring packages