Операции по диагностике компонентов Open Single Management Platform

В этом разделе описано, как получить диагностическую информацию о компонентах Open Single Management Platform.

Получение файлов журнала событий компонентов Open Single Management Platform

KDT позволяет получать файлы журнала событий, которые содержат диагностическую информацию о компонентах Open Single Management Platform и кластере Kubernetes, что позволяет устранять проблемы самостоятельно или с помощью Службы технической поддержки "Лаборатории Касперского".

Open Single Management Platform генерирует имена файлов журнала событий по следующему шаблону: pod_name.container_name.log. Здесь pod_name – это имя пода Kubernetes, container_name – это имя контейнера Kubernetes.

Чтобы получить файлы журнала событий компонентов Open Single Management Platform и веб-плагинов управления,

на устройстве администратора, на котором расположена утилита KDT, выполните команду:

./kdt logs get <flags>

Где <flags> – параметры команды, которая позволяет настроить результат сохранения событий.

Вы можете указать следующие параметры ведения журнала событий:

• --app <список_компонентов> – получить журналы событий для перечисленных компонентов Open Single Management Platform.
• --auto-dest-dir – получить журналы событий и сохранить их в директории kdt-default-logs-<current_date_and_time>, которая автоматически создается в текущей директории. Если период хранения событий не указан, вы будете получать диагностическую информацию за последний час.

  Например, если вы хотите получить журналы событий за последний час для Сервера администрирования и KUMA и сохранить эти журналы событий в автоматически созданной директории, выполните команду:

  ./kdt logs get --app ksc,kuma --auto-dest-dir

• -d, --destination <путь_к_файлу> – получить журналы событий и сохранить их в указанном файле.
• -D, --destination-dir <путь_к_директории> – получить журналы событий и сохранить их в указанной директории, которая должна быть создана заранее. Если параметр <directory_path> пуст, журналы событий сохраняются в стандартном потоке вывода (stdout). Если период хранения событий не указан, вы будете получать диагностическую информацию за последний час.
• --to-archive – получить журналы событий и сохранить их в kdt-default-logs-<current_date_and_time>.tar.gz. Созданный архив сохраняется в текущей директории. Если период хранения событий не указан, вы будете получать диагностическую информацию за последний час.
• --last=<часы>h – получить журналы событий за указанное количество часов в актуальном состоянии.

  Например, если вы хотите получить архив с журналами за последние три часа, выполните команду:

  ./kdt logs get --to-archive --last=3h

• --start=<дата_и_время> – получить журналы событий, начиная с указанной даты и времени (в формате Unix timestamp) до настоящего времени или до даты и времени, указанных в параметре --end.

  Например, если вы хотите получить журналы с 26.03.2024 10:00:00 по настоящее время и сохранить их в директории kdt-default-logs-<current_date_and_time>, созданной в текущей директории, выполните команду:

  ./kdt logs get --auto-dest-dir --start=1711447200

• --end=<дата_и_время> – получить журналы событий, начиная с даты и времени, указанных в параметре --start, до даты и времени, указанных в параметре --end (в формате Unix timestamp). Если параметр --start не указан, журналы событий будут получены за последний час до даты и времени, заданных параметром --end.

  Например, если вы хотите сохранить журналы событий за 10 минут (с 26.03.2024 10:00:00 до 26.03.2024 10:10:00) в директории журналов событий, выполните команду:

  ./kdt logs get -D ./logs/ start=1711447200 --end=1711447800

Для того чтобы просмотреть доступные параметры ведения журнала, вы можете выполнить одну из следующих команд:

• ./kdt logs get -h
• ./kdt logs get --help

Просмотр метрик OSMP

OSMP позволяет контролировать метрики для дальнейшего анализа работоспособности и производительности его компонентов.

Вы можете просмотреть метрики OSMP одним из следующих способов:

• Используя веб-адрес <monitoring_host>.<smp_domain>.

  В этом случае вам необходимо просматривать метрики с помощью Grafana, инструмента для визуализации данных, который устанавливается вместе с Open Single Management Platform. Чтобы получить доступ к метрикам с помощью Grafana, вам нужно указать учетные данные Grafana в конфигурационном файле (параметры grafana_admin_user и grafana_admin_password).

• Используя свои инструменты.

  В этом случае вам необходимо настроить инструменты для получения метрик с адреса API – <api_host>.<smp_domain>/metrics.

Параметры <api_host> и <monitoring_host> являются именами устройств, <smp_domain> является доменным именем. Эти параметры представляют собой FQDN служб Open Single Management Platform и устанавливаются в конфигурационном файле при развертывании Open Single Management Platform.

Open Single Management Platform предоставляет свои метрики в формате OpenMetrics.

