graphyte

What it is and what it does

graphyte is a minimal Python library for sending metrics to a Graphite/Carbon server. It was created as a Python 3-compatible alternative to graphitesend, replacing gevent with the standard library's threading module for asynchronous operation. The library supports both synchronous sends and background-thread batching at a configurable interval, TCP and UDP protocols, tagged metrics, and direct command-line invocation.

You initialize a default sender with a server hostname and optional prefix, then call send() to submit metric values. For advanced use cases, you can instantiate multiple Sender instances targeting different servers, subclass Sender to customize message formatting or error handling, or configure whether send errors are logged or raised. The library has no external runtime dependencies.

Use it for:

• Submit application metrics to a Graphite server from a Python service or web application
• Batch metric sends on a background thread to avoid blocking request handlers in production systems
• Send custom application instrumentation (latency, counters, gauges) to a centralized metrics store
• Integrate metrics collection into a monitoring pipeline that uses Graphite as its backend
• Send metrics via UDP for low-overhead fire-and-forget submission in high-throughput scenarios

Worth the install?

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

graphyte sends metrics to a Graphite/Carbon server over TCP or UDP, with support for synchronous sends or background-thread batching via the standard library's threading module.

No. The package is abandoned (last release 2022-01-23, 1664 days ago) with no indication of maintenance for modern Python versions. While it has no known vulnerabilities and carries a permissive MIT license, the lack of active support and uncertain compatibility with Python 3.10+ makes it a poor choice for new projects. Consider an actively maintained alternative if you need to send metrics to Graphite.

Install

graphyte on PyPI

pip install graphyte

uv add graphyte

poetry add graphyte

Installing graphyte

Before you install

High install friction: no runtime dependencies, but the package has been abandoned since January 2022 (1664 days without a release). The last commit was 2022-01-23 and the repository is not archived, leaving maintenance status uncertain for modern Python versions.

License in practice

MIT License (permissive) — you can use, modify, and distribute graphyte freely in commercial and private projects with minimal restrictions, requiring only attribution and inclusion of the license notice.

Quickstart

pip install graphyte

import graphyte
graphyte.init('graphite.example.com', prefix='system.sync')
graphyte.send('foo.bar', 42)

Verify before relying

• Whether the package works reliably with Python versions released after the last commit (2022-01-23), particularly 3.10+
• Current stability and any breaking changes in modern Graphite/Carbon server versions
• Whether background thread batching (interval parameter) is production-ready for high-volume metric submission

Package facts

Evidence: graphyte-1.7.1.tar.gz

Tags

More Monitoring packages