Prometheus logo

Prometheus

文档下载社区支持与培训博客

Ctrl + K

GitHub Logo

社区

项目治理

Prometheus 项目遵循 Prometheus 治理。

社区联系方式

Prometheus 是一个开放式开发的项目。以下是我们用于沟通和贡献的一些渠道：

Slack 频道

CNCF Slack 上的 #prometheus 频道。

IRC

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

Matrix

#prometheus:matrix.org.

用户邮件列表

Discourse 论坛

位于 discuss.prometheus.io 的网页版讨论论坛，由 Discourse 托管。

公开活动日历

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

如果您只想了解概况，只需使用我们的浏览器时区网页视图。

如果您使用 Google 产品，有一个自动链接将其添加到您自己的 Google 日历。

如果您使用其他日历，可以使用一个 .ics 文件添加到非 Google 日历。

社交媒体

GitHub

要提交错误报告和功能请求，请使用相关 Prometheus 仓库的 GitHub 问题跟踪器。对于问题和讨论，许多仓库都提供 GitHub 讨论功能。通常，此处列出的其他社区渠道最适合获取支持或讨论 overarching 主题。

请不要向个别项目成员寻求支持。请改用上述渠道，以便整个社区都能帮助您，并从提供的解决方案中受益。如果社区支持不足以满足您的情况，请参阅支持与培训页面。

贡献

我们欢迎社区贡献！请参阅相应 Prometheus 仓库中的 CONTRIBUTING.md 文件，了解如何提交更改。如果您计划进行更复杂或可能存在争议的更改，请在发送拉取请求之前在开发者 IRC 频道或邮件列表上进行讨论。

我们每周举办面向 Prometheus 开发和贡献的公开会议。会议旨在让开发者和维护者见面并解决问题、结对评审，以及讨论 Prometheus 及相关官方项目（例如 node_exporter、alertmanager）的开发方面事宜。下面链接的文档包含所有详细信息，包括如何注册。

Slack 频道

CNCF Slack 上的 #prometheus-dev 频道。

IRC

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

Matrix

#prometheus-dev:matrix.org.

开发者邮件列表

prometheus-developers（镜像）

  • 用于讨论 Prometheus 开发相关事宜。

办公时间

Prometheus 贡献者办公时间

  • 每周公开会议，重点关注 Prometheus 的开发和贡献。

开发者峰会

开发者峰会是讨论更深入开发主题的公开会议。目前每月举行一次线上会议。（详情请查看上方社区部分链接的公开活动日历。）Prometheus 团队根据其他渠道的近期讨论来确定议程。要提议一个主题，请在峰会前至少 24 小时发送邮件至开发者邮件列表。

从 2024 年起，我们维护一份公开的滚动会议纪要文档。您可以在下方找到我们的历史会议纪要。

开发者峰会主持人

主持人角色旨在帮助 Prometheus 团队有效运营开发者峰会。这是一个轮换角色（每次会议更换），其职责分布在峰会的不同阶段：

峰会前

峰会前，主持人的主要目标是帮助 Prometheus 团队确定议程和要讨论的主题，同时确保得票最多主题的相关方能够参加峰会。我们建议以下任务：

  • 会议前两三天，在我们的公共社区渠道发送提醒，邀请大家添加议程主题，并邀请 Prometheus 团队成员和维护者对自己想讨论的主题进行投票。
  • 会议前一天，联系得票最多的“主题所有者”，确保他们能参加峰会。

峰会期间

峰会期间，主持人要确保会议顺利进行，并在需要时达成共识。我们建议以下任务：

  • 准时开始会议。使用 @prometheus.io 账户获取会议管理员权限。
  • 开始录制并声明行为准则适用。
  • 根据投票和当前与会者选择要讨论的主题。
  • 在共享文档中做笔记或寻找志愿者做笔记。
  • 当讨论停滞不前或偏离主题时，策略性地介入。
  • 在需要时号召达成共识。

峰会后

会议结束后，主持人的最后一项任务是通过向 Prometheus 团队邮件列表发送邮件，为下一次峰会寻找新的主持人。

导师计划

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

请查看上述链接以了解未来的计划日期、申请详情和项目。

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

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

  • 如果您想帮助我们指导学员，请随时通过 #prometheus-dev Slack 频道或电子邮件与团队联系。
  • 如果您想建议将某个 OSS Prometheus 生态系统倡议转化为导师项目，请随时在相关工作产物（例如 GitHub 问题）上发表评论。

致学员

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

