Как отслеживать действия в Cloud Firestore

На этой странице описано, как отслеживать использование Cloud Firestore и выявлять потенциальные проблемы в приложении.

Панель использования

Используйте панели мониторинга использования в консоли Google Cloud и консоли Firebase, чтобы просматривать количество операций чтения, записи и удаления документов за определенный период времени.

Контроль доступа

Для работы с панелями использования требуется разрешение Cloud IAM monitoring.timeSeries.list. Это разрешение есть у владельца, редактора и наблюдателя проекта. Вы также можете предоставить это разрешение с помощью роли Cloud Monitoring или специальной роли.

Панель управления использованием базы данных

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

1. В консоли Google Cloud перейдите на страницу Databases (Базы данных).

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

2. Выберите нужную базу данных из списка.

3. В меню навигации нажмите Использование.

4. Чтобы посмотреть статистику использования базы данных, нажмите на ссылку в сообщении, которое появится на странице.

   

Панель сводных данных об использовании

Если в вашем проекте несколько баз данных Cloud Firestore, вы можете посмотреть агрегированные показатели использования в консоли Google Cloud или консоли Firebase.

Панель управления использованием и отчеты об оплате

Панели управления использованием Cloud Firestore в консолях Firebase и Cloud предоставляют приблизительные данные. Они помогут вам выявить всплески использования. Однако на панели управления не отражаются точные данные об операциях, за которые взимается плата. Оплачиваемое использование, скорее всего, выше. Во всех случаях расхождений отчет об оплате имеет приоритет над панелью управления использованием.

К операциям, которые вызывают расхождения между панелью использования и оплаченным использованием, относятся:

• Импорт и экспорт. Операции чтения и записи, выполняемые этими операциями, не отображаются на панели мониторинга использования.
• Записи только для проверки No-op. Операции записи, которые только проверяют наличие или отсутствие документа, учитываются как платные операции чтения, но на панели использования операций записи они отображаются как UPDATE_NOOP и DELETE_NOOP соответственно.
• No-op. Операции, которые не приводят к изменению базы данных, например обновление, не меняющее значения полей, или запись в удаленный документ, могут отображаться на панели управления как UPDATE_NOOP или DELETE_NOOP. Хотя они отображаются как NOOP, они все равно учитываются в платных операциях.

• Свернутые записи. Если в один и тот же документ быстро вносится несколько изменений, на панели использования они могут быть объединены и учтены как одно. При выставлении счетов за использование каждая запись по-прежнему учитывается отдельно.

  На панели использования также сворачиваются записи для преобразований полей, таких как временные метки сервера, числовые приращения и операции объединения массивов. При преобразовании полей панель мониторинга использования может считать несколько операций как одну.

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

На панели использования для удалений не фиксируются автоматические операции истечения срока действия, выполняемые правилами TTL. Ознакомьтесь с показателями TTL в Cloud Monitoring.

Использование правил безопасности

Кроме того, в консоли Firebase есть панель оценки правил безопасности Firebase, на которой можно быстро посмотреть вызовы правил. Вы также можете отслеживать использование правил безопасности Firebase в Cloud Monitoring. Это позволяет получать те же показатели оценки правил, а также создавать собственные панели мониторинга, анализировать тенденции и настраивать оповещения (например, о резком увеличении количества отклоненных запросов). Полный список доступных показателей приведен в справочнике по показателям Cloud Monitoring.

Перейти в раздел "Правила"

Cloud Monitoring показателя

Cloud Monitoring собирает показатели, события и метаданные из продуктов Google Cloud. На панели использования в консоли Cloud Firestore представлены те же данные. Чтобы настроить собственные сводки и оповещения об использовании, используйте Cloud Monitoring.

Cloud Monitoring включает следующие показатели Cloud Firestore:

Название показателя	Описание
Чтение документов	Количество успешных считываний документов. Этот показатель можно разбить по типу чтения: LOOKUP или QUERY. Этот показатель не включает операции чтения, связанные с управляемым экспортом или массовым удалением.
Запись документов	Количество успешных записей документов. Показатель можно разбить по типу записи: CREATE или UPDATE. Этот показатель не включает записи из управляемых операций импорта.
Удаление документов	Количество успешно удаленных документов.
Активные подключения	Количество активных подключений к базе данных. Каждый активный SDK для мобильных устройств и веб-приложений поддерживает одно подключение, которое может использоваться несколькими прослушивателями снимков. Серверные клиентские библиотеки создают по одному подключению на каждый прослушиватель снимков.
Snapshot Listener	Количество прослушивателей снимков во всех активных подключениях.
Количество удалений по истечении срока хранения	Общее количество документов, удаленных в соответствии с правилами TTL.
Задержки между истечением срока хранения и удалением	Время, прошедшее с момента, когда срок действия документа истек в соответствии с правилом TTL, до момента, когда он был фактически удален.

Использование обновлений в реальном времени

Используйте показатели активных подключений и прослушивателей снимков, чтобы оценить использование обновлений в реальном времени.

Предположим, пользователь открывает ваше приложение на телефоне. Затем приложение подключается к Cloud Firestore и подписывается на 10 запросов. Это увеличивает ваши показатели на 1 активное подключение и 10 прослушивателей снимков.

Частота дискретизации

Показатели Cloud Firestore обновляются каждую минуту, но в сводках они могут появляться с задержкой до четырех минут.

Показатели задержки

Показатели задержки бэкенда доступны в общих показателях Google Cloud firestore.

Например, график задержки p50 можно найти в представлении Metrics Explorer в Cloud Console.

Настройте сводку Cloud Monitoring

Чтобы посмотреть стандартную сводку или настроить сводку, ознакомьтесь со статьей Как использовать сводку мониторинга.

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

• Подробнее о Cloud Monitoring…
• Ознакомьтесь с рекомендациями по отслеживанию производительности Firestore.