xtstat
xtstat можно использовать для мониторинга всей внутренней активности PBXT.
xtstat опрашивает таблицу INFORMATION_SCHEMA.PBXT_STATISTICS. Интервал опроса можно установить с помощью параметра --delay, по умолчанию он равен 1 секунде.
Для большинства статистических данных xtstat отобразит разницу в значениях между текущим и предыдущим опросами. Например, если текущее значение записанных байтов равно 1000, а на предыдущем вызове оно было 800, то xtstat отобразит 200. Это означает, что за промежуток времени было записано 200 байтов на диск.
Использование xtstat
Вызовите xtstat следующим образом:
$ xtstat [ options ]
Например, чтобы опрашивать каждые 10 секунд:
xtstat -D10
Обратите внимание, что счетчики статистики никогда не сбрасываются, даже если происходит откат. Например, если оператор UPDATE
отменяется, xtstat по-прежнему будет указывать, что была выполнена одна операция записи (см. stat-write ниже).
Если MariaDB завершается или аварийно завершает работу, xtstat будет пытаться повторно подключиться. xtstat можно завершить в любое время с помощью комбинации клавиш CTRL-C.
Перед тем как PBXT восстановится, не все статистические данные доступны. В частности, статистика, относящаяся к фоновым потокам PBXT, недоступна (включая статистику sweep и chkpnt).
Параметры командной строки
Параметры командной строки xtstat следующие:
| Параметр | Описание |
|---|---|
-?, --help |
Выводит справку. |
-h, --host=value |
Подключается к хосту. |
-u, --user=value |
Пользователь для входа, если не текущий пользователь. |
-p, --password[=value] |
Пароль для подключения к серверу. Если пароль не указан, он запрашивается с терминала. |
-d, --database=value |
Используемая база данных (необходимо указать pbxt или information_schema), по умолчанию information_schema
|
-P, --port=value |
Номер порта для подключения. |
-S, --socket=value |
Имя файла сокета для подключения. |
-D, --delay=value |
Задержка в секундах между опросами базы данных. |
--protocol=value |
Используемый протокол подключения: default/tcp/socket/pipe/memory
|
--display=value |
Столбцы для отображения: используйте короткие имена, разделенные | (символом вертикальной черты), допускается частичное совпадение. Используйте --display=all для отображения всех доступных столбцов. |
Параметры подключения также будут взяты из файла конфигурации MySQL, если он доступен.
Индикаторы размера
Значения, отображаемые xtstat — это либо время в миллисекундах, значение в байтах или счетчик. Если эти значения слишком велики для отображения, значение округляется, и добавляется индикатор размера.
Используются следующие индикаторы размера:
K |
: | Килобайты (1 024 байта) |
M |
: | Мегабайты (1 048 576 байт) |
G |
: | Гигабайты (1 073 741 824 байта) |
T |
: | Терабайты (1 099 511 627 776 байт) |
t |
: | тысячи (1000) |
m |
: | миллионы (1 000 000) |
b |
: | миллиарды (1 000 000 000) |
Статистические данные
Ниже приведен список статистических данных, отображаемых xtstat. Каждая статистика отображается в виде двух частей: категория и тип.
Вы можете выбирать категории и типы для отображения по мере необходимости. Например, --display=read отобразит всю активность чтения, --display=xact|stat отобразит активность транзакций и операторов.
Обратите внимание, что для диагностики лучше всего захватывать всю статистику. Причина в том, что вы никогда не знаете, где может возникнуть проблема, поэтому без определенной статистики вы можете не суметь определить проблему.
| Displayname | Name | Description |
|---|---|---|
time-curr |
Current Time | Текущее время в секундах |
time-msec |
TimeSinceLastCall | Прошедшее время в миллисекундах с момента последнего вызова статистики |
xact-commt |
Commit Count | Количество выполненных транзакций |
xact-rollb |
Rollback Count | Количество отменённых транзакций |
xact-waits |
Wait for Xact Count | Количество раз ожидания другой транзакции |
xact-dirty |
Dirty Xact Count | Количество транзакций, которые ещё необходимо обработать. Это также включает все текущие активные транзакции. Обработка означает, что поток Sweeper должен ещё просканировать транзакцию и собрать/отметить все "мусорные" данные, оставленные транзакцией. Мусор, например, версии строк, которые больше не видны ни одной транзакцией. |
stat-read |
Read Statements | Количество SELECT-запросов |
stat-write |
Write Statements | Количество UPDATE/INSERT/DELETE-запросов |
rec-in |
Record Bytes Read | Байты, прочитанные из файлов записей/строк |
rec-out |
Record Bytes Written | Байты, записанные в файлы записей/строк. Эти данные передаются из журналов транзакций в файлы данных (xtd) и файлы индексов строк (xtr). |
rec-syncs/ms |
Record File Flushes | 2 значения, разделенные двоеточием: количество операций сброса в файлы обработчика данных (.xtd) и индексов строк (.xtr), и время в миллисекундах, затраченное на выполнение операций сброса. |
rec-hits |
Record Cache Hits | Попадания при обращении к кэшу записей. Кэш записей кэширует файлы обработчика данных (.xtd) и индексов строк (.xtr). |
rec-miss |
Record Cache Misses | Промахи при обращении к кэшу записей |
rec-frees |
Record Cache Frees | Количество освобождённых страниц кэша записей |
rec-%use |
Record Cache Usage | Процент использования кэша записей. Это значение отображается xtstat как процент от общего доступного кэша, но значение, возвращаемое таблицей PBXT_STATISTICS, выражено в байтах используемой памяти. |
ind-in |
Index Bytes Read | Байты, прочитанные из файлов индексов |
ind-out |
IndexBytesWritten | Байты, записанные в файлы индексов. Эти данные передаются из файлов журнала индексов (ilog) в файлы индексов (xti) во время согласованного сброса индекса. |
ind-syncs/ms |
Index File Flushes | 2 значения, разделенные двоеточием: количество операций сброса в файлы индексов и время в миллисекундах, затраченное на операции сброса. |
ind-hits |
Index Cache Hits | Попадания при обращении к кэшу индексов |
ind-miss |
Index Cache Misses | Промахи при обращении к кэшу индексов |
ind-%use |
Index Cache Usage | Процент использования кэша индексов. Это значение отображается xtstat как процент от общего доступного кэша, но значение, возвращаемое таблицей PBXT_STATISTICS, выражено в байтах используемой памяти. |
ilog-in |
Index Log Bytes In | Байты, прочитанные из файлов журнала индексов |
ilog-out |
Index Log Bytes Out | Байты, записанные в файлы журнала индексов. Эти данные передаются из кэша индексов в оперативную память в файлы журнала индексов (ilog) во время согласованного сброса индекса. |
ilog-syncs/ms |
Index Log File Syncs | 2 значения, разделенные двоеточием: количество операций сброса в файлы журнала индексов и время в миллисекундах, затраченное на выполнение операций сброса. |
xlog-in |
Xact Log Bytes In | Байты, прочитанные из файлов журнала транзакций |
xlog-out |
Xact Log Bytes Out | Байты, записанные в файлы журнала транзакций. Это данные, переданные из буфера журнала транзакций (pbxt_transaction_buffer_size) в файлы журнала транзакций (.xlog). Эта передача происходит при подтверждении или при заполнении буфера журнала транзакций. |
xlog-syncs |
Xact Log File Syncs | Количество операций сброса в файлы журнала транзакций |
xlog-msec |
Xact Log Sync Time | Время в миллисекундах, затраченное на сброс файлов журнала транзакций |
xlog-hits |
Xact Log Cache Hits | Попадания при обращении к кэшу журнала транзакций |
xlog-miss |
Xact Log Cache Misses | Промахи при обращении к кэшу журнала транзакций |
xlog-%use |
Xact Log Cache Usage | Процент использования кэша журнала транзакций. Это значение отображается xtstat как процент от общего доступного кэша, но значение, возвращаемое таблицей PBXT_STATISTICS, выражено в байтах используемой памяти. |
data-in |
Data Log Bytes In | Байты, прочитанные из файлов журнала данных |
data-out |
Data Log Bytes Out | Байты, записанные в файлы журнала данных. Эти данные передаются из буфера журнала данных (pbxt_log_buffer_size) в файлы журнала данных (.dlog) при заполнении буфера или при подтверждении. |
data-syncs |
Data Log File Syncs | Количество операций сброса в файлы журнала данных |
data-msec |
Data Log Sync Time | Время в миллисекундах, затраченное на сброс файлов журнала данных |
to-chkpt |
Bytes to Checkpoint | Байты, записанные в журнал транзакций с момента последнего контрольного пункта |
to-write |
Log Bytes to Write | Байты, записанные в журнал транзакций, которые ещё необходимо записать в базу данных |
to-sweep |
Log Bytes to Sweep | Байты, записанные в журнал транзакций, которые ещё необходимо прочитать потоком Sweeper |
sweep-waits |
SweeperWaitonXact | Попытка очистить транзакцию |
scan-index |
Index Scan Count | Количество сканирований индексов |
scan-table |
Table Scan Count | Количество сканирований таблиц |
row-sel |
Select Row Count | Количество выбранных строк |
row-ins |
Insert Row Count | Количество вставленных строк |
row-upd |
Update Row Count | Количество обновлённых строк |
row-del |
Delete Row Count | Количество удалённых строк |
Дополнительная информация
Документация на этой странице основана на документации xtstat на сайте PrimeBase.
В презентации Пола Маккаллага с конференции пользователей 2010 года есть примеры использования: http://www.primebase.org/download/pbxt-uc-2010.pdf
© 2023 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.
https://mariadb.com/kb/en/xtstat/
