На этой странице описано, как использовать панель Query Insights для обнаружения и анализа проблем с производительностью запросов.
Обзор статистики запросов
Используйте панель Query Insights, чтобы отслеживать запросы, связанные с показателями. На основе этих показателей можно определить наиболее часто используемые запросы и запросы с высокой задержкой, которые могут потребовать оптимизации. Панель Query Insights позволяет:
- Оптимизация эффективности запросов. Выявляйте запросы с высокой задержкой, которые могут требовать оптимизации.
- Управление стоимостью запросов. Выявляйте дорогостоящие запросы и оптимизируйте их, чтобы снизить расходы.
- Отслеживание статистики запросов. Вы можете отслеживать статистику запросов за определенный период времени.
Данные Query Insights
Статистика запросов включает данные из следующих методов API:
listDocumentslistCollectionIdsrunQueryrunAggregationQuerypartitionQueryexecutePipeline
Вы можете просматривать данные о запросах, в которых используются эти методы, для определенного проекта, базы данных и периода времени от 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.
Вы также можете получить это разрешение с помощью специальных ролей или других предопределенных ролей.
Как посмотреть статистику запросов
Чтобы посмотреть статистику запросов для базы данных Cloud Firestore, откройте панель Статистика запросов в консоли Google Cloud.
В консоли Google Cloud перейдите на страницу Databases (Базы данных).
Выберите базу данных из списка.
В меню навигации выберите Статистика запросов.

В раскрывающемся списке Тип загрузки можно найти основные запросы по задержке или количеству операций чтения.