{"id":21470098,"url":"https://github.com/sensu-plugins/sensu-extensions-statsd","last_synced_at":"2025-08-16T01:16:30.942Z","repository":{"id":52421471,"uuid":"75933978","full_name":"sensu-plugins/sensu-extensions-statsd","owner":"sensu-plugins","description":"Check extension to run a StatsD implementation","archived":false,"fork":false,"pushed_at":"2021-04-29T19:17:46.000Z","size":26,"stargazers_count":6,"open_issues_count":2,"forks_count":4,"subscribers_count":7,"default_branch":"master","last_synced_at":"2024-04-24T13:10:34.603Z","etag":null,"topics":["metrics","sensu","sensu-extensions","sensu-extensions-statsd","sensu-statsd-extension","statsd"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sensu-plugins.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-12-08T12:03:53.000Z","updated_at":"2020-09-27T05:39:24.000Z","dependencies_parsed_at":"2022-09-16T20:01:18.998Z","dependency_job_id":null,"html_url":"https://github.com/sensu-plugins/sensu-extensions-statsd","commit_stats":null,"previous_names":["sensu-extensions/sensu-extensions-statsd"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sensu-plugins%2Fsensu-extensions-statsd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sensu-plugins%2Fsensu-extensions-statsd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sensu-plugins%2Fsensu-extensions-statsd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sensu-plugins%2Fsensu-extensions-statsd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sensu-plugins","download_url":"https://codeload.github.com/sensu-plugins/sensu-extensions-statsd/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":226024666,"owners_count":17561687,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["metrics","sensu","sensu-extensions","sensu-extensions-statsd","sensu-statsd-extension","statsd"],"created_at":"2024-11-23T09:23:09.241Z","updated_at":"2024-11-23T09:23:09.839Z","avatar_url":"https://github.com/sensu-plugins.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sensu StatsD Extension\n\nA StatsD implementation for the Sensu client. This check extension\ncreates a StatsD TCP \u0026 UDP listener, receives StatsD metrics, parses\nthem, and flushes them to the Graphite plaintext format for Sensu to\nsend to Graphite or another TSDB.\n\nThis StatsD implementation attempts to adhere to [Etsy's metric type\nspecifications](https://github.com/etsy/statsd/blob/master/docs/metric_types.md).\n\n[![Build Status](https://travis-ci.org/sensu-extensions/sensu-extensions-statsd.svg?branch=master)](https://travis-ci.org/sensu-extensions/sensu-extensions-statsd)\n\n## Installation\n\nThis extension requires Sensu version \u003e= 0.26.\n\nOn a Sensu client machine.\n\n```\nsensu-install -e statsd:1.0.0\n```\n\nEdit `/etc/sensu/conf.d/extensions.json` to load it.\n\n``` json\n{\n  \"extensions\": {\n    \"statsd\": {\n      \"version\": \"1.0.0\"\n    }\n  }\n}\n```\n\nRestart the Sensu client.\n\n``` shell\nsudo service sensu-client restart\n```\n\n## Configuration\n\nEdit `/etc/sensu/conf.d/statsd.json` to change its configuration.\n\n``` json\n{\n  \"statsd\": {\n    \"bind\": \"0.0.0.0\"\n  }\n}\n```\n\nThe following defaults make the integration behave like Etsy's StatsD\nimplementation.\n\n|attribute|type|default|description|\n|----|----|----|---|\n|bind|string|\"127.0.0.1\"|IP to bind the StatsD sockets to|\n|port|integer|8125|Port to bind the StatsD sockets to|\n|flush_interval|integer|10|The StatsD flush interval|\n|send_interval|integer|30|How often Graphite metrics are sent to Sensu|\n|percentile|integer|90|The percentile to calculate for StatsD metrics|\n|add_client_prefix|boolean|true|If the Sensu client name should prefix the Graphite metric path|\n|path_prefix|string|\"statsd\"|The optional Graphite metric path prefix (after client name)|\n|add_path_prefix|boolean|true|If the path_prefix should be used|\n|delete_gauges|boolean|false|If gauges that have not been updated should be deleted instead of flushed|\n|delete_counters|boolean|false|If counters with a value of 0 should be deleted instead of flushed|\n|delete_timers|boolean|false|If timers with a count of 0 should be deleted instead of flushed|\n|reset_gauges|boolean|false|If gauges should be reset to 0 after flushing|\n|reset_counters|boolean|true|If counters should be reset to 0 after flushing|\n|reset_timers|boolean|true|If timers should be reset/cleared after flushing|\n|handler|string|\"graphite\"|Handler to use for the Graphite metrics|\n|truncate_output|boolean|true|If output should be truncated|\n\n## Example\n\nTest the StatsD TCP socket:\n\n``` shell\necho \"orders:1|c\" | nc 127.0.0.1 8125\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsensu-plugins%2Fsensu-extensions-statsd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsensu-plugins%2Fsensu-extensions-statsd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsensu-plugins%2Fsensu-extensions-statsd/lists"}