Глава 60. SQL-статистика

PPEM позволяет просматривать статистику выполнения SQL-операторов на основе данных, полученных от расширений pg_stat_statements и pgpro_stats. Для правильного сбора SQL-статистики в экземпляре должно быть установлено и настроено одно из этих расширений.

Чтобы просмотреть SQL-статистику:

  1. В навигационной панели перейдите в Инфраструктура → Экземпляры.

  2. Нажмите на имя экземпляра.

  3. В навигационной панели перейдите в SQL-статистика.

Отобразится таблица со следующими столбцами:

  • Идентификатор запроса:: неуникальный хеш-код оператора. Может совпадать с хеш-кодами других операторов, которые выполнялись в других базах данных или от имени других пользователей.

    Столбец содержит дополнительную информацию:

    • Идентификатор плана: неуникальный хеш-код плана запроса. Может совпадать с хеш-кодами других планов по операторам, которые выполнялись в других базах данных или от имени других пользователей.

      Этот столбец отображается только для редакции Postgres Pro Enterprise.

    • Оператор верх. уровня: уровень выполнения оператора.

      Возможные значения:

      • Да: оператор выполняется на верхнем уровне.

      • Нет: оператор вложен в процедуру или функцию.

      Чтобы отобразить эту информацию, задайте top для параметра конфигурации pg_stat_statements.track или pgpro_stats.track.

  • База данных: база данных экземпляра, в которой выполнялся оператор.

  • Пользователь: имя пользователя, выполнявшего оператор.

  • Выполнения, шт.: общее количество выполнений оператора.

    Столбец содержит дополнительную информацию:

    Строки, шт.: общее количество строк, полученных или затронутых оператором.

  • Время выполнения, мс: общее время в миллисекундах, затраченное на выполнение оператора.

    Столбец содержит дополнительную информацию:

    • Макс.: максимальное время, затраченное на выполнение оператора.

    • Мин.: минимальное время, затраченное на выполнение оператора.

    • Среднее: среднее время, затраченное на выполнение оператора.

    • Откл.: стандартное отклонение времени, затраченного на выполнение оператора.

  • Время планирования, мс: общее время в миллисекундах, затраченное на планирование оператора.

    Чтобы отобразить эту информацию, задайте on для параметра конфигурации pg_stat_statements.track_planning или pgpro_stats.track_planning. В противном случае отображается 0.

    Столбец содержит дополнительную информацию:

    • Макс.: максимальное время, затраченное на планирование оператора.

    • Мин.: минимальное время, затраченное на планирование оператора.

    • Среднее: среднее время, затраченное на планирование оператора.

    • Откл.: стандартное отклонение времени, затраченного на планирование оператора.

  • Запись и чтение блоков, мс: общее время в миллисекундах, затраченное оператором на чтение и запись блоков файлов данных.

    Чтобы отобразить эту информацию, включите параметр конфигурации track_io_timing. В противном случае отображается 0.

    Столбец содержит дополнительную информацию:

    • Чтение: время, затраченное на чтение блоков.

    • Запись: время, затраченное на запись блоков.

  • Временные блоки, шт.: общее количество блоков, затронутых оператором при работе с временными файлами.

    Столбец содержит дополнительную информацию:

    • Прочитаны: количество прочитанных блоков.

    • Записаны: количество записанных блоков.

  • Объём WAL, Б: общий объём WAL в байтах, сгенерированный при выполнении оператора.

    Столбец содержит дополнительную информацию:

    • Записи, шт.: общее количество записей WAL, сгенерированных при выполнении оператора.

    • Образы, шт.: общее количество образов полных страниц в WAL, сгенерированных при выполнении оператора.

  • Блоки в общем кеше, шт.: общее количество попаданий в кеш разделяемых блоков для оператора.

    Столбец содержит дополнительную информацию:

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

    • Загрязнены: общее количество разделяемых блоков, «загрязнённых» оператором.

    • Запись: общее количество разделяемых блоков, записанных оператором.

  • Блоки в локальных кешах, шт.: общее количество попаданий в кеш локальных блоков для оператора.

    Столбец содержит дополнительную информацию:

    • Прочитаны: общее количество локальных блоков, прочитанных оператором.

    • Загрязнены: общее количество локальных блоков, «загрязнённых» оператором.

    • Запись: общее количество локальных блоков, записанных оператором.

Чтобы просмотреть информацию об операторе, нажмите рядом с ним.

