You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: ydb/docs/en/core/devops/ansible/initial-deployment.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -18,7 +18,7 @@ For large-scale setups, it is recommended to use at least 9 servers for highly a
18
18
19
19
{% endnote %}
20
20
21
-
You can download the repository with example playbooks for installing {{ ydb-short-name }} on the cluster from GitHub – `git clone https://github.com/ydb-platform/ydb-ansible-examples.git`. This repository contains a few installation templates for deploying {{ ydb-short-name }} clusters in subfolders, as well as scripts for generating TLS certificates and requirement files for installing necessary Python packages. In this article, we'll use the `3-nodes-mirror-3-dc` subfolder for the most simple setup. Alternatively, you can similarly use `8-nodes-block-4-2` or `9-nodes-mirror-3-dc` if you have the necessary number of suitable servers.
21
+
Download the GitHub repository with examples for installing {{ ydb-short-name }} cluster – `git clone https://github.com/ydb-platform/ydb-ansible-examples.git`. This repository contains a few installation templates for deploying {{ ydb-short-name }} clusters in subfolders, as well as scripts for generating TLS certificates and requirement files for installing necessary Python packages. In this article, we'll use the `3-nodes-mirror-3-dc` subfolder for the most simple setup. Alternatively, you can similarly use `8-nodes-block-4-2` or `9-nodes-mirror-3-dc` if you have the necessary number of suitable servers.
# Обеспечение наблюдаемости кластера {{ ydb-short-name }}, развёрнутого с помощью Ansible
2
2
3
-
В этом разделе документации {{ ydb-short-name }} рассматриваются различные темы, связанные с наблюдаемостью (observability), специфичные для кластеров [развёрнутых с помощью Ansible](../initial-deployment.md).
3
+
В этом разделе документации {{ ydb-short-name }} рассматриваются различные аспекты наблюдаемости (observability), специфичные для кластеров,[развёрнутых с помощью Ansible](../initial-deployment.md).
4
4
5
5
*[{#T}](logging.md)
6
6
7
-
Также есть отдельный раздел с [{#T}](../../../reference/observability/index.md), содержащий статьи, не зависящие от выбранного метода развёртывания кластера.
7
+
Также есть отдельный раздел [{#T}](../../../reference/observability/index.md), содержащий статьи, не зависящие от выбранного метода развёртывания кластера.
Copy file name to clipboardExpand all lines: ydb/docs/ru/core/devops/ansible/observability/logging.md
+9-9Lines changed: 9 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@
4
4
5
5
## Просмотр логов с помощью Ansible playbook
6
6
7
-
Репозиторий [ydb-ansible](https://github.com/ydb-platform/ydb-ansible) содержит playbook под названием `ydb_platform.ydb.logs`, который можно использовать для просмотра логов со всех узлов {{ ydb-short-name }} кластера. Этот playbook собирает логи с узлов и выводит в `stdout`, что позволяет при необходимости дальше их обработать, например, с помощью команд `grep` или `awk`.
7
+
Репозиторий [ydb-ansible](https://github.com/ydb-platform/ydb-ansible) содержит playbook под названием `ydb_platform.ydb.logs`, который можно использовать для просмотра логов со всех узлов кластера {{ ydb-short-name }}. Этот playbook собирает логи с узлов и выводит их в `stdout`, что позволяет при необходимости дальше их обработать, например, с помощью команд `grep` или `awk`.
В кластере {{ ydb-short-name }} есть два основных типа узлов:
20
20
21
-
* Storage (также известны как статические)
22
-
* Database (также известны как динамические)
21
+
* Storage (также известные как статические)
22
+
* Database (также известные как динамические)
23
23
24
-
Задачи в playbook'е`ydb_platform.ydb.logs` размечены тегами по типам узлов, благодаря чему можно использовать функциональность тегов Ansible для фильтрации логов по типу узла.
24
+
Задачи в playbook `ydb_platform.ydb.logs` размечены тегами по типам узлов, благодаря чему можно использовать функциональность тегов Ansible для фильтрации логов по типу узла.
25
25
26
26
Следующие две команды эквивалентны и будут выводить логи статических узлов:
Чтобы вручную получить доступ к логам кластера {{ ydb-short-name }} через `ssh`, выполните следующие действия:
58
58
59
-
1. Сформируйте команду `ssh` для доступа к серверу, на котором запущен узел {{ ydb-short-name }}, для которого вам нужны логи. Базовая версия будет выглядеть как `ssh -i <path-to-ssh-key> <username>@<hostname>`. Возьмите значения для составления этой команды из `inventory/50-inventory.yaml`, который вы использовали для развёртывания:
59
+
1. Сформируйте команду `ssh` для доступа к серверу, на котором запущен узел {{ ydb-short-name }}, для которого вам нужны логи. Базовая версия будет выглядеть как `ssh -i <path-to-ssh-key> <username>@<hostname>`. Возьмите значения для составления этой команды из файла `inventory/50-inventory.yaml`, который вы использовали для развёртывания:
60
60
61
61
*`<path-to-ssh-key>` — это `children.ydb.ansible_ssh_private_key_file`;
62
62
*`<username>` — это `children.ydb.ansible_user`;
63
63
*`<hostname>` — это один из `children.ydb.hosts`.
64
64
65
-
2. Выберите логи какого systemd юнита вам нужны. Если вам уже известно название юнита, то этот шаг можно пропустить. После входа на сервер с помощью `ssh` команды, созданной на предыдущем шаге, получите список связанных с {{ ydb-short-name }} systemd юнитов, используя `systemctl list-units | grep ydb`. Как правило там будет один статический узел и несколько динамических узлов.
65
+
2. Выберите, логи какого systemd юнита вам нужны. Если вам уже известно название юнита, этот шаг можно пропустить. После входа на сервер с помощью команды `ssh`, созданной на предыдущем шаге, получите список связанных с {{ ydb-short-name }} systemd юнитов, используя `systemctl list-units | grep ydb`. Как правило, там будет один статический узел и несколько динамических узлов.
3. Возьмите название systemd юнита из предыдущего шага и используйте его в следующей команде `journalctl -u <systemd-unit>`, чтобы фактически отобразить логи. Вы можете указать `-u` несколько раз, чтобы отобразить логи нескольких юнитов, а также использовать любые другие аргументы из `man journalctl` для настройки вывода команды.
77
+
3. Возьмите название systemd юнита из предыдущего шага и используйте его в следующей команде `journalctl -u <systemd-unit>`, чтобы фактически отобразить логи. Вы можете указать `-u` несколько раз, чтобы отобразить логи нескольких юнитов, а также использовать любые другие аргументы из `man journalctl` для настройки вывода команды.
0 commit comments