Перейти к содержанию

Сообщение об ошибках

Как создавать отчёты о проблемах в проекте etcd

Если в какой-либо части проекта etcd обнаружена ошибка или неточность в документации, сообщите нам, создав issue . Мы очень серьёзно относимся к ошибкам и считаем, что незначительных проблем не бывает. Перед созданием отчёта убедитесь, что issue с описанием той же проблемы ещё не существует.

Чтобы отчёт был точным и понятным, постарайтесь соблюдать следующие требования:

  • Конкретность. Укажите как можно больше подробностей: версию, окружение, конфигурацию и другие существенные сведения. Если ошибка связана с работой сервера etcd, приложите журнал etcd; особенно важны начальные сообщения с конфигурацией etcd.

  • Воспроизводимость. Приведите шаги для воспроизведения проблемы. Некоторые проблемы трудно воспроизвести, но в таком случае укажите хотя бы действия, которые могут к ней привести. По возможности приложите затронутый каталог данных etcd и трассировку стека.

  • Изолированность. Постарайтесь изолировать и воспроизвести ошибку с минимальным числом зависимостей. Большое количество зависимостей в отчёте существенно замедляет исправление. Отладка внешних систем, зависящих от etcd, выходит за рамки проекта, но мы готовы подсказать правильное направление или помочь с использованием самого etcd.

  • Уникальность. Не дублируйте существующие отчёты об ошибках.

  • Ограниченная область. Один отчёт должен описывать одну ошибку. Не добавляйте в тот же отчёт другую проблему.

Перед созданием отчёта полезно прочитать статью Elika Etemad о качественных отчётах об ошибках .

Для локализации ошибки мы можем запросить дополнительные сведения. Дублирующий отчёт будет закрыт.

Часто задаваемые вопросы

Как получить трассировку стека

$ kill -QUIT $PID

Как узнать версию etcd

$ etcd --version

Как получить конфигурацию и журнал etcd при запуске службой systemd «etcd2.service»

$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2

Из-за ошибки в systemd journald может потерять несколько последних строк журнала при завершении процессов. Если journalctl сообщает, что etcd остановлен, но в журнале нет сообщения fatal или panic, выполните sudo journalctl -f -t etcd2, чтобы получить полный журнал.