为 Telegraf 贡献
有很多方式可以为InfluxData开源产品贡献力量。无论你是想报告一个错误、编写一个插件,还是回答支持问题,以下部分将指导你完成这个过程。
打开 GitHub 问题
提交错误报告
- 搜索 Telegraf GitHub 问题 与相关的未解决或已修复的问题。
- 如果问题尚不存在,创建一个新的 bug 报告问题。
- 包含所有请求的细节。
请勿将一般支持请求提交为GitHub问题。支持相关的问题应提交到InfluxDB Community Slack或InfluxData Community forum。
开启功能请求
功能请求有助于确定工作的优先级。要提交功能请求:
- 搜索 Telegraf GitHub 问题 与您的功能请求相关的问题。使用 功能请求 标签来 过滤功能请求的问题。
- 如果与您的功能请求相关的问题已经存在,请通过使用点赞反应表示您对该功能的支持,并添加一条评论解释您对该功能的使用案例。
- 如果功能请求尚不存在, 创建一个新的功能请求问题。 请在您的功能请求中包含以下内容
- 包含所有请求的细节。
提问或回答支持问题
将支持问题发布到 InfluxDB Community Slack 或 InfluxData Community forum。
贡献代码
创建拉取请求
打开一个 新问题 来讨论您想要进行的更改。虽然这不是严格要求的,但它可能有助于减少您后期需要重新工作的数量。
根据以下插件指南进行更改或编写插件:
为您的更改添加单元测试和文档。
打开一个新的 pull request。 拉取请求标题需要遵循 常规提交格式。
如果您有一个只有一个提交的拉取请求,则提交信息必须遵循 约定提交格式, 否则语义化拉取请求检查将失败。 对于单提交拉取请求,GitHub 使用提交信息作为默认的 拉取请求标题。
贡献一个外部插件
为Telegraf编写的输入、输出和处理插件可以作为外部编译的插件运行,通过execd input、execd output和execd processor插件,无需更改插件代码。
有关更多信息,请参阅:
- Execd Go Shim:
使用 Go
execdshim 将您的插件编译为一个独立的应用程序并使用相应的execd插件运行它。 - 编写外部插件:
构建和设置外部插件,以便与
execd一起运行。
报告安全漏洞
InfluxData 非常重视安全性和用户的信任。如果您认为在我们的任何开源项目中发现了安全问题,请通过联系 security@influxdata.com 负责任地披露它。有关报告安全漏洞的更多信息,包括我们的 GPG 密钥,请参见 如何报告安全漏洞。