Aleksandr.Zubarev в 19:05, 15 сентября 2026

2026-09-15T19:05:01Z

← Предыдущая версия		Версия от 19:05, 15 сентября 2026
Строка 1:		Строка 1:
	= Мониторинг Cassandra в Ключ-АСТРОМ =		= Мониторинг Cassandra в Ключ-АСТРОМ =

	Инструкция по настройке расширения '''Apache Cassandra JMX'''.		Инструкция по настройке расширения '''Apache Cassandra JMX'''.

Строка 24:		Строка 25:

	# Версия '''Cassandra''': 2.xx или выше.		# Версия '''Cassandra''': 2.xx или выше.
	# Версия Ключ-~~АСТРОМ~~: 1.~~308~~ или выше.		# Версия Ключ-Астроном: 1.318.0 или выше.
	# На хосте с '''Cassandra''' установлен ЕдиныйАгент Ключ-АСТРОМ, контроллер выполнения расширений ('''EEC''') включен.		# На хосте с '''Cassandra''' установлен ЕдиныйАгент Ключ-АСТРОМ, контроллер выполнения расширений ('''EEC''') включен.
	# Подготовлен пакет расширения (<code>.zip</code>) для загрузки в Расширения — либо расширение уже доступно в каталоге Расширений.		# Подготовлен пакет расширения (<code>.zip</code>) для загрузки в Расширения — либо расширение уже доступно в каталоге Расширений.
Строка 104:		Строка 105:
	\|Требуется удаленный сбор		\|Требуется удаленный сбор
	\|Группа АктивныхШлюзов с сетевым доступом к '''JMX'''-портам '''Cassandra'''. Убедитесь, что '''JMX'''-сервер настроен для удаленного доступа.		\|Группа АктивныхШлюзов с сетевым доступом к '''JMX'''-портам '''Cassandra'''. Убедитесь, что '''JMX'''-сервер настроен для удаленного доступа.
			\|}

			== История изменений ==

			{\| class="wikitable"
			!Версия
			!Изменения
			\|-
			\|1.2.0
			\|
			* Начало поддержки расширения.

	\|}		\|}

IKuznetsov: Новая страница: «= Мониторинг Cassandra в Ключ-АСТРОМ = Инструкция по настройке расширения '''Apache Cassandra JMX'''. Расширение подключается к серверу '''Cassandra''' через '''JMX''' ('''Java Management Extension''') и собирает метрики кластера, нодов, кэшей, пулов потоков и исключений. Обеспечивает полную наб...»

2026-08-25T22:37:07Z

Новая страница: «= Мониторинг Cassandra в Ключ-АСТРОМ = Инструкция по настройке расширения '''Apache Cassandra JMX'''. Расширение подключается к серверу '''Cassandra''' через '''JMX''' ('''Java Management Extension''') и собирает метрики кластера, нодов, кэшей, пулов потоков и исключений. Обеспечивает полную наб...»

Новая страница

= Мониторинг Cassandra в Ключ-АСТРОМ =
Инструкция по настройке расширения '''Apache Cassandra JMX'''.

Расширение подключается к серверу '''Cassandra''' через '''JMX''' ('''Java Management Extension''') и собирает метрики кластера, нодов, кэшей, пулов потоков и исключений. Обеспечивает полную наблюдаемость за производительностью и работоспособностью СУБД '''Cassandra'''.

== Возможности расширения ==

=== Что делает ===

* Подключается к серверу '''Cassandra''' через '''JMX'''.
* Собирает метрики кластера и отдельных нодов: исключения, неудачные запросы, задержки операций чтения/записи, загрузка хранилища, состояние пулов потоков и сборка мусора '''JVM'''.
* Создает сущности '''Cluster''' и '''Node''' со связями между ними.
* Предоставляет готовый дашборд «Cassandra JMX Overview» для визуализации ключевых метрик.
* Автоматически обнаруживает хосты с '''Cassandra''' при включении глобального мониторинга.

=== Что не делает ===

* Не устанавливает и не настраивает '''Cassandra'''.
* Не собирает метрики со стороны клиентских приложений (только серверная часть).
* Не выполняет трассировку запросов между приложениями (для этого требуется ЕдиныйАгент на клиентских приложениях).
* Не подключается через '''Management API''' или '''HTTP''' — только через '''JMX'''.

== Предварительные условия ==

