libhoney

What it is and what it does

libhoney-py is a Python client library for sending structured events to Honeycomb, a cloud-based observability platform designed for debugging production software. It wraps HTTP calls over requests and urllib3 to deliver event data to Honeycomb's ingestion endpoints, allowing developers to instrument applications with custom metrics and trace data.

The library is lightweight and has low install friction—it ships as a pure Python wheel with only three runtime dependencies (requests, statsd, urllib3). It supports Python 3.7 through 3.11 and is maintained under the Apache License 2.0. While the package is dormant (no release since March 2024), the repository remains accessible and the code is stable for production use; for automatic instrumentation of frameworks like Django and Flask, Honeycomb recommends their separate Beeline for Python library.

Use it for:

• Instrument custom application events and send them to Honeycomb for real-time production debugging and performance analysis.
• Track application metrics and business events alongside system telemetry to correlate issues across your stack.
• Send trace data from backend services to Honeycomb for distributed tracing and request flow visualization.
• Log structured event data from long-running batch jobs or scheduled tasks for post-execution analysis.
• Integrate event collection into existing Python applications without heavy framework dependencies.

Worth the install?

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

Sends events and metrics to Honeycomb, a production debugging service, for observability and analysis of application behavior.

Yes, if you use Honeycomb for observability. The package is stable, has low install friction, carries no known vulnerabilities, and is permissively licensed. The 891-day release gap is notable but not disqualifying—the library is mature and the repository remains maintained. For framework-specific automatic instrumentation, use Beeline for Python instead.

Install

libhoney on PyPI

pip install libhoney

uv add libhoney

poetry add libhoney

Installing libhoney

Before you install

Low install friction with pure Python wheels. Maintenance is dormant—last release was in March 2024, over 891 days ago, though the repository remains active with a recent commit in November 2024. Suitable for stable production use but expect no rapid updates.

License in practice

Apache License 2.0 (permissive). You may use, modify, and distribute this package freely in commercial and open-source projects, provided you retain the license notice.

Quickstart

pip install libhoney

import libhoney
libhoney.init(writekey="your-api-key", dataset="your-dataset")
libhoney.send_now({"event_field": "value"})

Requires a Honeycomb account and API key to send events; without credentials, events will not be transmitted.

Verify before relying

• Whether the 891-day gap since last release indicates planned maintenance cadence or abandoned support.
• Performance characteristics and event batching behavior under high-volume production workloads.
• Compatibility with recent Honeycomb API changes or deprecations since March 2024.

Package facts

Evidence: libhoney-2.4.0-py3-none-any.whl

Tags

More Monitoring packages