Если вы хотите просмотреть информацию о производительности Ядра KUMA, хранилища, коллекторов и корреляторов, вам необходимо просмотреть метрики KUMA.

Мониторинг состояний компонентов Open Single Management Platform

Панель мониторинга предоставляет собой графическое отображение состояния каждого компонента Open Single Management Platform.

Например, вы можете просмотреть следующие параметры компонента:

• использование запросов и ограничений процессора;
• использование запросов процессора и оперативной памяти;
• использование процессора и оперативной памяти контейнерами;
• распределение ресурсов компонентов контейнерами;
• индикаторы производительности сети: пропускная способность, потеря пакетов, сетевые ошибки, количество полученных и отправленных пакетов.

Чтобы просмотреть диагностическую информацию в панели мониторинга:

1. Перейдите по веб-адресу <monitoring_host>.<smp_domain>.

   Где <monitoring_host> – имя устройства, <smp_domain> – имя домена. Эти параметры представляют собой FQDN службы мониторинга Open Single Management Platform и определяются в конфигурационном файле при развертывании Open Single Management Platform.

2. Введите учетные данные Grafana, которые вы указали в конфигурационном файле (параметры grafana_admin_user и grafana_admin_password).
3. В меню перейдите в раздел Kubernetes → Просмотры → Поды.
4. В раскрывающемся списке namespace выберите компонент, для которого вы хотите просмотреть диагностическую информацию.
5. Вы также можете указать другие параметры для настройки вида панели мониторинга.

Отображается панель мониторинга с диагностической информацией о выбранном компоненте Open Single Management Platform.

Хранение диагностической информации о компонентах Open Single Management Platform

Диагностическая информация о компонентах Open Single Management Platform хранится на рабочем узле кластера Kubernetes. Объем дискового пространства, необходимый для хранения этой информации, указывается в конфигурационном файле перед развертыванием Open Single Management Platform (параметр loki_size).

Чтобы проверить объем дискового пространства, на котором хранится диагностическая информация о компонентах Open Single Management Platform,

на устройстве администратора, на котором расположена утилита KDT, выполните команду:

./kdt invoke observability --action getPvSize

Отображается объем выделенного свободного места на диске в гигабайтах.

Вы также можете увеличить дисковое пространство, используемое для хранения диагностической информации о компонентах Open Single Management Platform после установки Open Single Management Platform. Вы не можете установить объем дискового пространства меньше указанного ранее.

Чтобы увеличить дисковое пространство, используемое для хранения диагностической информации о компонентах Open Single Management Platform,

на устройстве администратора, на котором расположена утилита KDT, выполните следующую команду, указав необходимое свободное место на диске в гигабайтах (например, "50Gi"):

./kdt invoke observability --action setPvSize --param loki_size="<новый_объем_дискового_пространства>Gi"

Объем свободного дискового пространства, выделяемого для хранения диагностической информации о компонентах Open Single Management Platform, изменен.

Получение файлов трассировки

KDT позволяет получать файлы трассировки для компонентов OSMP, чтобы устранять проблемы инфраструктуры самостоятельно или с помощью Службы технической поддержки "Лаборатории Касперского".

Файлы трассировки загружаются в формате OpenTelemetry.

Чтобы получить файл трассировки для OSMP:

1. На устройстве администратора, на котором расположена утилита KDT, выполните следующую команду и укажите путь к файлу, в который вы хотите сохранить список файлов трассировки:

   ./kdt traces find -o <output_file_path>

   Список файлов трассировки с их идентификаторами выводится в указанный файл.

2. Чтобы вывести конкретный файл трассировки, выполните следующую команду и укажите путь к выходному файлу и идентификатор файла трассировки:

   ./kdt traces get -o <output_file_path> --traсe-id=<trace_ID>

Указанный файл трассировки сохранен.

Запись событий запусков пользовательских действий

KDT позволяет получить историю запуска пользовательского действия для конкретного компонента Open Single Management Platform, а также журналы событий запуска определенного пользовательского действия. Полученные журналы событий могут помочь вам исследовать проблемы с работой компонентов Open Single Management Platform самостоятельно или с помощью Службы технической поддержки "Лаборатории Касперского".

Чтобы получить историю запусков пользовательских действий для конкретного компонента Open Single Management Platform:

На устройстве администратора, на котором расположена утилита KDT, выполните следующую команду и укажите имя компонента:

./kdt state -H <component_name>

Отображается список выполненных пользовательских действий с их идентификаторами.

Чтобы получить журналы событий запуска настраиваемого действия,

На устройстве администратора, на котором расположена утилита KDT, выполните следующую команду и укажите имя компонента и идентификатор запуска пользовательского действия:

./kdt state -l <component_name> -m <custom_action_launch_ID>

Отобразятся журналы событий запуска указанного пользовательского действия.