Включить отслеживание запросов Connection::startTracker

Модуль: main — подключать отдельно не нужно

Доступно с версии: 14.0.0

Метод Connection::startTracker включает сбор сведений о запросах, которые выполняет метод query. Объект Bitrix\Main\Diag\SqlTracker собирает по каждому запросу текст, параметр binds, идентификатор узла, время выполнения вместе с выборкой строк, число выбранных строк и стек вызовов. Глубину стека задает ключ depth_back_trace секции exception_handling в .settings.php, по умолчанию — 10 уровней. Запросы с ошибкой тоже попадают в сведения.

Сигнатура метода в классе Bitrix\Main\DB\Connection:

public function startTracker($reset = false)

Параметры

Параметр Тип Описание
reset bool Очищает собранные ранее сведения, если равен true. По умолчанию — false

Тип в таблице описывает назначение аргумента. Сигнатура PHP не объявляет его.

Возвращаемое значение

Метод возвращает объект Bitrix\Main\Diag\SqlTracker. Если у соединения еще нет объекта, метод создает его. Иначе возвращает тот же объект, который задал setTracker или метод создал раньше.

Сбор действует до вызова stopTracker.

Примеры

Пример. Код собирает сведения о двух запросах и выводит их число и общее время:

<?php
use Bitrix\Main\Application;
use Bitrix\Main\UserTable;

require $_SERVER['DOCUMENT_ROOT'] . '/bitrix/modules/main/include/prolog_before.php';

$connection = Application::getConnection();
$tracker = $connection->startTracker(true);

try
{
    $connection->queryScalar('SELECT COUNT(*) FROM ' . UserTable::getTableName());
    $connection->queryScalar('SELECT MAX(ID) FROM ' . UserTable::getTableName());
}
finally
{
    $connection->stopTracker();
}

echo $tracker->getCounter() . ' queries, ' . round($tracker->getTime(), 4) . ' s' . PHP_EOL;

foreach ($tracker->getQueries() as $query)
{
    echo $query->getSql() . PHP_EOL;
}

Смотрите также