---
id: statshog
version: "1.0.6"
license: MIT
license_treatment: permissive
maintenance: abandoned
---

# statshog — A simple statsd client.

License: permissive · Maintenance: abandoned · Downloads: 2.1M/mo

## What it is and what it does

statshog is a lightweight Python StatsD client that connects to StatsD servers to send application metrics. It supports both Etsy's original StatsD protocol and InfluxDB's Telegraf StatsD variant, allowing you to record counters, timings, and gauges. The package has no runtime dependencies and installs as a single wheel, making it straightforward to add to any project.

You create a StatsClient instance pointing to your StatsD server, then call methods like incr(), timing(), or gauge() to record metrics. It includes Django integration via settings configuration. The package is marked Production/Stable but has been abandoned since May 2021, so it receives no maintenance or updates.

Use it for:

- Send application performance metrics to a StatsD server for monitoring dashboards
- Track custom business metrics in a centralized metrics backend
- Integrate metrics collection into a Django application using environment-based configuration
- Record timing data with Telegraf tags for dimensional analysis of performance data

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client for sending metrics to StatsD servers and recording counters, timings, and gauges with optional tag support.

Yes, if you need a minimal, dependency-free StatsD client and your StatsD infrastructure is stable. The permissive MIT license and zero runtime dependencies make it low-risk to adopt. However, the abandoned status since May 2021 means you should verify compatibility with your target server version and be prepared to fork if issues arise.

## Install

pip install statshog
uv add statshog
poetry add statshog

## Installing statshog

Before you install: Low install friction with no runtime dependencies. However, the package is abandoned—last release was 2021-05-07 with no commits since then.

License in practice: MIT license is permissive and places no restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

pip install statshog

import statshog
statsd = statshog.StatsClient(host='localhost', port=8125)
statsd.incr('foo')
statsd.timing('stats.timed', 320)

Verify before relying:

- Whether the package works reliably with current versions of StatsD and Telegraf servers
- Whether Python 3.10+ is supported despite classifiers only listing through 3.9

## Package facts

- License: MIT (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: abandoned
- Downloads: 2.1M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

statsd client python, metrics collection statsd, telegraf influxdb client, performance monitoring statsd, counter timing gauge metrics, metrics-collection, monitoring

[View on SkillFed](https://skillfed.io/packages/statshog) · [View on PyPI](https://pypi.org/project/statshog/)