社区

项目治理

Prometheus 项目遵循 Prometheus 治理规范。

社区联系方式

Prometheus 采用开源方式开发。以下是我们用于交流和贡献的一些渠道

Slack 频道

CNCF Slack  上的 #prometheus 频道。

IRC

irc.libera.chat  上的 #prometheus 频道。

Matrix

#prometheus:matrix.org.

用户邮件列表

• prometheus-announce （镜像 ）
  • 用于发布新版本等公告的低频邮件列表。
• prometheus-users  （镜像 ）
• 用于讨论 Prometheus 的使用和寻求社区支持。通常不会同步来自 prometheus-announce  的公告。

Discourse 论坛

基于 Web 的讨论论坛 discuss.prometheus.io ，由 Discourse  托管。

公开活动日历

我们有一个公开的活动日历，您可以用它来加入我们。

如果您只想了解概览，只需在您的浏览器中查看我们对应的本地时区网页视图 。

如果您使用的是 Google 产品，可以使用此自动关联链接将其添加到您自己的 Google 日历中 。

如果您使用的是其他日历，可以使用此 .ics 文件将其添加到非 Google 日历中 。

社交媒体

• Bluesky  上的 @prometheus.io 。
• Mastodon (chaos.social)  上的 @Prometheus 。

GitHub

若要提交 Bug 和功能请求，请使用相关 Prometheus 仓库  的 GitHub issue 跟踪器。对于问题和讨论，许多仓库都提供了 GitHub discussions。通常，这里列出的其他社区渠道最适合获取支持或讨论全局性主题。

请勿向单个项目成员寻求支持。请改用上述渠道，整个社区都可以为您提供帮助，并能从提供的解决方案中受益。如果社区支持无法满足您的需求，请参考 支持与培训 页面。

贡献指南

请参阅 贡献者指南。

开发者峰会

请参阅 贡献者指南。

导师计划

Prometheus 项目偶尔会参与各种周期性的导师计划

• LFX 导师计划（原 Community Bridge） 
• Google Summer of Code (谷歌编程之夏) 

请参阅上述链接以获取未来的计划日期、申请详情和项目。

注意为了让 Prometheus 能够参与导师计划周期，潜在的导师（包括至少一名 Prometheus 维护者）必须向计划周期提交一个“项目”提案，例如在此 PR 中 。

导师的时间有限，因此我们不得不跳过一些周期和计划。有一些方法可以帮助我们更频繁地参与

• 如果您想帮助我们担任导师，请随时通过 #prometheus-dev Slack 频道 或 电子邮件  联系团队。
• 如果您想建议将某个开源 Prometheus 生态系统倡议转化为导师项目，欢迎在相关的工件（例如 GitHub issue）上发表评论。

致学员

您已被选中参加 LFX 或 GSoC 下的 Prometheus 导师计划？恭喜！这里有一些帮助您快速入门的信息！

新手引导清单

