Как анализировать статистику эффективности запросов

На этой странице описано, как использовать панель Query Insights для обнаружения и анализа проблем с производительностью запросов.

Обзор статистики запросов

Используйте панель Query Insights, чтобы отслеживать запросы, связанные с показателями. На основе этих показателей можно определить наиболее часто используемые запросы и запросы с высокой задержкой, которые могут потребовать оптимизации. Панель Query Insights позволяет:

  • Оптимизация эффективности запросов. Выявляйте запросы с высокой задержкой, которые могут требовать оптимизации.
  • Управление стоимостью запросов. Выявляйте дорогостоящие запросы и оптимизируйте их, чтобы снизить расходы.
  • Отслеживание статистики запросов. Вы можете отслеживать статистику запросов за определенный период времени.

Данные Query Insights

Статистика запросов включает данные из следующих методов API:

  • find
  • aggregate

Вы можете просматривать данные о запросах, в которых используются эти методы, для определенного проекта, базы данных и периода времени от 10 минут до 30 дней. Данные по запросам с одинаковой структурой объединяются в один нормализованный запрос.

В Query Insights можно получить следующую информацию о запросе:

Нормализованный текст запроса Структура запроса, представленная в виде текста.
Количество выполнений Количество выполнений за выбранный период времени.
Количество ошибок Количество ошибок за выбранный период времени.
Средняя продолжительность выполнения(мс) Среднее время в миллисекундах, которое потребовалось базе данных для обработки запроса.
Среднее количество возвращенных результатов Количество результатов, возвращенных запросом. Результаты включают документы, идентификаторы коллекций и агрегированные сегменты.
Среднее количество отсканированных документов Количество документов, отсканированных в запросе.
Среднее количество просканированных записей индекса Количество записей индекса, проверенных для выполнения запроса.
Нагрузка по среднему времени Данные, которые помогают отфильтровать самые популярные запросы на основе средней задержки.
Нагрузка по общему количеству операций чтения (оплачиваемых) Данные, которые помогают отфильтровать основные запросы на основе общего количества платных операций чтения.

Детализация и хранение данных

Уровень детализации данных зависит от указанной продолжительности:

  • 10 минут для интервалов до 4 дней назад;
  • 1 час для интервалов до 30 дней назад;

Максимальный срок хранения данных для Query Insights составляет 30 дней. Данные с разбивкой по 10 минут хранятся четыре дня, а с разбивкой по часам – 30 дней.

Ограничения

Данные Query Insights обновляются с задержкой в один-два часа.

Цены

За использование статистики запросов не взимается дополнительная плата.

Необходимые роли

Чтобы получить разрешение, необходимое для просмотра панели Query Insights, попросите администратора назначить вам роль IAM Datastore Viewer (roles/datastore.viewer) в проекте.

Эта стандартная роль содержит разрешение datastore.insights.get, которое необходимо для просмотра панели Query Insights.

Вы также можете получить это разрешение с помощью специальных ролей или других предопределенных ролей.

Как посмотреть статистику запросов

Консоль Firebase
  1. Чтобы посмотреть статистику запросов для базы данных Cloud Firestore, откройте панель Статистика запросов в консоли Google Cloud.

  2. В консоли Firebase перейдите на страницу База данных Firestore.

    Перейти к базе данных Firestore

  3. Выберите базу данных из списка.
  4. В списке вкладок выберите Query Insights.

    Чтобы найти основные запросы по задержке или количеству операций чтения, нажмите Задержка или Операции чтения.

Дальнейшие действия