Documentation

Contribute to Telegraf

There are many ways to contribute to InfluxData open source products. Whether you want to report a bug, write a plugin, or answer support questions, the following sections will guide you through the process.

Open GitHub issues

File bug reports

  1. Search Telegraf GitHub issues for related issues that are open or have been fixed.
  2. If an issue does not already exist, create a new bug report issue.
  3. Include all the requested details.

Do not open general support requests as GitHub issues. Support-related questions should be directed to the InfluxDB Community Slack or InfluxData Community forum.

Open feature requests

Feature requests help to prioritize work. To submit a feature request:

  1. Search Telegraf GitHub issues for issues related your feature request. Use the feature request label to filter issues by feature requests.
  2. If an issue related to your feature request already exists, indicate your support for that feature by using the thumbs up reaction and add a comment explaining your use case for the feature.
  3. If a feature request does not already exist, create a new feature request issue. Include the following with your feature request
  4. Include all the requested details.

Ask or answer support questions

Post support questions to InfluxDB Community Slack or InfluxData Community forum.

Contribute code

Create a pull request

  1. Sign the InfluxData CLA.

  2. Open a new issue to discuss the changes you would like to make. This is not strictly required, but it may help reduce the amount of rework you need to do later.

  3. Make changes or write plugins using the following plugin guidelines:

  4. Include unit tests and documentation for your change.

  5. Open a new pull request. The pull request title needs to follow the conventional commit format.

If you have a pull request with only one commit, the commit message must follow the conventional commit format, otherwise the Semantic Pull Request check will fail. For single-commit pull requests, GitHub uses the commit message as the default pull request title.

Contribute an external plugin

Input, output, and processor plugins written for Telegraf can be run as externally-compiled plugins through the execd input, execd output, and execd processor plugins without having to change the plugin code.

For more information, see:

  • Execd Go Shim: Use the Go execd shim to compile your plugin as a separate app and run it with the respective execd plugin.
  • Write an external plugin: Build and set up external plugins to run with execd.

Report security vulnerabilities

InfluxData takes security and our users’ trust very seriously. If you believe you have found a security issue in any of our open source projects, please responsibly disclose it by contacting security@influxdata.com. For more information about reporting security vulnerabilities, including our GPG key, see How to report security vulnerabilities.


Was this page helpful?

Thank you for your feedback!


The future of Flux

Flux is going into maintenance mode. You can continue using it as you currently are without any changes to your code.

Read more

InfluxDB v3 enhancements and InfluxDB Clustered is now generally available

New capabilities, including faster query performance and management tooling advance the InfluxDB v3 product line. InfluxDB Clustered is now generally available.

InfluxDB v3 performance and features

The InfluxDB v3 product line has seen significant enhancements in query performance and has made new management tooling available. These enhancements include an operational dashboard to monitor the health of your InfluxDB cluster, single sign-on (SSO) support in InfluxDB Cloud Dedicated, and new management APIs for tokens and databases.

Learn about the new v3 enhancements


InfluxDB Clustered general availability

InfluxDB Clustered is now generally available and gives you the power of InfluxDB v3 in your self-managed stack.

Talk to us about InfluxDB Clustered