Сбор диагностической информации

[Mike Rytov]

Сбор диагностической информации с помощью скрипта collect.py

Вы можете получить диагностическую информацию об установленном продукте Kaspersky SD-WAN вашей конфигурации с помощью python скрипта collect.py. Этот скрипт запускается на ВМ Tool server, которая использовалась для установки продукта c помощью мастера установки (в случае, если продукт устанавливался без использования мастера установки, то необходимо воспользоваться пунктом "Сбор диагностической информации вручную"). Если продукт устанавливался локально в формате all in one, то скрипт необходимо запустить на этой ВМ. После успешного выполнения скрипта создается файл с диагностической информацией, системной информацией о ВМ, на которых развёрнут Kaspersky SD-WAN, и журналами событий компонентов решения.

Чтобы собрать диагностическую информацию об инсталляции Kaspersky SD-WAN с помощью скрипта collect.py необходимо:

1. Перейти в директорию, в которой располагается файл переменных с расширением .yml, который вы использовали для установки решения;
2. Загрузить скрипт collect.py на Tool server:

   # wget https://box.kaspersky.com/f/2b175048b26d49fe94f9/?dl=1 -O collect.py

3. Запустите сценарий collect.py под учетной записью с правами администратора:

   # python3 collect.py <your_variables_file_name>.yml

После успешного выполнения скрипт выведет сообщение в консоль:

Logs collected. Archive with logs: collect_for_<your_variables_file_name>_<time_and_date>

Файл с диагностической информацией будет сформирован и сохранен в директории, в которой вы запускали collect.py. Его необходимо передать в техническую поддержку вместе с информацией по инциденту:

1. Детальное описание проблемы со скриншотами ошибок и/или записью экрана;
2. Примерное время инцидента или предполагаемый временной промежуток;
3. Файл с диагностической информацией, сгенрированной скриптом collect.py.

Если проблема произошла в процессе установки или обновления, то к обращению необходимо приложить файл ansible.log.

Дополнительно, если проблема связана с CPE, необходимо:

1. Выгрузить диагностическую информацию по проблемной CPE;
2. Выгрузить шаблон CPE, который был применён к проблемной CPE при регистрации;
3. Файлы дампов трафика с интерфейсов CPE (при необходимости).

При возникновении ошибок или проблем в работе скрипта collect.py необходимо обратиться в техническую поддержку и если собрать диагностическую информацию с помощью скрипта collect.py не удалось, то необходимо собрать информацию вручную, используя информацию ниже.

Сбор диагностической информации вручную

В случае, если для установки Kaspersky SD-WAN вы не использовали мастер установки или во время работы скрипта collect.py у вас произошёл сбой, не позволивший собрать логи, для проведения диагностики сотрудниками технической поддержки вам необходимо предоставить следующую информацию:

Минимально необходимая для диагностики информация

1. Детальное описание проблемы со скриншотами ошибок и/или записью экрана;
2. Примерное время инцидента или предполагаемый временной промежуток;
3. Версии запущенных контейнеров со всех ВМ, на которых установлено решение;

   # docker ps -a > docker_ps.log

    

4. Логи контейнеров оркестратора и контроллера с primary нод:

   docker logs orc-X > orc-X.log
   docker logs ctl-X > ctl-X.log
    
   *Замените X в командах выше цифрой из названия контейнера на той ВМ, где вы собираете логи. Посмотреть список контейнеров на ВМ можно командой docker ps -a.

В случае проблем с CPE:

1. Выгрузить диагностическую информацию по проблемной CPE;
2. Выгрузить шаблон CPE, который был применён к проблемной CPE при регистрации;
3. Файлы дампов трафика с интерфейсов CPE (при необходимости).

Дополнительная информация. Необходимо собрать по запросу от технической поддержки

1. Логи остальных контейнеров со всех ВМ:

   docker logs mongo-X > mongo-X.log
   docker logs www-X > www-X.log
   docker logs vnfm-X > vnfm-X.log
   docker logs vnfm-proxy-X > vnfm-proxy-X.log
   docker logs redis-Xs > redis-Xs.log
   docker logs redis-Xm > redis-Xm.log
    
   *Замените X в командах выше цифрой из названия контейнера на той ВМ, где вы собираете логи. Посмотреть список контейнеров на ВМ можно командой docker ps -a.

Edited August 14 by Mike Rytov
Правка текста