Информация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Официальная документация по данному разделу приведена в Онлайн-справке на продукт: [https://support.kaspersky.com/help/KUMA/4.0/ru-RU/222208.htm3](https://support.kaspersky.com/help/KUMA/2.1/ru-RU/222208.htm)
KUMA позволяет выполнять резервное копирование базы данных Ядра KUMA и сертификатов.Функция резервного копирования предназначена для восстановления KUMA – для переноса или копирования ресурсов следует использовать функции экспорта и импорта ресурсов.
Доступны следующие возможности создания резервной копии и восстановления из резервной копии: - С помощью REST API. - Через веб-интерфейсВосстановление данных из резервной копии возможно только на той же версии KUMA.
#### Через веб-интерфейс \[KUMA 4.2+\] [](https://kb.kuma-community.ru/uploads/images/gallery/2026-06/jcRimage.png) #### С помощью REST API \[KUMA 3.4+\] В связи с появлением возможности организации отказоустойчивого ядра в кластере kubernetes добавился новый механиз создания резервных копий ядра.для KUMA от 4.0 и выше используйте API **v3**
Для создания **резервной копии ресурсов и сертификатов** необходимо отправить следующий API-запрос: **GET /api/v1/system/backup** В ответ на запрос возвращается архив tar.gz, содержащий резервную копию Ядра KUMA. На хосте, где установлено Ядро, резервная копия не сохраняется. Сертификаты включаются в состав резервной копии. Если операция выполнена успешно, создается событие аудита со следующими параметрами: DeviceAction = "Core backup created" SourceUserID = "<user-login>"*Пример команды для бэкапа через curl:* Чтобы создать резервную копию Ядра необходимо создать пользователя и предоставить ему права доступа к методам API **GET /system/backup** и **POST /system/restore** (для восстановления)**:** 1. Перейдите в раздел **Параметры** → **Пользователи** и нажмите **Добавить пользователя**. 2. В появившемся окне **Пользователь** задайте параметры нового пользователя: - **Имя** – введите имя пользователя - **Логин** – введите уникальный логин учетной записи пользователя. Длина должна быть от 3 до 64 символов (допускается использование только символов a–z, A–Z, 0–9, . \\ - \_). - **Адрес электронной почты** – введите уникальный адрес электронной почты пользователя. Адрес электронной почты должен быть корректным.Если отправка уведомлений на почту не предполагается, то можно указать любую почту, например
Необходим работающий сервис MongoDB для версии 3.4
С KUMA 4.0 путь к клиенту CH - /opt/kaspersky/kuma/storage/<ID Storage>/deps/clickhouse/bin/client.sh
#### Сохранение данных Сохранение данных за определенную дату в файл CSV: ```bash /opt/kaspersky/kuma/clickhouse/bin/client.sh -d kuma --multiline --query "SELECT * FROM events_local_v2 WHERE toDate(fromUnixTimestamp64Milli(Timestamp)) = toDate('2024-07-16') FORMAT CSVWithNames;" > click_events.csv ``` Сохранение данных за определенную дату в файл CSV с максимальным сжатием (cырой файл CSV 1.4 Гб (строк 5630119) - сжатый 72 Мб): ```bash /opt/kaspersky/kuma/clickhouse/bin/client.sh -d kuma --multiline --query "SELECT * FROM events_local_v2 WHERE toDate(fromUnixTimestamp64Milli(Timestamp)) = toDate('2024-07-16') FORMAT CSVWithNames;" | gzip -9 -c > click_events.csv.gz ``` Gzip подходит для небольших объемов информации, т.к. он однопоточный. Для **ускорения** рекомендуется использовать `pigz` либо zstd, они используют все доступные ядра процессора, обеспечивая значительное ускорение экспорта больших CSV-файлов по сравнению с gzip. Если он не установлен, то: ```bash sudo apt install pigz # Debian/Ubuntu sudo yum install pigz # RHEL/CentOS ``` Далее команда сохранения выглядит с pigz следующим образом: ```bash /opt/kaspersky/kuma/storage/c1114ebb-45e8-461c-a576-3a222dbfe3b2/deps/clickhouse/bin/client.sh \ -d kuma \ --multiline \ --query "SELECT * FROM events_local_v2 \ WHERE toDate(fromUnixTimestamp64Milli(Timestamp)) = toDate('2025-08-13') \ FORMAT CSVWithNames;" \ | pigz > click_events.csv.gz ``` команда сохранения выглядит с zstd следующим образом: ```bash /opt/kaspersky/kuma/storage/c1114ebb-45e8-461c-a576-3a222dbfe3b2/deps/clickhouse/bin/client.sh \ -d kuma \ --multiline \ --query "SELECT * FROM events_local_v2 \ WHERE toDate(fromUnixTimestamp64Milli(Timestamp)) = toDate('2025-08-13') \ FORMAT CSVWithNames;" \ | zstd -T0 -15 -v -o click_events.csv.zst ``` Сохранение данных за определенную дату по определенному промежутку в часах (время в UTC) в файл CSV с максимальным сжатием (с 10:00:00 до 11:00:00): ```bash /opt/kaspersky/kuma/clickhouse/bin/client.sh -d kuma --multiline --query "SELECT * FROM events_local_v2 WHERE toDateTime(fromUnixTimestamp64Milli(Timestamp)) > toDateTime('2024-07-16 10:00:00') AND toDateTime(fromUnixTimestamp64Milli(Timestamp)) < toDateTime('2024-07-16 11:00:00') FORMAT CSVWithNames;" | gzip -9 -c > click_events.csv.gz ``` #### Загрузка данных в хранилище Распаковать данные с сохранением архива: `gzip -dk click_events.csv.gz` Распаковать данные без сохранения архива: `gzip -d click_events.csv.gz` Если необходима замена TenantID для видимости событий в определенном тенанте, нужно в распакованном файле CSV заменить третье значение после запятой (столбцы CSV `"ID","Timestamp","TenantID","ServiceID","ServiceName"...`), пример команды (старый TenantID 746c6045-b929-4edd-8e1e-84ebe4a11880, новый TenantID 911c6045-b929-4edd-8e1e-84ebe4a11911): ```bash sed -i 's/746c6045-b929-4edd-8e1e-84ebe4a11880/911c6045-b929-4edd-8e1e-84ebe4a11911/g' click_events.csv ``` Загрузка событий из файла CSV в хранилище ClickHouse: ```bash /opt/kaspersky/kuma/clickhouse/bin/client.sh -d kuma --multiline --query "INSERT INTO events_local_v2 FORMAT CSV" < /root/click_events.csv ```В CSV файле не должно быть пустых строк, иначе будет ошибка: `Code: 27. DB::ParsingException: Cannot parse input: expected ',' before: '\n\n':`
--- ### С утилитой clickhouse-backup Для создания резервной копией можно воспользоваться утилитой clickhouse-backup. Исполняемый файл (clickhouse-backup-linux-amd64.tar.gz) для ОС Linux можно загрузить [**отсюда**](https://github.com/Altinity/clickhouse-backup/releases/latest). Подробнее про утилиту [https://github.com/Altinity/clickhouse-backup](https://github.com/Altinity/clickhouse-backup) #### Подготовка Разархивируем загруженный файл: ```bash tar -xvf clickhouse-backup-linux-amd64.tar.gz ``` Добавляем возможность исполнения файла: ```bash chmod +x clickhouse-backup ``` Добавляем следующую строку `Для логирования действий утилиты используйте значение `log_level: info` в конфигурации `click_backup_config.yml`
В нашем случае восстанавливается Хранилище в инсталляции All-In-One. Для создания копии данных (ВСЕХ событий) используйте команду: ```bash ./clickhouse-backup create -t kuma.events_local_v2 -c click_backup_config.yml ``` Резервная копия создастся по пути `/opt/kaspersky/kuma/clickhouse/data/backup/` Для просмотра созданных резервных копий выполните: ```bash ./clickhouse-backup list -c click_backup_config.yml ``` Для восстановления из бекапа: ```bash ./clickhouse-backup restore 2024-04-08T11-07-24 -t kuma.events_local_v2 -c click_backup_config.yml ``` После восстановления при поиске может возникать следующая ошибка: [](https://kb.kuma-community.ru/uploads/images/gallery/2023-10/PwQimage.png) Для исправления ошибки перезапустите хранилище из активных сервисов. Для удаления бекапа: ```bash ./clickhouse-backup delete local 2024-04-08T11-07-24 -c click_backup_config.yml ``` Удалить служебные данные утилиты: ```bash ./clickhouse-backup clean -c click_backup_config.yml ``` # Архивировние и восстановление БД через ClickHouse BACKUP/RESTOREИнформация, приведенная на данной странице, является разработкой команды pre-sales и/или community KUMA и **НЕ** является официальной рекомендацией вендора.
Данная инструкция проверена и актуальна только для версии KUMA 3.0.3.19
--- ### Описание Данный метод позволяет выполнять локальное архивирование и восстановление партиций ClickHouse через встроенные механизмы BACKUP и RESTORE. В статье описан пример ручного резервного копирования и восстановления на сервере в конфигурации All-in-One. При помощи скриптов данный подход может быть автоматизирован и распространен на распределенную конфигурацию.Всегда помните, если вы производите резервное копирование и/или архивирование и не проверяете корректность бэкапов, а также не пробуете их восстанавливать, существует вероятность, что вы не сможете восстановиться из резервной копии, когда это будет действительно необходимо.
--- ### Настройка хранилища 1\. Создать на сервере хранилища директорию для сохранения резервных копий, например, `/tmp/test_backup` 2\. Сделать владельцем директории пользователя kuma с помощью команды: ```bash chown kuma:kuma /tmp/test_backup/ ``` 3\. Убедиться, что у пользователя kuma также есть права x и r на всех родительских директориях 4\. Перейти в Web-интерфейс KUMA на вкладку "активные сервисы". 5\. Открыть на редактирование требуемый сервис хранилища. 6\. В поле "Переопределение параметров ClickHouse" задать разрешенный путь для сохранения резервных копий [](https://kb.kuma-community.ru/uploads/images/gallery/2024-04/tOLimage.png) ```xml**Важно!** В ClickHouse использующемся в KUMA до версии **3.4** включительно присутствует баг, при котором параметр **compression\_method** игнорируется, если у итогового файла выбрано расширение отличное от **.zip**
В случае, если все прошло успешно будет получено сообщение о создании бэкапа:  Также посмотреть состояние бэкапа можно через запрос к таблице system.backups ```sql SELECT * FROM system.backups ORDER BY start_time \G ```  Либо сразу с фильтрацией по соответствующему id, который был получен в результате выполнения резервного копирования ```sql SELECT * FROM system.backups WHERE id = 'd52ba745-7ad0-4099-827a-db688aa62649' \G ``` После выполнения резервного копирования партицию можно удалить из интерфейса KUMA, либо с помощью клиента ClickHouse, либо же дождаться истечения срока хранения.с версии 4.0 путь к клиенту: /opt/kaspersky/kuma/ID-storage/deps/clickhouse/bin/client.sh
2\. Выполнить запрос для восстановления ```sql RESTORE TABLE kuma.events_local_v2 PARTITION ID '0405a4ae764614f2283652209b390809' FROM File('/tmp/test_backup/20250221_0405a4ae764614f2283652209b390809.zip') SETTINGS allow_non_empty_tables=true ``` 3\. В результате будет восстановлена выбранная партиция из бэкапа и получено соответствующее сообщение: [](https://kb.kuma-community.ru/uploads/images/gallery/2024-04/hSPimage.png)При восстановлении партиция ВСЕГДА восстанавливается на диск горячего хранения. Перенос данных на холодное хранение выполняется раз в 1 час. Для форсирования операции необходимо перезапустить сервис Ядра KUMA
--- ### Полезные ссылки ClickHouse Backup and Restore: [https://clickhouse.com/docs/en/operations/backup](https://clickhouse.com/docs/en/operations/backup)