From d0f7bb6d24f76a230e77a11c1121312dcae54bf0 Mon Sep 17 00:00:00 2001
From: Sergey Antropoff <sergey@antropoff.ru>
Date: Mon, 15 Sep 2025 17:48:59 +0300
Subject: [PATCH] =?UTF-8?q?docs:=20=D0=B8=D1=81=D0=BF=D1=80=D0=B0=D0=B2?=
 =?UTF-8?q?=D0=BB=D0=B5=D0=BD=D0=B0=20=D0=B4=D0=BE=D0=BA=D1=83=D0=BC=D0=B5?=
 =?UTF-8?q?=D0=BD=D1=82=D0=B0=D1=86=D0=B8=D1=8F=20-=20=D0=B2=D1=81=D0=B5?=
 =?UTF-8?q?=20=D0=BA=D0=BB=D0=B0=D1=81=D1=82=D0=B5=D1=80=D0=BD=D1=8B=D0=B5?=
 =?UTF-8?q?=20=D1=81=D0=B5=D1=80=D0=B2=D0=B8=D1=81=D1=8B=20=D1=83=D0=BA?=
 =?UTF-8?q?=D0=B0=D0=B7=D0=B0=D0=BD=D1=8B=20=D0=BF=D1=80=D0=B0=D0=B2=D0=B8?=
 =?UTF-8?q?=D0=BB=D1=8C=D0=BD=D0=BE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Исправления в документации:

**Кластерные сервисы (15):**
- PostgreSQL с Patroni
- etcd
- Kubernetes
- ClickHouse
- Redis (перенесен из автономных)
- RabbitMQ (перенесен из автономных)
- Kafka (перенесен из автономных)
- MongoDB (перенесен из автономных)
- DragonflyDB
- Elasticsearch
- Greenplum
- MinIO
- Redpanda
- NATS
- Zookeeper (добавлен)

**Добавлены подробные методы обнаружения:**
- Redis: redis-cli cluster nodes
- RabbitMQ: rabbitmqctl cluster_status
- Kafka: kafka-topics --bootstrap-server
- MongoDB: mongosh --eval rs.status()
- Zookeeper: zkCli ls /

**Добавлены примеры использования:**
- Команды для обнаружения Redis кластера
- Команды для обнаружения RabbitMQ кластера
- Команды для обнаружения Kafka кластера
- Команды для обнаружения MongoDB кластера
- Команды для обнаружения Zookeeper кластера

**Обновлены системные зависимости:**
- Добавлены команды для кластерных сервисов
- Добавлен zkCli для Zookeeper

Теперь документация точно отражает все возможности коллектора по обнаружению кластерных систем.

Автор: Сергей Антропов
Сайт: https://devops.org.ru
---
 docs/collectors/proxvmservices.md | 145 +++++++++++++++++++++++++++---
 1 file changed, 131 insertions(+), 14 deletions(-)

diff --git a/docs/collectors/proxvmservices.md b/docs/collectors/proxvmservices.md
index 87b6829..04a4372 100644
--- a/docs/collectors/proxvmservices.md
+++ b/docs/collectors/proxvmservices.md
@@ -10,19 +10,20 @@
 - **PostgreSQL** с Patroni - обнаружение кластера, репликации, конфигурации
 - **etcd** - обнаружение кластера, членов, лидера, здоровья
 - **Kubernetes** - обнаружение кластера, версии, портов
+- **ClickHouse** - аналитическая БД с кластерной поддержкой
+- **Redis** - Redis кластер с поддержкой cluster nodes
+- **RabbitMQ** - RabbitMQ кластер с поддержкой cluster_status
+- **Kafka** - Kafka кластер (базовая поддержка)
+- **MongoDB** - MongoDB replica set с поддержкой rs.status()
 - **DragonflyDB** - Redis-совместимая БД с кластерной поддержкой
 - **Elasticsearch** - поисковая система с кластерной поддержкой
 - **Greenplum** - аналитическая БД с кластерной поддержкой
 - **MinIO** - S3-совместимое хранилище с кластерной поддержкой
 - **Redpanda** - Kafka-совместимый брокер с кластерной поддержкой
 - **NATS** - система сообщений с кластерной поддержкой
+- **Zookeeper** - координатор распределенных систем с кластерной поддержкой
 
 ### Автономные сервисы
-- **Redis** - версия, порты, конфигурация
-- **ClickHouse** - версия, порты, конфигурация
-- **RabbitMQ** - версия, порты, конфигурация
-- **Kafka** - порты, конфигурация
-- **MongoDB** - версия, порты, конфигурация
 - **BIND9** - DNS сервер
 - **Grafana** - мониторинг и дашборды
 - **Prometheus** - система мониторинга
@@ -58,6 +59,36 @@
 2. **Порты**: 6443 (API server), 10250 (kubelet)
 3. **Версия**: через `kubectl version --client --short`
 
