Cassandra

Мониторинг Cassandra в Ключ-АСТРОМ

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

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

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

Что делает

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

Что не делает

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

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

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

Рекомендация по подключению

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

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

Шаг 1. Включение глобального мониторинга Cassandra

Для автоматического обнаружения хостов с Cassandra:

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

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

Шаг 2. Загрузка расширения в Расширения

Если расширение еще не установлено в окружении:

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

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

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

Шаг 3. Выбор источника мониторинга

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

Контрольный список

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

Возможные проблемы

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

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

Версия	Изменения
1.2.0	Начало поддержки расширения.