入门清单

  • 请查看并确认我们的行为准则。简而言之：友善待人，待人如己。
  • 在 CNCF Slack 上创建一个账户。请添加任何个人资料照片，使其独一无二。您可以在那里联系到任何一位导师。
  • 将您的 Slack 账户句柄发送给您的导师，以便我们将您添加到私有频道。我们通常会有一个只有您和您的主要导师的私有频道，以及一个包含所有学员、前学员和导师的第二个频道（#thanos-prometheus-mentees）。
  • 加入主要的 Prometheus Slack 频道 #prometheus 和 #prometheus-dev，以便将来与社区互动。
  • 在 #prometheus-dev Slack 频道上，用几句话介绍一下自己，打个招呼！💜
  • 欢迎您加入社交媒体，开始关注他人并积累自己的粉丝！谁知道呢，也许您会沉迷其中？(: 欢迎发布任何与 Prometheus 相关的内容，同时提及 @prometheus.io。
  • 请导师安排一次每周 2:1 的会议（强烈推荐）。
  • 阅读我们的通用贡献指南，以及 Prometheus 仓库中的具体指南。
  • 仔细阅读您的主要 GitHub 问题，并开始思考，但不要有压力！最好从一个小任务开始，慢慢进入状态。🚀

提示与建议

您可以遵循一些建议，以充分利用与我们在一起的时间！

  • PR 受阻，寻找人评审您的贡献，或者对 CI 失败有快速问题？优先选择公共沟通渠道（#prometheus 和 #prometheus-dev），而不是私信或私有频道。Prometheus 拥有一个庞大的社区，可以快速帮助您解决任何问题。还有一些学员可能已经遇到过类似的问题！
  • 向其他学员和前学员问好。我们甚至为此创建了一个专门的频道，以便您可以组队并共同创造更大的事物：建立关系，也许是未来的合作项目，或者只是互相帮助！以 2020 年夏季为例。之前的 Thanos 学员发起了周五趣味聚会，效果非常好！想发起类似活动吗？向前学员请教他们的建议。🤗
  • 跳出思维定势。您是否觉得项目开发、功能或社区中有什么特别令人痛苦的地方？帮助我们改进并提出建议！
  • 参与项目生命周期。我们活跃于许多会议，例如 KubeCon、PromCon、FOSDEM、GoDays。我们参与 CNCF SIG、许多附带倡议、博客文章和视频。请帮助我们！欢迎您提升社交媒体知名度、开始写博客，甚至在会议上发表演讲。如果您对任何事情充满热情，请随时向您的导师寻求指导！我们很乐意提供帮助。
  • 在实习期间，我们欢迎甚至鼓励您为任何您想贡献的事情做出贡献。等待 PR 评审一段时间是很常见的（毕竟是开源项目！），所以同时推进 2 到 3 件事情并不罕见。您也不必将贡献局限于 Prometheus 项目。为我们依赖或有关系的其他项目做贡献是完全可以的。我们也鼓励 Prometheus 学员为 Prometheus 生态系统项目做贡献，例如其他 Prometheus 仓库，甚至是 Cortex 和 Thanos。这是因为我们是更大的 Prometheus 生态系统家族的一员。
  • 尝试独立并对自己要交付的功能负责。越早开始主导您的任务，对您越好！一开始会很困难，但请尝试从用户体验的角度思考。使用它时犯错是难还是容易？迁移到此功能有多困难？我们能做些什么来减少数据丢失错误？
  • 尝试通过评审其他贡献者、学员或导师的拉取请求来帮助他人！这听起来很吓人，但实际上这是学习编码实践、模式以及如何维护高质量代码库的最佳方式！
  • 尝试使用迭代开发过程。从小的、简单的假设开始，一旦您有了可行的示例，就不断改进并与导师讨论。小的更改易于评审和接受 😄。
  • 尝试制定一个概念验证，它可以作为基线，并在此基础上进行改进。这些是真实世界的项目，所以不可能每次都有确定的解决方案，而概念验证是快速确定可行性的方法。
  • 言行举止要像您是项目的维护者。理想情况下，是您希望在贡献的项目中遇到的那种好维护者。虽然听起来很吓人，但这是建立信任、承担更多责任和带来巨大价值的最佳方式（例如，评审他人的工作并为他们解决问题通常比自己写代码更重要！）。
  • 享受乐趣，探索和学习（即使在错误中）！

导师计划结束并不意味着一切都结束了！欢迎您继续贡献、编码和帮助他人。谁知道呢，也许有一天您会充满热情，成为一名维护者！

致导师

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

回顾

在导师计划的中期和最后一次会议上，最好与学员坐下来，为导师和学员收集可行的经验教训。由于我们之间的差异以及任务和情况的不同，导师和学员的体验总是不同的。我们总是想检查我们的体验，无论我们是否达到了最初的目标。如果目标没有达到，那么在诚实、无责备的氛围中讨论这一点就显得尤为重要。如果体验大部分是积极的，我们也想知道哪些做法有效，以便加强最佳实践。

回顾过程示例如下：

  • 会议前一周，提醒学员计划的回顾及其内容（例如链接本指南）。这让每个人都可以在一周内思考哪些做得好，哪些做得不好。
  • 会议期间，首先进行回顾。这是会议最重要的部分，不要让其他事情（例如项目状态）影响它。
    • 在工作文档中写下两个部分：我们做得好的地方，我们可以做得更好的地方。
    • 给每个人 5-7 分钟的时间在这两个部分写下项目（例如实时）。要具体、无责备、诚实。这不是为了冒犯任何人，而是为了为导师和学员的工作寻找改进之处。对自己要严厉，但也要尝试平衡好的部分和需要改进的部分。总有我们可以做得更好的地方（或者更糟！）。
    • 当每个人都完成后，创建一个新部分：经验教训。
    • 逐一浏览列表中的所有项目。讨论细节。尝试找出如何缓解问题或继续做什么的想法。将这些内容写在经验教训部分。
    • 最后，将经验教训分享给邮件列表上的团队。
    • 考虑将所有经验教训整理成某种形式的公开内容。

公开演讲或写作

为了让学员分享他们学到的知识并提高公开演讲技巧，在导师计划周期结束时，导师可以鼓励学员在相关论坛上创建某种形式的公开内容。我们过去的一些想法：

  • 鼓励学员在下一次相关会议或聚会上演讲（甚至与他们共同演讲！）（例如 PromCon、KubeCon、本地聚会等）！
  • 鼓励学员在 Prometheus 博客 或他们的个人博客上写一篇博客文章！
  • 如果我们有足够的内容，也可以选择举办一次虚拟的“学员聚会”。

行为准则

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

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

CNCF logo CNCF logo

致谢

Prometheus 由 Matt T. Proud 和 Julius Volz 创建。其初期大部分开发由 SoundCloud 赞助。

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

Prometheus 的标志由 Robin Greenwood 贡献。

本页内容