# Версия '''Cassandra''': 2.xx или выше.
# Версия Ключ-АСТРОМ: 1.308 или выше.
# На хосте с '''Cassandra''' установлен ЕдиныйАгент Ключ-АСТРОМ, контроллер выполнения расширений ('''EEC''') включен.
# Подготовлен пакет расширения (<code>.zip</code>) для загрузки в Расширения — либо расширение уже доступно в каталоге Расширений.
# '''JMX'''-порт '''Cassandra''' (по умолчанию 7199) должен быть доступен для ЕдиногоАгента.
# Для сбора метрик с удаленных нодов требуется настроенный АктивныйШлюз с сетевым доступом к '''JMX'''-портам '''Cassandra'''.

== Рекомендация по подключению ==
При локальном мониторинге (ЕдиныйАгент на том же хосте, что и '''Cassandra''') расширение подключается к '''JMX''' через loopback-адрес. Для удаленного сбора убедитесь, что АктивныйШлюз имеет сетевой доступ к нодам '''Cassandra''' и порт '''JMX''' (7199) открыт.

Важно: Расширение использует '''JMX''' для сбора метрик. Убедитесь, что '''JMX'''-сервер '''Cassandra''' включен и настроен для удаленного доступа при необходимости.

== Шаг 1. Включение глобального мониторинга Cassandra ==
Для автоматического обнаружения хостов с '''Cassandra''':

# Откройте веб-интерфейс Ключ-АСТРОМ.
# Перейдите в '''Настройки''' → '''Мониторинг''' → '''Отслеживаемые технологии'''.
# В списке '''Поддерживаемые технологии''' найдите строку '''Cassandra JMX'''.
# Включите переключатель '''Cassandra JMX'''.

После включения ЕдиныйАгент будет автоматически обнаруживать процессы '''Cassandra''' на всех хостах.

== Шаг 2. Загрузка расширения в Расширения ==
Если расширение еще не установлено в окружении:

# Откройте '''Расширения''' → раздел '''Extensions'''.
# Нажмите '''Загрузить расширение''' и выберите загрузку пользовательского/custom-расширения.
# Укажите файл <code>.zip</code>-пакета расширения '''Apache Cassandra JMX'''.
# Дождитесь успешной проверки подписи и загрузки.
# Активируйте нужную версию расширения для окружения.

Если расширение уже присутствует в Расширениях окружения, откройте его карточку и убедитесь, что требуемая версия активна.

После активации перейдите на вкладку '''Конфигурация''' — можно добавлять конфигурацию мониторинга.

== Шаг 3. Выбор источника мониторинга ==
Для типичного сценария «ЕдиныйАгент на хосте с Cassandra» выберите нужный хост. Убедитесь, что у хоста '''EEC''' отображается как «Включено».

== Контрольный список ==
{| class="wikitable"
!№
!Пункт
|-
|1
|На сервере '''Cassandra''' включен и доступен '''JMX'''-сервер (порт 7199).
|-
|2
|Включен глобальный мониторинг '''Cassandra JMX''' в '''Настройки''' → '''Отслеживаемые технологии'''.
|-
|3
|Пакет расширения загружен в Расширения и активирован.
|-
|4
|Конфигурация мониторинга добавлена и включена, состояние '''Ok'''.
|-
|5
|Выбран корректный режим (локально / удаленно).
|-
|6
|Указаны корректные параметры подключения (порт '''JMX''', при необходимости — учетные данные).
|-
|7
|На дашборде и в сущностях отображаются метрики '''Cassandra'''.
|}

== Возможные проблемы ==
{| class="wikitable"
!Симптом
!Что проверить
|-
|Состояние конфигурации не '''Ok'''
|Сетевая доступность '''JMX'''-порта '''Cassandra''' (7199) с хоста ЕдиногоАгента/АктивногоШлюза, статус '''EEC'''. Убедитесь, что '''JMX'''-сервер запущен.
|-
|Ошибка авторизации
|Проверьте логин и пароль для '''JMX'''-аутентификации. Убедитесь, что пользователь имеет права.
|-
|Нулевые значения метрик
|Ожидаемо при отсутствии нагрузки или если расширение еще не завершило первый цикл сбора.
|-
|Требуется удаленный сбор
|Группа АктивныхШлюзов с сетевым доступом к '''JMX'''-портам '''Cassandra'''. Убедитесь, что '''JMX'''-сервер настроен для удаленного доступа.
|}

Cassandra - История изменений

Aleksandr.Zubarev в 19:05, 15 сентября 2026