graphitesend

library0.10.0pypypi✓ verified 84d ago

A simple interface for sending metrics to Graphite. Provides an easy-to-use Python client for Graphite's plaintext protocol. Current version 0.10.0, released 2016, in maintenance mode.

observability

pip install graphitesend

github ↗package ↗

INSTALL

IMPORT

SIG · GRAPHITESEND

graphitesend

observabilitypythonv0.10.0

Install

2.3s avg

Import

39ms

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.10.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.040s · 19.2MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 2.3s · import 0.038s · 20MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

GraphiteClient

✓ from graphitesend import GraphiteClient

Initialize client and send a metric.

from graphitesend import GraphiteClient g = GraphiteClient(graphite_server='localhost', prefix='test') g.send('metric.name', 42)

graphitesend --version

Debug

Known issues

gotchaBy default, graphitesend sends metrics over UDP, which has no delivery guarantee. Use `send_type='tcp'` for reliable delivery.

fix

Initialize with `GraphiteClient(..., send_type='tcp')`

affects: all

gotchaThe library does not validate the metric name or value format; invalid characters may cause Graphite to reject the metric.

fix

Sanitize metric names (replace spaces, special characters) before sending.

affects: all

deprecatedGraphite's plaintext protocol is being phased out; consider using Graphite's pickle protocol or HTTP API.

fix

Use `graphitesend` with Graphite's pickle format via `format='pickle'` or migrate to newer libraries like `graphiteclient` or `datadog`.

affects: >=0.10.0

Errors

Common errors & fixes

AttributeError: module 'graphitesend' has no attribute 'graphite'

Using wrong import or outdated API referencing 'graphite' object.

fix

Use `from graphitesend import GraphiteClient` instead of `import graphitesend` and accessing `graphitesend.graphite`.

socket.gaierror: [Errno -2] Name or service not known

The graphite_server hostname cannot be resolved.

fix

Check the hostname and network connectivity. Use an IP address if DNS is unavailable.

ValueError: too many values to unpack (expected 2)

Misconfigured tuple format when using non-standard settings.

fix

Ensure all arguments are passed as keyword arguments to GraphiteClient.

Upgrade

Version history

0.10.0latest on PyPI · released Mar 25, 2017

Audit

Dependencies

No dependency data recorded yet.

Agent activity

16 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/daniellawrence/graphitesend ↗

packagehttps://pypi.org/project/graphitesend/ ↗