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 日历的链接 。

如果您使用其他日历，有一个用于非 Google 日历的 .ics 文件 。

社交媒体

GitHub

要提交错误报告和功能请求，请使用相关 Prometheus 仓库  的 GitHub issue tracker。对于问题和讨论，许多仓库都提供 GitHub discussions。通常，此处列出的其他社区渠道最适合获得支持或讨论更广泛的话题。

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

贡献

我们欢迎社区贡献！请参阅相应 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 频道上与团队联系，或发送电子邮件 。
  • 如果您想提议将某个开源 Prometheus 生态系统倡议转化为导师计划项目，请随时在相关工作产物（例如 GitHub issue）上评论。

致学员

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

入职清单

  • 请查看并确认我们的行为准则。简而言之：友好待人，己所不欲，勿施于人。
  • 在 CNCF Slack 上创建一个账户。请添加任何个人资料照片，使其独一无二。您可以在那里联系到任何一位导师。
  • 将您的 Slack 账户句柄发送给您的导师，以便我们将您添加到私人频道。我们倾向于有一个仅包含您和您的主要导师的私人频道，以及另一个包含所有学员、前学员和导师的频道 (#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 学员们开始了周五趣味聚会 ，效果非常好！想发起类似活动吗？向其他前学员请教他们的建议。🤗
  • 跳出常规思维。您是否觉得项目开发、功能或社区中有什么地方特别痛苦？帮助我们改进并提出改进建议！
  • 参与项目生命周期。我们活跃于许多会议，例如 KubeCon、PromCon、FOSDEM、GoDays。我们参与 CNCF SIGs、许多周边活动、博客文章和视频。请帮助我们！欢迎您提升您的社交媒体知名度，开始写博客，甚至在会议上演讲。无论您对什么充满热情，都可以随时向您的导师寻求指导！我们很乐意提供帮助。
  • 在实习期间，我们欢迎甚至鼓励您为任何您想做的事情做出贡献。等待 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 贡献。

本页内容