Повідомлення про помилки

Якщо будь-яка частина проєкту etcd має помилки або помилки в документації, будь ласка, повідомте нам, відкривши тікет. Ми ставимося до багів і помилок дуже серйозно і вважаємо, що жодна проблема не є занадто малою. Перед створенням звіту про помилку, будь ласка, перевірте, чи не існує вже звіт про ту ж проблему.

Щоб зробити звіт про помилку точним і легким для розуміння, будь ласка, спробуйте створювати звіти про помилки, які є:

• Конкретними. Включайте якомога більше деталей: яка версія, яке середовище, яка конфігурація тощо. Якщо помилка повʼязана з роботою сервера etcd, будь ласка, додайте журнал etcd (початковий журнал з конфігурацією etcd особливо важливий).

• Відтворюваними. Включайте кроки для відтворення проблеми. Ми розуміємо, що деякі проблеми можуть бути важко відтворити, будь ласка, включайте кроки, які можуть призвести до проблеми. Якщо можливо, будь ласка, додайте до звіту про помилку уражену теку даних etcd і трасування стека.

• Ізольованими. Будь ласка, спробуйте ізолювати і відтворити помилку з мінімальними залежностями. Це значно уповільнить швидкість виправлення помилки, якщо в звіті про помилку буде занадто багато залежностей. Налагодження зовнішніх систем, які залежать від etcd, не входить до нашої компетенції, але ми раді надати поради в правильному напрямку або допомогти з використанням самого etcd.

• Унікальними. Не дублюйте існуючий звіт про помилку.

• Обмеженими. Одна помилка на звіт. Не додавайте іншу помилку в один звіт.

Можливо, варто прочитати статтю Еліки Етемад про подання хороших звітів про помилки перед створенням звіту про помилку.

Ми можемо попросити додаткову інформацію для виявлення помилки. Дубльований звіт про помилку буде закрито.

Часті запитання

Як отримати трасування стека

$ kill -QUIT $PID

Як отримати версію etcd

$ etcd --version

Як отримати конфігурацію та журнал etcd, коли він працює як служба systemd ‘etcd2.service’

$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2

Через помилку в висхідному systemd, journald може пропустити останні кілька рядків журналу, коли його процеси завершуються. Якщо journalctl каже, що etcd зупинився без фатального або панічного повідомлення, спробуйте sudo journalctl -f -t etcd2, щоб отримати повний журнал.