{"id":13581486,"url":"https://github.com/prometheus/collectd_exporter","last_synced_at":"2025-04-06T10:32:31.020Z","repository":{"id":26811156,"uuid":"30269686","full_name":"prometheus/collectd_exporter","owner":"prometheus","description":"A server that accepts collectd stats via HTTP POST and exports them via HTTP for Prometheus consumption","archived":false,"fork":false,"pushed_at":"2025-03-23T15:58:36.000Z","size":3534,"stargazers_count":261,"open_issues_count":18,"forks_count":72,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-23T16:38:31.711Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prometheus.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2015-02-03T23:09:20.000Z","updated_at":"2025-03-23T15:58:37.000Z","dependencies_parsed_at":"2024-01-03T07:04:24.061Z","dependency_job_id":"4c483510-1cc0-44f3-907e-15528433fc4b","html_url":"https://github.com/prometheus/collectd_exporter","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fcollectd_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fcollectd_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fcollectd_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Fcollectd_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prometheus","download_url":"https://codeload.github.com/prometheus/collectd_exporter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247470353,"owners_count":20944146,"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":[],"created_at":"2024-08-01T15:02:03.248Z","updated_at":"2025-04-06T10:32:30.694Z","avatar_url":"https://github.com/prometheus.png","language":"Go","funding_links":[],"categories":["Go","Exporters"],"sub_categories":["Other monitoring systems"],"readme":"# Collectd Exporter [![Build Status](https://travis-ci.org/prometheus/collectd_exporter.svg)][travis]\n\n[![CircleCI](https://circleci.com/gh/prometheus/collectd_exporter/tree/master.svg?style=shield)][circleci]\n[![Docker Repository on Quay](https://quay.io/repository/prometheus/collectd-exporter/status)][quay]\n[![Docker Pulls](https://img.shields.io/docker/pulls/prom/collectd-exporter.svg?maxAge=604800)][hub]\n\nAn exporter for [collectd](https://collectd.org/). It accepts collectd's\n[binary network protocol](https://collectd.org/wiki/index.php/Binary_protocol)\nas sent by collectd's\n[network plugin](https://collectd.org/wiki/index.php/Plugin:Network) and\nmetrics in JSON format via HTTP POST as sent by collectd's\n[write_http plugin](https://collectd.org/wiki/index.php/Plugin:Write_HTTP),\nand transforms and exposes them for consumption by Prometheus.\n\nThis exporter is useful for exporting metrics from existing collectd setups, as\nwell as for metrics which are not covered by the core Prometheus exporters such\nas the [Node Exporter](https://github.com/prometheus/node_exporter).\n\n## Binary network protocol\n\ncollectd's *network plugin* uses a lightweight binary protocol to send metrics\nfrom one instance to another. To consume these packets with\n*collectd_exporter*, first configure collectd to send these metrics to the\nappropriate address:\n\n```\nLoadPlugin network\n\u003cPlugin network\u003e\n  Server \"prometheus.example.com\" \"25826\"\n\u003c/Plugin\u003e\n```\n\nThen start *collectd_exporter* with `--collectd.listen-address=\":25826\"` to\nstart consuming and exporting these metrics.\n\n## JSON format\n\ncollectd's *write_http plugin* is able to send metrics via HTTP POST requests.\n*collectd_exporter* serves an appropriate end-point which accepts, parses and\nexports the metrics. First, configure collectd to send these metrics to the\nHTTP end-point:\n\n```\nLoadPlugin write_http\n\u003cPlugin write_http\u003e\n  \u003cNode \"collectd_exporter\"\u003e\n    URL \"http://localhost:9103/collectd-post\"\n    Format \"JSON\"\n    StoreRates false\n  \u003c/Node\u003e\n\u003c/Plugin\u003e\n```\n\nTo change the path of the end-point, use the `--web.collectd-push-path` command\nline option. To disable this functionality altogether, use\n`--web.collectd-push-path=\"\"`.\n\n## Using Docker\n\nYou can deploy this exporter using the [prom/collectd-exporter][hub] Docker image.\nYou will need to map the collectd port from the container to the host, remembering\nthat this is a UDP port.\n\nFor example:\n\n```bash\ndocker pull prom/collectd-exporter\n\ndocker run -d -p 9103:9103 -p 25826:25826/udp prom/collectd-exporter --collectd.listen-address=\":25826\"\n```\n\n## TLS and basic authentication\n\nThe *collectd_exporter* supports TLS and basic authentication.\nTo use TLS and/or basic authentication, you need to pass a configuration file\nusing the `--web.config.file` parameter. The format of the file is described\n[in the exporter-toolkit repository](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md).\n\n[circleci]: https://circleci.com/gh/prometheus/collectd_exporter\n[hub]: https://hub.docker.com/r/prom/collectd-exporter/\n[travis]: https://travis-ci.org/prometheus/collectd_exporter\n[quay]: https://quay.io/repository/prometheus/collectd-exporter\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Fcollectd_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprometheus%2Fcollectd_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Fcollectd_exporter/lists"}