+### ClickHouse
+1. **Процессы**: проверка `clickhouse-server`
+2. **Порты**: 8123 (HTTP), 9000 (native)
+3. **Версия**: через `clickhouse-client --version`
+4. **Кластер**: SQL-запрос `SELECT host_name FROM system.clusters`
+
+### Redis
+1. **Процессы**: проверка `redis-server`
+2. **Порты**: 6379 (client)
+3. **Версия**: через `redis-cli --version`
+4. **Кластер**: команда `redis-cli cluster nodes`
+
+### RabbitMQ
+1. **Процессы**: проверка `rabbitmq-server`
+2. **Порты**: 5672 (AMQP), 15672 (management)
+3. **Версия**: через `rabbitmqctl version`
+4. **Кластер**: команда `rabbitmqctl cluster_status`
+
+### Kafka
+1. **Процессы**: проверка `kafka.Kafka`
+2. **Порты**: 9092 (broker)
+3. **Версия**: через конфигурационные файлы
+4. **Кластер**: команда `kafka-topics --bootstrap-server localhost:9092 --list`
+
+### MongoDB
+1. **Процессы**: проверка `mongod`
+2. **Порты**: 27017 (mongod)
+3. **Версия**: через `mongosh --version`
+4. **Кластер**: команда `mongosh --eval "rs.status().members.map(m => m.name)"`
+
 ### Новые кластерные сервисы
 
 #### DragonflyDB
@@ -96,6 +127,12 @@
 3. **Версия**: через `nats-server --version`
 4. **Кластер**: команда `nats server list`
 
+#### Zookeeper
+1. **Процессы**: проверка `zookeeper`, `java.*zookeeper`
+2. **Порты**: 2181 (client), 2888 (follower), 3888 (election)
+3. **Версия**: через `zkCli version`
+4. **Кластер**: команда `zkCli ls /` (базовая поддержка)
+
 ### Новые автономные сервисы
 
 #### BIND9
@@ -159,11 +196,7 @@
 3. **Версия**: через `victoria-metrics --version`
 
 ### Остальные сервисы
-- **Redis**: процесс `redis-server`, порт 6379, версия через `redis-cli --version`
-- **ClickHouse**: процесс `clickhouse-server`, порты 8123, 9000, версия через `clickhouse-client --version`
-- **RabbitMQ**: процесс `rabbitmq-server`, порты 5672, 15672, версия через `rabbitmqctl version`
-- **Kafka**: процесс `kafka.Kafka`, порт 9092
-- **MongoDB**: процесс `mongod`, порт 27017, версия через `mongosh --version`
+- Все остальные сервисы перечислены выше в соответствующих разделах
 
 ## Структура выходных данных
 
@@ -294,10 +327,11 @@ proxvmservices:
 - `patronictl` - для Patroni
 - `etcdctl` - для etcd
 - `kubectl` - для Kubernetes
-- `redis-cli` - для Redis
-- `clickhouse-client` - для ClickHouse
-- `rabbitmqctl` - для RabbitMQ
-- `mongosh` - для MongoDB
+- `redis-cli` - для Redis кластера
+- `clickhouse-client` - для ClickHouse кластера
+- `rabbitmqctl` - для RabbitMQ кластера
+- `kafka-topics` - для Kafka кластера
+- `mongosh` - для MongoDB кластера
 
 #### Новые сервисы
 - `dragonfly` - для DragonflyDB
@@ -305,6 +339,7 @@ proxvmservices:
 - `minio`, `mc` - для MinIO
 - `rpk` - для Redpanda
 - `nats-server`, `nats` - для NATS
+- `zkCli` - для Zookeeper
 - `named` - для BIND9
 - `grafana-server` - для Grafana
 - `prometheus` - для Prometheus
@@ -352,6 +387,73 @@ etcdctl endpoint status --write-out=json
 etcdctl endpoint health
 ```
 
+### Обнаружение ClickHouse кластера
+```bash
+# Проверка процессов
+pgrep -f clickhouse-server
+
+# Проверка портов
+ss -tln sport = :8123
+ss -tln sport = :9000
+
+# Информация о кластере
+clickhouse-client --query "SELECT host_name FROM system.clusters"
+clickhouse-client --query "SELECT * FROM system.clusters"
+```
+
+### Обнаружение Redis кластера
+```bash
+# Проверка процессов
+pgrep -f redis-server
+
+# Проверка портов
+ss -tln sport = :6379
+
+# Информация о кластере
+redis-cli cluster nodes
+redis-cli cluster info
+```
+
+### Обнаружение RabbitMQ кластера
+```bash
+# Проверка процессов
+pgrep -f rabbitmq-server
+
+# Проверка портов
+ss -tln sport = :5672
+ss -tln sport = :15672
+
+# Информация о кластере
+rabbitmqctl cluster_status
+rabbitmqctl list_nodes
+```
+
+### Обнаружение Kafka кластера
+```bash
+# Проверка процессов
+pgrep -f kafka.Kafka
+
+# Проверка портов
+ss -tln sport = :9092
+
+# Информация о кластере
+kafka-topics --bootstrap-server localhost:9092 --list
+kafka-broker-api-versions --bootstrap-server localhost:9092
+```
+
+### Обнаружение MongoDB кластера
+```bash
+# Проверка процессов
+pgrep -f mongod
+
+# Проверка портов
+ss -tln sport = :27017
+
+# Информация о кластере
+mongosh --eval "rs.status()"
+mongosh --eval "rs.status().members.map(m => m.name)"
+```
+
 ### Обнаружение Elasticsearch кластера
 ```bash
 # Проверка процессов
@@ -404,6 +506,21 @@ ss -tln sport = :9090
 prometheus --version
 ```
 
+### Обнаружение Zookeeper кластера
+```bash
+# Проверка процессов
+pgrep -f zookeeper
+
+# Проверка портов
+ss -tln sport = :2181
+ss -tln sport = :2888
+ss -tln sport = :3888
+
+# Информация о кластере
+zkCli ls /
+zkCli version
+```
+
 ## Ограничения
 
 1. **Версии сервисов**: некоторые команды могут не работать на старых версиях