mxpacklogs

В этом документе описывается инструмент сбора и упаковки логов mxpacklogs.

1 Обзор

  • Функции

    • Инструмент mxpacklogs поддерживает однократный сбор и упаковку логов со всех узлов распределённого кластера.
    • Собирает данные логов за период от текущего момента до трёх предыдущих дней.
  • Использование

    • На хосте Master
      • Рекомендуется запускать от пользователя mxadmin. Если используется другой пользователь, необходимо настроить доверие в pg_hba соответствующим образом.
    • На хостах, отличных от Master
      • На сервере базы данных и на хосте выполнения должна быть установлена последняя версия YMatrix (4.8.0 или выше). Подключение к Master осуществляется с указанием необходимых параметров.
  • Примечания

    • Логи со всех указанных хостов агрегируются на том хосте, где выполняется mxpacklogs, и временно сохраняются в каталоге *.tar.gz в виде пакета /tmp.
    • mxpacklogs автоматически выбирает диск с наибольшим объёмом доступного пространства, к которому у пользователя есть права на чтение и запись, для хранения пакета *.tar.gz.
    • В крайних случаях, когда все узлы кластера недоступны, используйте опции --hosts и --base-data-dirs для получения информации из логов.

2 Использование инструмента

В следующих примерах mdw обозначает хост Master, а sdw — хост, не являющийся Master.

  1. Сбор логов со всех хостов

    • По умолчанию: текущий хост — Master
     [mxadmin@mdw ~]$ mxpacklogs
    • Указание параметров подключения к Master
     [<username>@sdw ~]$ mxpacklogs --dbhost 172.31.33.128 --dbport 5432 --username mxadmin --password 123
  2. Сбор логов с конкретных хостов

    • Эта команда собирает логи с sdw1 и sdw2. На обоих машинах значение base-data-dirs установлено в /mxdata_20221229075012.
     [<username>@sdw ~]$ mxpacklogs --hosts sdw1,sdw2 --base-data-dirs /mxdata_20221229075012
    • Эта команда собирает логи с sdw1 и sdw2. Значение base-data-dirs на sdw1 равно /mxdata_20221229075012, а значение base-data-dirs на sdw2 равно /data1/mxdata_20221229075013.
     [<username>@sdw ~]$ mxpacklogs --hosts sdw1,sdw2 --base-data-dirs /mxdata_20221229075012,/data1/mxdata_20221229075013

3 Подробная информация о параметрах

Параметр Значение по умолчанию Описание
--base-data-dirs Каталог данных из системного каталога БД Необязательный. Требуется только при недоступности базы данных. Укажите путь до уровня mxdata_xxxx. Формат: mxpacklogs --base-data-dirs /data/mxdata_20230324145536
--hosts Логи со всех хостов в кластере Используйте -- hosts, чтобы собрать логи только с указанных хостов Segment, что снижает нагрузку на диск и время выполнения. Формат: mxpacklogs --hosts sdw1,sdw2 или mxpacklogs --hosts sdw1 --hosts sdw2
-h / --dbhost 127.0.0.1 Хост сервера базы данных
-p / --dbport 5432 Порт сервера базы данных
--debug Недоступно Включить вывод логов уровня debug
--help Недоступно Вывести справочное сообщение
--host 127.0.0.1 Хост, на котором работает служба supervisor/mxgate
--mode api Формат вывода: api или cli
-W / --password NULL Пароль пользователя базы данных
--port 4617 Порт сервера supervisor
-U / --username mxadmin Имя пользователя базы данных
--validate Недоступно Режим проверки — тестовый запуск без выполнения
--verbose Недоступно Включить подробный вывод логов
-v / --version Недоступно Отобразить версию инструмента
--path /opt/ymatrix/matrixdb[x] Путь установки MatrixDB на хосте supervisor; [x] — номер версии базы данных, например, matrixdb5, matrixdb6

Примечание!
Дополнительную информацию о логах см. в разделе Логи.