• 请阅读并认可我们的 行为准则。简而言之（TL;DR）：保持友善和友好，像你希望被对待的那样对待他人。
• 在 CNCF Slack  上创建账号。请添加个人资料头像以使其具有辨识度。您可以在那里联系到任何一位导师。
• 将您的 Slack 账号 ID 发送给您的导师，以便我们将您加入私有频道。我们通常会有一个仅包含您和您的主要导师的私有频道，以及第二个包含所有学员、前学员和导师的频道（#thanos-prometheus-mentees）。
• 加入 Prometheus 的主要 Slack 频道 #prometheus 和 #prometheus-dev，以便日后与社区进行交流。
• 在 #prometheus-dev Slack 频道 上，写几句关于您自己的介绍，打个招呼吧！💜
• 欢迎加入 社交媒体，开始关注他人并积累您自己的关注者！谁知道呢，也许您会沉迷其中？(: 欢迎发布任何关于 Prometheus 的相关内容，并提及 @prometheus.io。
• 让导师安排每周一次的 2对1 会议（强烈推荐）。
• 请阅读我们的通用贡献指南，以及 Prometheus 仓库中的具体指南 
• 仔细阅读您的主要 GitHub issue 并开始思考它，但不要有压力！最好先从一个较小的任务慢速开始，让一切运转起来。🚀

提示和建议

您可以遵循以下一些建议，以充分利用与我们共度的时光！

• PR 被卡住了、正在寻找人来审查您的贡献，或者对失败的 CI 有一些简短的问题？相比于私信或私有频道，请优先选择 公开 交流渠道（#prometheus 和 #prometheus-dev）。Prometheus 拥有一个庞大的社区，可以快速帮助您解决任何问题。此外，其他学员也可能已经遇到过类似的问题！
• 向其他学员和前学员打个招呼。我们甚至为此创建了一个专门的频道，以便你们可以结对并共同构建更大的成果：建立联系、未来可能合作的项目，或者只是互相帮助！以 2020 年夏天为例，之前的 Thanos 学员发起了 周五趣味聚会（Friday fun hangouts） ，效果非常棒！想发起类似的活动吗？向其他前学员请教他们的经验吧。🤗
• 跳出固有思维。您是否觉得在项目开发、功能或社区方面有什么非常痛苦的地方？帮助我们改进，并提出改进建议！
• 参与项目生命周期。我们活跃于许多会议中，例如 KubeCon、PromCon、FOSDEM、GoDays。我们参与了 CNCF SIG、许多边际倡议、博客文章和视频。请帮助我们！欢迎您提升在社交媒体上的知名度、开始撰写博客，甚至开始在会议上演讲。无论您对什么感兴趣，都可以随时向您的导师寻求指导！我们很乐意提供帮助。
• 在实习期间，我们非常欢迎甚至鼓励您为任何您想做的事情做出贡献。等待 PR 审查一段时间是常有的事（毕竟这是开源项目！），因此同时推进 2 或 3 件事并不罕见。您也不需要将贡献局限于 Prometheus 项目。为您我们依赖或有合作关系的其他项目做出贡献是完全没有问题的。此外，我们也鼓励 Prometheus 学员为 Prometheus 生态系统项目做出贡献，例如 其他 Prometheus 仓库 ，甚至是 Cortex 和 Thanos。因为我们是一个更大的 Prometheus 生态系统大家庭 的一部分。
• 努力保持独立，并为您要交付的功能负责。您越早开始主导您的任务，对您就越有利！刚开始可能很难，但试着从用户体验的角度去思考。使用它时是容易还是不容易犯错？迁移到该功能有多难？有什么我们可以做的来减少数据丢失的错误吗？
• 尝试通过审查其他贡献者、学员或导师的 pull request 来帮助他人！这听起来很吓人，但实际上这是学习编码实践、模式以及如何维护高质量代码库的最佳方式！
• 尝试使用迭代开发过程 。从微小且简单的设想开始，一旦准备好一个可运行的示例，就不断改进并与导师讨论。微小的改动很容易审查，也很容易被接受 😄。
• 尝试制作一个概念验证（proof of concept） ，它可以作为基线并在此基础上进行改进。这些都是实际项目，因此不可能每次都有确定性的解决方案，概念验证是确定可行性的快速方法。
• 像您是项目的维护者一样去行动。理想情况下，做一个您希望为您贡献的项目所拥有的那种优秀维护者 。虽然这听起来有些令人畏惧，但这是建立信任、承担更多责任并带来巨大价值的最佳方式（例如，审查其他人的工作并帮助他们扫清障碍，往往比您自己编写代码更重要！）。
• 保持快乐，去探索，并享受学习（即使是在错误中学习）！

导师计划的结束并不是终点！欢迎您继续贡献、编写代码并帮助他人。谁知道呢，也许有一天您会充满热情地成为一名维护者！

致导师

本节概述了针对导师的指导建议。

复盘研讨

在导师计划的中期和最后一次会议上，最好与学员坐下来，为导师和学员收集可执行的经验教训。由于我们之间的差异以及不同的任务和环境，导师和学员的经历总是不同的。无论我们是否实现了最初的目标，我们总是想检查我们的体验。如果目标没有实现，那么在坦诚和不指责的氛围中讨论这一点就尤为重要。如果体验大部分是积极的，我们也想知道是什么在起作用，以强化最佳实践。

典型的复盘流程如下所示

• 在会议前一周，向学员提醒计划中的复盘以及具体形式（例如提供本指南的链接）。这让大家可以在这一周里仔细思考哪些工作见效了，哪些没有。
• 在会议期间，首先进行复盘。这是会议最重要的部分，不要让其他事情（例如项目状态）干扰。
  • 在工作文档中写下两个部分：我们哪些方面做得好，哪些方面可以做得更好。
  • 给每个人 5-7 分钟的时间，在这两个部分中写下（例如实时在线协作）条目。要具体、不指责且诚实。这不是为了冒犯任何人，而是为了寻找导师和学员工作的改进方法。对自己要挑剔，但也要尽量平衡好的一面和需要改进的部分。总有一些事情我们可以做得更好（或者更糟！）。
  • 当大家都写完后，创建一个新的部分：经验教训。
  • 逐一查看列表中的所有条目。讨论细节。尝试寻找如何缓解问题或继续保持的做法。将这些内容记录在 经验教训 部分。
  • 最后，将这些经验教训通过邮件列表分享给团队。
  • 考虑将所有的经验教训撰写成某种形式的 公开内容。

公开演讲或写作

为了让学员能够分享他们学到的知识，并帮助他们提高公开演讲技能，在导师计划周期结束时，导师可以鼓励学员在相关论坛中创作某种形式的公开内容。我们过去的一些做法如下

• 鼓励学员在下一次相关的会议或聚会（例如 PromCon、KubeCon、本地聚会等）上发表演讲（甚至与他们一起联合演讲）！
  • 请观看 Arthur  以及 M Viswanath Sai 和 S Ashwin  在 PromCon 会议上发表的关于结束导师计划后的演讲。
• 鼓励学员在 Prometheus 博客  或其个人博客上撰写博客文章！
• 如果我们有足够的内容，举办一次虚拟的“学员见面会”也是一个选择。

行为准则

为了让 Prometheus 成为一个对每个人都友好且不受骚扰的环境，我们遵循 CNCF 行为准则 。

法律伞

Prometheus 是一个独立的开源项目，不受任何单一公司控制。为了强调这一点，我们在 2016 年作为继 Kubernetes  之后的第二个项目加入了 云原生计算基金会（CNCF） 。

致谢

Prometheus 由 Matt T. Proud  和 Julius Volz  发起。其最初的大部分开发工作由 SoundCloud  赞助。

我们还要感谢来自 Docker  和 Boxever  工程师们的早期贡献。

Prometheus 的 Logo 由 Robin Greenwood 贡献。