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

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

---

Индекс LLMS: [llms.txt](/ru/llms.txt)

---

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

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

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

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

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

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

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

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

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

## Часто задаваемые вопросы {#frequently-asked-questions}

### Как получить трассировку стека {#how-to-get-a-stack-trace}

``` bash
$ kill -QUIT $PID
```

### Как узнать версию etcd {#how-to-get-etcd-version}

``` bash
$ etcd --version
```

### Как получить конфигурацию и журнал etcd при запуске службой systemd «etcd2.service» {#how-to-get-etcd-configuration-and-log-when-it-runs-as-systemd-service-etcd2service}

``` bash
$ sudo systemctl cat etcd2
$ sudo journalctl -u etcd2
```

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

[etcd-issue]: https://github.com/etcd-io/etcd/issues/new
[filing-good-bugs]: http://fantasai.inkedblade.net/style/talks/filing-good-bugs/