Skip to main content

ITRS StatsD Client

Project description


PyPI Version

Python module for publishing custom metrics to an ITRS StatsD server.

The module is part of the Orchestrated Netprobe solution for collecting metrics in orchestrated environments. See the docs for complete details.


  • Python 3.7


The module is available via PyPI:

pip3 install itrsstatsd

Module Documentation

How to get and use a statsd API handle:

pydoc3 itrsstatsd  

API documentation:

pydoc3 itrsstatsd.api

Units of measure documentation:

pydoc3 itrsstatsd.units

Getting Started

from itrsstatsd import build_statsd
from itrsstatsd.units import Unit
from itrsstatsd.severity import Severity

# Create an instance of the client that sends to localhost:8125
statsd = build_statsd()

# Optionally add dimension(s) to all metrics

# Record some metrics
statsd.gauge("cache_size", 52.5, Unit.Megabytes)
statsd.timer("query_time", 56)
statsd.event("event_name_1", "event_message", Severity.INFO)
statsd.attribute("attr_name_1", "A1")

Refer to the pydoc for complete usage details.

Change Log

v2.0.0 (2020-04-01)

New Features:

  • C2-76: Added event and attribute support
  • C2-124: Added new units of measure

v1.4.0 (2019-12-20)

New Features:

  • C2-92: StatsD configuration via environment variables

    This introduces the following changes:

    • Breaking: STATSD_SERVER and STATSD_PORT environment variables now have precedence over the hostname and port configured in code.
    • New STATSD_PROTOCOL environment variable which can be set to tcp or udp and overrides the protocol configured in code.
    • New STATSD_DISABLE_PLATFORM_DIMENSIONS environment variable which, if true, will prevent the platform-specific dimensions from being added to each metric. This overrides the value configured in code.
    • Custom dimensions can be configured via STATSD_DIMENSION_* environment variable(s).


  • C2-98: StatsD client blocks when connecting to server via TCP

v1.3.0 (2019-09-11)

New Features:

  • License changed to BSD 3-Clause
  • C2-77: Nano and micro resolution in timer metrics


  • C2-78: Statsd client sends malformed message with sample rate

v1.2.0 (2019-08-23)

New Features:

  • C2-72: Discard oldest metrics when sending queue full

v1.1.0 (2019-08-23)

New Features:

  • C2-69: Statsd over TCP

v1.0.0 (2019-08-15)

First version.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

itrsstatsd-2.0.0.tar.gz (10.0 kB view hashes)

Uploaded Source

Built Distribution

itrsstatsd-2.0.0-py3-none-any.whl (12.7 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page