跳转到主要内容

报告缺陷

如何为 etcd 项目提交问题报告

如果 etcd 项目任何部分存在缺陷或文档错误,请通过 打开问题 告知我们。我们高度重视缺陷和错误,认为任何问题都不算太小。创建缺陷报告前,请确认尚未存在报告相同问题的议题。

为了使错误报告准确且易于理解,请尽量编写如下格式的错误报告:

  • 具体。尽可能提供详细信息:包括版本号、运行环境、配置信息等。若该问题与运行 etcd 服务器相关,请附上 etcd 日志(包含 etcd 配置的启动日志尤为重要)。

  • 可复现。请提供复现问题的完整步骤。我们理解某些问题可能难以复现,请尽可能提供可能导致问题的步骤。如有可能,请在缺陷报告中附上受影响的 etcd 数据目录和堆栈跟踪信息。

  • 独立。请尽量在依赖最少的情况下复现问题。若报告中涉及过多依赖,将显著降低问题修复速度。排查依赖 etcd 的外部系统不在支持范围内,但我们可以提供正确的指导方向,或协助使用 etcd 本身。

  • 唯一。请勿重复提交现有错误报告。

  • 作用域明确。每个报告仅针对一个缺陷。请勿在单个报告中跟进其他缺陷。

在创建错误报告前,阅读 Elika Etemad 关于撰写优质错误报告的文章 可能会有所帮助。

我们可能需要进一步信息以定位问题。重复的错误报告将被关闭。

常见问题解答

如何获取堆栈跟踪

$ kill -QUIT $PID

如何获取 etcd 版本

$ etcd --version

如何获取以 etcd2.service 运行的 systemd 服务的 etcd 配置和日志

$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2

由于上游 systemd 的一个缺陷,当 journald 的进程退出时,可能会丢失最后几行日志。如果 journalctl 显示 etcd 停止但未出现致命错误或 panic 消息,请尝试 sudo journalctl -f -t etcd2 以获取完整日志。