Отображаемая статистика запрашивается через агента, который работает с экземпляром. По этой причине скорость получения статистики зависит от двух факторов:

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

  • объёма передаваемых данных, который может также косвенно влиять на производительность экземпляра

Учитывая накопительную природу статистики, полученный снимок статистики может со временем отличаться от фактической статистики экземпляра.

Под статистикой отображаются блоки Запрос and План запроса. В правом верхнем углу этих блоков можно выполнить следующие действия:

  • Чтобы скопировать запрос или его план, нажмите .

  • Чтобы визуализировать план запроса, нажмите .

Chapter 60. SQL Statistics

PPEM allows viewing execution statistics of SQL statements. This information is provided by the pg_stat_statements and pgpro_stats extensions. For SQL statistics collection to work correctly, one of these extensions must be installed and configured in the instance.

To view SQL statistics:

  1. In the navigation panel, go to Infrastructure → Instances.

  2. Click the name of the instance.

  3. In the navigation panel, go to SQL statistics.

The table with the following columns will be displayed:

  • Query ID: The non-unique hash code of the statement. It can be the same as that of other statements executed in other databases or on behalf of other users.

    This column includes additional information:

    • Query plan ID: The non-unique hash code of the query plan. It can be the same as that of other plans for statements executed in other databases or on behalf of other users.

      This column is displayed only for the Postgres Pro Enterprise edition.

    • Top level: The statement execution level.

      Possible values:

      • Yes: The statement is executed at the top level.

      • No: The statement is nested in a procedure or function.

      To display this information, set the pg_stat_statements.track or pgpro_stats.track configuration parameter to top.

  • Database: The instance database where the statement was executed.

  • User: The name of the user who executed the statement.

  • Calls: The total number of times the statement was executed.

    This column includes additional information:

    Rows: The total number of rows retrieved or affected by the statement.

  • Total execution time, ms: The total time spent executing the statement, in milliseconds.

    This column includes additional information:

    • Max: The maximum time spent executing the statement.

    • Min: The minimum time spent executing the statement.

    • Mean: The mean time spent executing the statement.

    • Stddv: The standard deviation of time spent executing the statement.

  • Total planning time, ms: The total time spent planning the statement, in milliseconds.

    To display this information, set the pg_stat_statements.track_planning or pgpro_stats.track_planning configuration parameter to on. Otherwise, 0 is displayed.

    This column includes additional information:

    • Max: The maximum time spent planning the statement.

    • Min: The minimum time spent planning the statement.

    • Mean: The mean time spent planning the statement.

    • Stddv: The standard deviation of time spent planning the statement.

  • Block write and read time, ms: The total time the statement spent reading and writing data file blocks, in milliseconds.

    To display this information, enable the track_io_timing configuration parameter. Otherwise, 0 is displayed.

    This column includes additional information:

    • Read: The time spent reading blocks.

    • Write: The time spent writing blocks.

  • Temp blocks, pc.: The total number of blocks affected by the statement when working with temporary files.

    This column includes additional information:

    • Read: The number of read blocks.

    • Written: The number of written blocks.

  • WAL bytes, B: The total amount of WAL bytes generated during the statement execution.

    This column includes additional information:

    • Records, pc.: The total number of WAL records generated during the statement execution.

    • FPI, pc.: The total number of WAL full-page images generated during the statement execution.

  • Shared blocks • Hits, pc.: The total number of shared block cache hits by the statement.

    This column includes additional information:

    • Read: The total number of shared blocks read by the statement.

    • Dirtied: The total number of shared blocks dirtied by the statement.

    • Write: The total number of shared blocks written by the statement.

  • Local blocks • Hits, pc.: The total number of local block cache hits by the statement.

    This column includes additional information:

    • Read: The total number of local blocks read by the statement.

    • Dirtied: The total number of local blocks dirtied by the statement.

    • Write: The total number of local blocks written by the statement.

To view the information about a statement, click next to it.

The displayed statistics are requested via the agent working with the instance. For this reason, the speed at which statistics are retrieved depends on two factors:

  • network connectivity between the manager and the agent that works with the instance

  • the volume of transferred data that can also indirectly affect the instance performance

Given the cumulative nature of statistics, the resulting statistics snapshot can differ over time from the actual instance statistics.

Below the statistics, Query and Query plan blocks are displayed. You can perform the following actions in the top-right corner of these blocks:

  • To copy the query or its plan, click .

  • To visualize the query plan, click .

FAQ