来自 OpenTelemetry 贡献者体验调查的见解
OpenTelemetry 贡献者体验 SIG 最近对社区进行了调查，以了解贡献该项目是什么样的，以及我们可以做些什么来改善贡献者体验。贡献者体验调查询问了贡献者对项目组织、SIG 贡献、领导委员会互动和活动参与的看法。我们收到了 120 份回复，并听取了所有 47 个特别兴趣小组 (SIG) 的意见。我们将利用这些反馈来使贡献 OpenTelemetry 变得更容易、更有价值。非常感谢所有参与调查的人！让我们回顾一下结果。
主要收获
我们进行此次调查是为了了解项目可以做得更好的地方。以下是我们学到的关键内容以及我们可以改进贡献者体验的领域。
- 入门：48% 的新贡献者不确定如何开始。SIG 内部和跨 SIG 的沟通以及贡献指南需要改进。
- SIG 会议：82% 的贡献者认为 SIG 会议很有用。参加会议与对项目导航和贡献的了解程度相关，但有些人不喜欢会议所需的同步性。
- 工作流程：超过一半的贡献者未能及时收到对其贡献的反馈。他们还经历了项目工具的困扰和守门人的瓶颈。
- 项目和子项目优先级：不到一半的维护者能够自信地说他们知道 OpenTelemetry 领导委员会的优先级。贡献者还表示，很难找到子项目的优先级。
- 活动：贡献者希望有更多以协作而非讲座为重点的线下活动。
详细见解
本次调查共有 42 个问题，涵盖了 OpenTelemetry 贡献者体验的各个方面。在本节中，我们将分析回复并总结我们的发现。
在某些类别中，样本量非常小，因此误差幅度很高。我们在可能的情况下，在括号中包含了回复的数量。
在我们的分析中，我们将自我报告的数据视为真实数据，并将“同意”与“强烈同意”的回复合并，以及将“不同意”与“强烈不同意”合并。因此，例如，当我们说“参加 SIG 会议的贡献者更有可能知道如何开始为任何 SIG 做出贡献”时，我们的意思是那些同意或强烈同意他们定期参加 SIG 会议的贡献者更有可能同意或强烈同意他们知道如何开始做出贡献。
关于受访者
我们听取了 120 位贡献者的意见，其中包括 45 位维护者，并且至少有一位贡献者来自每个 SIG。以下是关于我们受访者的更多信息：
- 63% 的人受雇于可观察性供应商。
- 20% 的人贡献不到六个月。
- 86% 的人居住在北美 (45%) 或EMEA (41%)。这些数字与我们分别计算的 39% 和 43% 大致相符，这些数字是在将devstats 国家统计数据分类到地区后得到的。
- 43% 的人利用自己的时间贡献。
- 71% 的人是 OpenTelemetry 组织的成员。
项目组织
我们请贡献者告诉我们他们对 OpenTelemetry 项目的组织和运营方面的看法。他们知道如何开始吗？他们能自己解决问题吗？SIG 会议有用吗？
在一个像 OpenTelemetry 这样的大型开源项目中，知道如何开始具有挑战性。我们重点关注了我们最新的贡献者，即参与该项目不到两年的贡献者，以了解项目的入职流程的表现如何。在这 56 位该类别的受访者中，只有略多于一半的人知道如何开始为任何 OpenTelemetry SIG 做出贡献。但这仍然意味着 48% 的新贡献者不确定如何开始。目前正在改进整个项目的贡献指南，但显然 OpenTelemetry 贡献者的入职体验仍有改进空间。
我们可以潜在地改善入职体验的一种方法是鼓励新贡献者参加 SIG 会议。在回答该问题的受访者中，82% 的人认为 SIG 会议很有用。进一步的调查分析证实了会议的有用性。
例如，我们发现经常参加 SIG 会议的贡献者更有可能知道如何开始为任何 SIG 做出贡献。
参加 SIG 会议可能还有其他好处。参加会议的人更有可能知道哪些提案更有可能被接受，以及如何为他们想要做出的贡献做出贡献。
为 SIG 贡献
像 OpenTelemetry 这样的开源项目的贡献需要时间：贡献者和审稿人都需要时间。为了评估项目在提供及时反馈方面的进展，我们询问了调查受访者他们的经验。回答者中不到一半的人 (98 位回复中有 48 位，即 49%) 收到及时反馈。当我们将其与贡献者对项目决策过程充分性的看法进行比较时，就会得到以下热力图。我们可以大致得出结论，当贡献者及时获得反馈时，他们更有可能认为决策是充分的。但是，分析这些数据会引出一个重要问题：我们不知道及时反馈在开源项目中的合理基线是什么。我们鼓励其他开源项目运行贡献者调查，以便我们可以将他们的贡献者体验与 OpenTelemetry 贡献者的体验进行比较。
调查询问贡献者他们是否最终能够为自己和用户解决问题。我们将这些答案与贡献者的任期进行了比较。结果表明，较新贡献者（任期不足 2 年）的比例更高，能够解决问题：新贡献者的 77% 对比经验贡献者的 65%。
我们收到了许多有见地的回复，回答了我们的开放式问题。
“您对项目组织或您的贡献经验有任何其他评论吗？您希望在 OTel 贡献者体验中添加或更改什么吗？”
答案大致分为四类：工具、沟通与文档、会议和工作流程。
工具
- 存储库需要更多自动化。
- 构建过程应在 SIG 和存储库之间保持一致。
- 某些存储库中的 CI 过程很麻烦，并且在批准缓慢时需要反复运行。
- 需要一个单一的真相来源来跟踪代码更改，而不是查阅发布说明。
沟通与文档
- 所有 SIG 都应与 SIG Comms 对齐，以使官方文档成为所有参考和教学材料的首选地点。
- 大多数贡献指南都需要改进。
- 没有好的“入门”材料来贡献 Collector 的组件。
- 新贡献者不确定如何提供帮助和增加价值，因为子项目优先级不明确，并且存储库问题众多且难以查找和理解。一些贡献者选择创建分支而不是贡献上游。
- 不清楚应该与哪个 SIG 联系以提出提案，导致贡献者在 SIG 之间来回奔波。
会议
- 有些人无法参加或不愿参加 SIG 会议。
- 对于简单的议题或 PR，会议不应该成为推进的必要条件，但通常似乎这是唯一前进的方式。
- 对于偏好异步工作的人来说，依赖会议的决策过程存在问题。
工作流程
- 工作负担过重的子项目或组件应增加维护者。保持贡献体验尽可能积极和受欢迎是招募新项目领导者的好方法。
- 工作负担过重的存储库应考虑调整写入权限。
- 评审和讨论非常缓慢，可能过于详尽。
- 少数 SIG 领导者的守门行为导致进展缓慢。
维护者、技术委员会和治理委员会
OpenTelemetry 维护者占我们调查总受访者的 37.5%。我们请他们报告他们作为领导者贡献的经验。他们感到多大程度的自主性？他们是否需要做很多工作才能使他们的 SIG 符合规范？他们是否得到了技术委员会和治理委员会的支持？
维护者报告感到高度自主。在 1 (低) 到 5 (高) 的评分中，没有一个人将自主性评分低于 3，89% 的人将自主性评分评为 4 或 5。
在回答有关其 SIG 符合 OpenTelemetry 规范的问题的 43 位维护者中，16 位表示他们的 SIG 未实现规范。其余 27 位将他们的 SIG 评为接近、大部分或完全符合。近 50% 的人表示他们的项目大部分符合。
三分之二的维护者受访者 (44 人中的 29 人) 与技术委员会或治理委员会互动过，但不到一半的人知道领导委员会的优先级。
有关技术委员会和治理委员会的其他问题的回复正在单独于这篇博客文章进行编译和分析。我们计划在不久的将来在公开渠道向 OpenTelemetry 维护者和委员会展示结果。
事件
我们请受访者用他们自己的话告诉我们什么样的活动对项目的增长有用。32 位贡献者做出了回应，他们几乎所有人都表示希望有更多的线下活动。许多人还表示，他们宁愿利用这段时间互相协作，而不是听讲座。我们将回复大致分为六类。有些回复属于多个类别。
我们还询问了贡献者过去和未来参加 KubeCon + CloudNativeCon（云原生技术旗舰会议）的情况。随着 2025 年 6 月首次举行的KubeCon 日本站，现在有 5 届 KubeCon 大会：中国、欧洲、印度、日本和北美。以下是我们了解到的 OpenTelemetry 贡献者参加 KubeCon 活动的情况。
世界上每个地区一半以上的受访者过去参加过 KubeCon 或计划将来参加。
过去参加或计划参加任何 KubeCon 活动的受访者百分比
按居住地区
亚洲、太平洋岛屿、澳大利亚和新西兰 (14) 中美洲、加勒比海和南美洲 (7) 欧洲、非洲和中东 (65) 北美 (56) 71% 57% 71% 64%
我们有兴趣了解哪些 KubeCon 活动吸引了大量来自会议地区以外的 OTel 参与者。总共有 5 位受访者报告了参加 KubeCon 印度站和日本站的活动，因此我们没有将他们纳入以下比较。但值得注意的是，所有 5 位受访者都来自 APAC 以外的地区。在其余 3 场会议中，KubeCon 北美站吸引了来自其他地区的 OpenTelemetry 贡献者的比例最高。
在那些已经参加过 KubeCon 活动或计划将来参加的受访者中，有绝大多数人（73 人中的 63 人，即 86%）表示有兴趣在他们所在地区举办一次单独的、专门的 OpenTelemetry 贡献者活动。相比之下，那些没有参加过 KubeCon 并且不打算参加的人对在他们所在地区举办一次专门的贡献者活动的兴趣略低：46 人中的 34 人（74%）表示他们会参加。
我们分析了最后一个活动问题：如果您参加过 KubeCon + CloudNativeCon，您是否参加过 OpenTelemetry 相关活动，包括 OpenTelemetry Observatory、Contribfest 或维护者轨道会议？在参加过或将要参加会议的 73 位受访者中，53 位（73%）表示他们至少参加过一次 OTel 特定活动。
调查反馈
最后，我们请受访者就调查本身提供反馈。我们收到的多次回复之一是，受访者希望有一种方法来回答关于特定子项目的问题或提供反馈。我们将研究提供未来的调查来满足这一请求。
了解更多
有关详细结果，请参阅匿名化的调查回复。
您的反馈至关重要
再次感谢所有参加调查的人！您的反馈对于指导 OpenTelemetry 的未来发展以及确保它继续满足您不断变化的需求至关重要。通过以下渠道保持联系并了解即将举行的调查：