{"id":13581487,"url":"https://github.com/prometheus/influxdb_exporter","last_synced_at":"2025-04-06T10:32:31.200Z","repository":{"id":5671578,"uuid":"53703126","full_name":"prometheus/influxdb_exporter","owner":"prometheus","description":"A server that accepts InfluxDB metrics via the HTTP API and exports them via HTTP for Prometheus consumption","archived":false,"fork":false,"pushed_at":"2024-08-22T18:38:08.000Z","size":3636,"stargazers_count":261,"open_issues_count":2,"forks_count":67,"subscribers_count":16,"default_branch":"main","last_synced_at":"2024-08-22T20:55:53.180Z","etag":null,"topics":["hacktoberfest","influxdb","metrics","observability","prometheus"],"latest_commit_sha":null,"homepage":"","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":"2016-03-11T23:33:42.000Z","updated_at":"2024-08-22T18:38:11.000Z","dependencies_parsed_at":"2023-02-14T20:15:59.832Z","dependency_job_id":"eeb88013-c38c-4f38-ac40-d058683993b4","html_url":"https://github.com/prometheus/influxdb_exporter","commit_stats":{"total_commits":184,"total_committers":29,"mean_commits":6.344827586206897,"dds":0.7228260869565217,"last_synced_commit":"9967aca3f7bd6711374a6ce51c46bef4f62f9054"},"previous_names":[],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Finfluxdb_exporter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Finfluxdb_exporter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Finfluxdb_exporter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prometheus%2Finfluxdb_exporter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prometheus","download_url":"https://codeload.github.com/prometheus/influxdb_exporter/tar.gz/refs/heads/main","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":["hacktoberfest","influxdb","metrics","observability","prometheus"],"created_at":"2024-08-01T15:02:03.285Z","updated_at":"2025-04-06T10:32:30.874Z","avatar_url":"https://github.com/prometheus.png","language":"Go","funding_links":[],"categories":["Go","Exporters"],"sub_categories":["Other monitoring systems"],"readme":"# InfluxDB Exporter [![Build Status](https://travis-ci.org/prometheus/influxdb_exporter.svg)][travis]\n\n[![CircleCI](https://circleci.com/gh/prometheus/influxdb_exporter/tree/master.svg?style=shield)][circleci]\n[![Docker Repository on Quay](https://quay.io/repository/prometheus/influxdb-exporter/status)][quay]\n[![Docker Pulls](https://img.shields.io/docker/pulls/prom/influxdb-exporter.svg?maxAge=604800)][hub]\n\nAn exporter for metrics in the InfluxDB format used since 0.9.0. It collects\nmetrics in the\n[line protocol][line_protocol] via a HTTP API,\ntransforms them and exposes them for consumption by Prometheus.\n\nThis exporter supports float, int and boolean fields. Tags are converted to Prometheus labels.\n\nThe exporter also listens on a UDP socket, port 9122 by default, as well as the [v2 HTTP endpoints](#v2-support), where it\nexposes InfluxDB metrics using `/metrics` endpoint \nand exposes exporter's self metrics using `/metrics/exporter` endpoint.\n\n## Timestamps\n\nBy default metrics exposed without original timestamps like this:\n\n```\nhttp_requests_total{method=\"post\",code=\"200\"} 1027\nhttp_requests_total{method=\"post\",code=\"400\"}    3\n```\n\nIf you want to add original timestamps to exposed metrics, please use flag `--timestamps` and metrics will looks like:\n\n```\nhttp_requests_total{method=\"post\",code=\"200\"} 1027 1395066363000\nhttp_requests_total{method=\"post\",code=\"400\"}    3 1395066363000\n```\n\nWhen querying, this means that the sample is attributed to the time it was\nsubmitted to the exporter, not the time Prometheus scraped it. However, if the\nmetric was submitted multiple times in between exporter scrapes, only the last\nvalue and timestamp will be stored.\n\n## Alternatives\n\nIf you are sending data to InfluxDB in Graphite or Collectd formats, see the\n[graphite_exporter][graphite_exporter]\nand [collectd_exporter][collectd_exporter] respectively.\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][node_exporter].\n\nThe exporter acts like an InfluxDB server, it does not connect to one. For\nmetrics concerning the InfluxDB server, use the [metrics endpoint][influxdb_metrics]\nbuilt into InfluxDB.\n\nIf you are already using Telegraf, it can serve the same purpose as this\nexporter with the [`outputs.prometheus_client`][telegraf] plugin.\n\nFor more information on integrating between the Prometheus and InfluxDB\necosystems, see the [influxdata integration page][influx_integration].\n\n## Example usage with Telegraf\n\nThe influxdb_exporter appears as a normal InfluxDB server. To use with Telegraf\nfor example, put the following in your `telegraf.conf`:\n\n```\n[[outputs.influxdb]]\n  urls = [\"http://localhost:9122\"]\n```\n\nOr if you want to use UDP instead:\n```\n[[outputs.influxdb]]\n  urls = [\"udp://localhost:9122\"]\n```\n\nNote that Telegraf already supports outputting Prometheus metrics over HTTP via\n[`outputs.prometheus_client`][telegraf], which avoids having to also run the influxdb_exporter.\n\n## V2 Support\nInfluxDB V2 Support is currently in progress. Supported features include:\n- Querying for a null result\n- Writing data to the exporter - ignores [auth](https://github.com/prometheus/influxdb_exporter/issues/79) and metadata components (org, buckets)\n\n[circleci]: https://circleci.com/gh/prometheus/influxdb_exporter\n[hub]: https://hub.docker.com/r/prom/influxdb-exporter/\n[travis]: https://travis-ci.org/prometheus/influxdb_exporter\n[quay]: https://quay.io/repository/prometheus/influxdb-exporter\n[line_protocol]: https://docs.influxdata.com/influxdb/v0.10/write_protocols/line/\n[graphite_exporter]: https://github.com/prometheus/graphite_exporter\n[collectd_exporter]: https://github.com/prometheus/collectd_exporter\n[node_exporter]: https://github.com/prometheus/node_exporter\n[influxdb_metrics]: https://docs.influxdata.com/influxdb/v1.5/administration/server_monitoring/#influxdb-metrics-http-endpoint\n[telegraf]: https://docs.influxdata.com/telegraf/v1.7/plugins/outputs/#prometheus-client-prometheus-client-https-github-com-influxdata-telegraf-tree-release-1-7-plugins-outputs-prometheus-client\n[influx_integration]: https://www.influxdata.com/integration/prometheus-monitoring-tool/\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Finfluxdb_exporter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprometheus%2Finfluxdb_exporter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprometheus%2Finfluxdb_exporter/lists"}