log

Просмотр журнала операций системы — это базовый метод диагностики сбоев кластера.

1. Журнал MatrixDB

MatrixDB имеет два типа журналов:

  • Журнал управления кластером
  • Журнал операций запросов

1.1 Журнал управления кластером

Стандартная директория журналов управления кластером — $HOME/gpAdminLogs. В этой директории для разных инструментов создаются разные файлы журналов, например: gpstart_20210701.log, gpstop_20210701.log и т.д.

Правила именования файлов журналов: {имя_административногоинструмента}{дата}.log, как показано ниже:

gpconfig_20210723.log
gpstart_20210701.log
gpstart_20210708.log
gpstop_20210701.log
gpstop_20210723.log
......

Формат журнала: дата + время + имя инструмента + имя хоста + имя пользователя + уровень журнала + содержимое журнала. Например:

20210708:17:29:32:001644 gpstart:mdw:mxadmin-[INFO]:-Greenplum Catalog Version: '302012031'
20210708:17:29:32:001644 gpstart:mdw:mxadmin-[WARNING]:-postmaster.pid file exists on Master, checking if recovery startup required
......

Уровни журнала делятся на INFO, WARNING, FATAL и др.

  • INFO — нормальный вывод
  • WARNING — во время выполнения возникло исключение, но выполнение может продолжиться
  • FATAL — возникла критическая ошибка, процесс не может быть завершен и должен быть остановлен

Поэтому при сбое выполнения инструмента диагностику можно провести, просмотрев записи WARNING и FATAL в соответствующем журнале.

1.2 Журнал операций запросов

Журнал операций запросов находится в директории log внутри директории данных мастер-узла и сегментных узлов. Имя файла имеет формат gpdb-{дата}_{время}.csv, например:

gpdb-2021-07-01_164653.csv
gpdb-2021-07-01_164655.csv
gpdb-2021-07-02_000000.csv
......

Этот журнал является журналом PostgreSQL и используется для локализации следующих проблем:

  • Ошибки выполнения запроса
  • Сбои узлов

Содержимое файла включает дату, время, имя пользователя, номер процесса, идентификатор соединения, уровень журнала и конкретную информацию об ошибке.

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

2021-07-26 10:21:34.692106 CST,"mxadmin","postgggg",p10188,th-1455884160,"[local]",,2021-07-26 10:21:34 CST,0,con14,,seg-1,,,,sx1,"FATAL","3D000","database ""postgggg"" does not exist",,,,,,,0,,"postinit.c",1024,

Значения полей журнала следующие:

Содержимое журнала Значение
2021-07-26 10:21:34.692106 CST Время записи журнала
mxadmin Имя пользователя, подключившегося
postgggg Имя подключаемой базы данных
p10188 Номер процесса подключения
th-1455884160 Номер потока
[local] Метод подключения — локальное соединение
con14 Номер соединения
seg-1 Номер узла
FATAL Уровень журнала
database "postgggg" does not exist Сообщение об ошибке

2. Журнал MatrixGate

Журнал MatrixGate также находится в директории gpAdminLogs, имя файла — matrixgate.{дата}_{время}.log, как показано ниже:

matrixgate.2021-07-26_134717.log

Формат журнала аналогичен другим административным инструментам:

20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-Connected to MatrixDB, version PostgreSQL 12 (MatrixDB 4.1.0-community) (Greenplum Database 7.0.0+dev.16905.gc6dbf4f14d build commit:c6dbf4f14d4452a414198fd45d507819803fffb2) on x86_64-pc-linux-gnu, compiled by gcc (GCC) 7.3.1 20180303 (Red Hat 7.3.1-5), 64-bit compiled on Jul 14 2021 08:56:13
20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Writer.Stream] Initialized with 100ms load interval and 10 prepared insert
20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Writer.Stream] Started, listening on :12120
20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Trans.Plain] Started, parallel level 8
20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Source.HTTP] http listening on :8086

Журнал MatrixGate также можно просматривать с помощью команды mxgate log: `` [mxadmin@mdw gpAdminLogs]$ mxgate log



| \/ | | | _ () / _| | | __ | |\/| |/ ` | | '| \ \/ / | / ` | / \ | | | | (| | || | | |> <| || | (_| | || / || ||_,|_|| |//_\|\,_|\_| Version: 4.0.3 Your Copy is Licensed to: yMatrix.cn; 2022-01-14; any


==> [pid:10889] matrixgate.2021-07-26_134717.log <== 20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-Connected to MatrixDB, version PostgreSQL 12 (MatrixDB 4.1.0-community) (Greenplum Database 7.0.0+dev.16905.gc6dbf4f14d build commit:c6dbf4f14d4452a414198fd45d507819803fffb2) on x86_64-pc-linux-gnu, compiled by gcc (GCC) 7.3.1 20180303 (Red Hat 7.3.1-5), 64-bit compiled on Jul 14 2021 08:56:13 20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Writer.Stream] Initialized with 100ms load interval and 10 prepared insert 20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Writer.Stream] Started, listening on :12120 20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Trans.Plain] Started, parallel level 8 20210726:13:47:17 matrixgate:mxadmin:mdw:010889-[INFO]:-[Source.HTTP] http listening on :8086 ` Предварительное условие для просмотра журналов с помощью командыmxgate log` — процесс mxgate должен быть запущен, и отображаемое содержимое журнала генерируется именно запущенным процессом.