{"library":"python-statsd","title":"Python StatsD Client","description":"python-statsd is a Python client for the StatsD daemon, a front-end/proxy for Graphite's stats collection and graphing server. While the user-provided slug is 'python-statsd' (version 2.1.0), this PyPI project typically redirects to 'statsd' (currently 4.0.1). This entry reflects the features and usage of the actively maintained 'statsd' package on PyPI, which is the direct successor and most commonly used client. It allows applications to send various metrics like counters, timers, and gauges over UDP (or TCP) for aggregation and monitoring. The library generally follows a stable release cadence for minor bug fixes and feature enhancements.","language":"python","status":"active","last_verified":"Sat May 16","install":{"commands":["pip install statsd"],"cli":null},"imports":["from statsd import StatsClient"],"auth":{"required":false,"env_vars":[]},"quickstart":{"code":"import statsd\nimport os\n\n# Configure StatsD client, typically pointing to a local StatsD agent\n# Default host is 'localhost', default port is 8125\n# You can override with environment variables or direct arguments\nstatsd_host = os.environ.get('STATSD_HOST', 'localhost')\nstatsd_port = int(os.environ.get('STATSD_PORT', 8125))\n\nc = statsd.StatsClient(host=statsd_host, port=statsd_port, prefix='my_app')\n\n# Increment a counter\nc.incr('page_views')\nc.incr('successful_requests', 5)\n\n# Record a timing (in milliseconds)\nimport time\nstart_time = time.time()\ntime.sleep(0.05) # Simulate work\nduration_ms = (time.time() - start_time) * 1000\nc.timing('api_response_time', duration_ms)\n\n# Set a gauge value\nc.gauge('current_users', 150)\n\nprint(f\"Sent metrics to StatsD at {statsd_host}:{statsd_port}\")\nprint(\"Check your StatsD server/Graphite for 'my_app.page_views', 'my_app.successful_requests', 'my_app.api_response_time', 'my_app.current_users'\")","lang":"python","description":"This quickstart demonstrates how to initialize a StatsD client and send common metric types: counters, timers, and gauges. It uses environment variables for host and port for easy configuration, defaulting to localhost:8125. A prefix is added to all metrics for better organization.","tag":null,"tag_description":null,"last_tested":null,"results":[]},"compatibility":{"tag":null,"tag_description":null,"last_tested":"2026-05-16","installed_version":null,"pypi_latest":"2.1.0","is_stale":null,"summary":{"python_range":"3.10–3.9","success_rate":100,"avg_install_s":1.5,"avg_import_s":0.04,"wheel_type":"wheel"},"results":[{"runtime":"python:3.10-alpine","python_version":"3.10","os_libc":"alpine (musl)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.03,"mem_mb":1.4,"disk_size":"65.7M"},{"runtime":"python:3.10-slim","python_version":"3.10","os_libc":"slim (glibc)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.02,"mem_mb":1.4,"disk_size":"137M"},{"runtime":"python:3.11-alpine","python_version":"3.11","os_libc":"alpine (musl)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":1.6,"disk_size":"72.0M"},{"runtime":"python:3.11-slim","python_version":"3.11","os_libc":"slim (glibc)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.6,"import_time_s":0.04,"mem_mb":1.6,"disk_size":"143M"},{"runtime":"python:3.12-alpine","python_version":"3.12","os_libc":"alpine (musl)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":1.5,"disk_size":"62.5M"},{"runtime":"python:3.12-slim","python_version":"3.12","os_libc":"slim (glibc)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.05,"mem_mb":1.5,"disk_size":"134M"},{"runtime":"python:3.13-alpine","python_version":"3.13","os_libc":"alpine (musl)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.05,"mem_mb":2.1,"disk_size":"59.1M"},{"runtime":"python:3.13-slim","python_version":"3.13","os_libc":"slim (glibc)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.4,"import_time_s":0.06,"mem_mb":1.9,"disk_size":"132M"},{"runtime":"python:3.9-alpine","python_version":"3.9","os_libc":"alpine (musl)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":null,"import_time_s":0.03,"mem_mb":1.4,"disk_size":"64.9M"},{"runtime":"python:3.9-slim","python_version":"3.9","os_libc":"slim (glibc)","variant":"statsd","exit_code":0,"wheel_type":"wheel","failure_reason":null,"import_side_effects":"clean","install_time_s":1.7,"import_time_s":0.02,"mem_mb":1.4,"disk_size":"137M"}]}}