На этой странице описано, как использовать показатели Cloud Monitoring для Cloud Firestore, чтобы отслеживать базу данных.
Cloud Monitoring: показатели за Cloud Firestore.
В разделах ниже приведены общие сведения о показателях, доступных для Cloud Firestore.
Ресурсы для мониторинга
Ресурс для мониторинга в Cloud Monitoring представляет собой логический или физический объект, например виртуальную машину, базу данных или приложение. Ресурсы для мониторинга содержат уникальный набор показателей, которые можно изучать, включать в отчеты на панели управления или использовать для создания оповещений. У каждого ресурса также есть набор ярлыков, которые представляют собой пары "ключ-значение" и содержат дополнительную информацию о ресурсе. Ярлыки ресурсов доступны для всех показателей, связанных с ресурсом.
При использовании Cloud Monitoring API эффективность Cloud Firestore отслеживается с помощью следующего ресурса:
| Материалы | Описание |
firestore.googleapis.com/Database | Тип отслеживаемого ресурса, который предоставляет разбивку по project, location и database_id. |
Показатели
Полный список показателей для Cloud Firestore приведен в статье Показатели Cloud Firestore. Ниже описаны некоторые из доступных показателей.
Показатели времени выполнения сервиса
Показатели serviceruntime позволяют получить общее представление о трафике проекта. Эти показатели доступны для большинства API Google Cloud. Тип ресурса для мониторинга consumed_api содержит следующие общие показатели. Эти показатели собираются каждые 30 минут, поэтому данные сглаживаются.
Важный ярлык ресурса для показателей serviceruntime – method. Этот ярлык представляет базовый метод RPC, который был вызван. Метод SDK, который вы вызываете, не обязательно должен называться так же, как базовый метод RPC. Это связано с тем, что SDK предоставляет высокоуровневую абстракцию API. Однако, чтобы понять, как ваше приложение взаимодействует с Cloud Firestore, важно понимать показатели, основанные на названии метода RPC.
Если вам нужно узнать, какой метод RPC лежит в основе того или иного метода SDK, ознакомьтесь с документацией по API.
api/request_latencies
Показатель api/request_latencies позволяет получить распределение задержек по всем выполненным запросам.
Cloud Firestore регистрирует показатели из компонента Cloud Firestore Service. Показатели задержки включают время, прошедшее с момента получения запроса Cloud Firestore до момента завершения отправки ответа Cloud Firestore, включая взаимодействия с уровнем хранения. Поэтому задержка при передаче данных туда и обратно (RTT) между клиентом и сервисом Cloud Firestore не учитывается в этих показателях.
Показатели операций с документами
Cloud Firestore предоставляет количество операций чтения, записи и удаления. Показатель записи содержит разбивку между операциями CREATE и UPDATE. Эти показатели соответствуют операциям CRUD.
Следующие показатели помогут вам понять, преобладают ли в вашей базе данных операции чтения или записи, а также соотношение новых и удаленных документов.
document/delete_ops_count: количество успешно удаленных документов.document/read_ops_count: количество успешных считываний документов из запросов или поисков.document/write_ops_count: количество успешных записей документов.
Платежные показатели
Эти показатели позволяют понять, как используются платежные аккаунты. Эти показатели не включают оплату за операции администратора (индексирование, импорт, экспорт и массовое удаление).
api/billable_read_units– количество оплачиваемых единиц чтения. Данные об использовании можно разбить по названию сервиса и методу API.api/billable_realtime_read_units– количество оплачиваемых единиц обновления в реальном времени. Это относится только к Cloud Firestore в нативном режиме.api/billable_write_units– количество оплачиваемых единиц записи. Данные об использовании можно разбить по названию сервиса и методу API.document/billable_managed_delete_write_units– количество оплачиваемых единиц записи из управляемых сервисов удаления, таких как TTL.
Показатели индексирования
Чтобы понять, как работает разветвление индекса, можно сравнить частоту записи индекса с показателем document/write_ops_count.
index/write_count– количество записей индекса.
Показатели TTL
Показатели TTL для Cloud Firestore используются для отслеживания действия правил TTL.
document/ttl_deletion_count: общее количество документов, удаленных сервисами TTL.document/ttl_expiration_to_deletion_delays– время, прошедшее с момента истечения срока действия документа с TTL до его фактического удаления.
Как просматривать стандартные сводки и создавать собственные
Cloud Firestore поддерживает стандартные сводки, в которых используются показатели Cloud Monitoring. Вы также можете создавать собственные сводки.
Как посмотреть показатели использования базы данных
Откройте панели мониторинга использования в консоли Google Cloud, чтобы посмотреть, сколько документов было прочитано, записано и удалено за определенный период времени.
Контроль доступа
Для работы с панелями использования требуется разрешение monitoring.timeSeries.list Identity and Access Management (IAM).
Это разрешение есть у владельца, редактора и наблюдателя проекта. Вы также можете предоставить это разрешение с помощью роли Cloud Monitoring или специальной роли.
Панель управления использованием базы данных
Чтобы посмотреть показатели использования базы данных Cloud Firestore, выполните следующие действия:
В консоли Google Cloud перейдите на страницу Databases (Базы данных).
Выберите нужную базу данных из списка.
В меню навигации нажмите Использование.
Панель использования и отчеты об оплате
Панели управления использованием Cloud Firestore в консоли предоставляют приблизительные данные. Они помогут вам выявить пики использования. Однако на панели управления не отражаются точные данные об оплаченных операциях. Скорее всего, оплачиваемое использование выше. Чтобы отслеживать оплату, ознакомьтесь с показателями оплаты.
Во всех случаях расхождений отчет об оплате имеет приоритет над панелью управления использованием.
Операции импорта и экспорта вызывают расхождения между данными на панели использования и данными об использовании, за которое взимается плата. Операции чтения и записи, выполняемые этими операциями, не отображаются на панели использования.
Просмотр показателей эффективности базы данных
На странице Мониторинг в разделе Cloud Firestore консоли Google Cloud есть готовые панели мониторинга, например Задержки запросов (P50 и P99), Коды ответов и Статистика запросов (P50). Вы также можете создать одну собственную сводку. Чтобы перейти на страницу Мониторинг для базы данных, выполните следующие действия:
В консоли Google Cloud откройте страницу Cloud Firestore Databases (Базы данных).
Выберите базу данных из списка.
В меню навигации нажмите Мониторинг, чтобы открыть панель управления.
Создание собственных сводок Cloud Monitoring
В Cloud Monitoring вы можете создавать собственные сводки, чтобы упорядочивать и просматривать нужную вам информацию. Например, вы можете создать сводку, в которой будут показываться показатели эффективности и правила оповещений для проекта в рабочей среде.
Дополнительную информацию о настройке сводки можно найти в статьях Как управлять специальной сводкой и Как добавлять виджеты в сводки.
Как создать правило оповещений
В Cloud Monitoring можно создать оповещения, которые будут сообщать вам об изменении показателей. Они позволяют узнавать о потенциальных проблемах до того, как они затронут пользователей.
Подробнее о том, как создавать правила оповещений о пороговых значениях показателей…
Рассмотрим пример, в котором мы создаем правило оповещения о задержке. Правила оповещений проверяют задержку p99 в течение 5-минутного скользящего окна. Если задержка p99 остается выше 250 мс в течение пяти минут, срабатывает оповещение.
Консоль
В консоли Google Cloud перейдите на страницу Monitoring (Мониторинг) и выберите notifications Alerting (Оповещения).
Нажмите Create policy (Создать правило).
Выберите показатель Request Latencies (Задержки запросов) из ресурса Consumed API (Потребление API).
Добавьте фильтр сервиса для
firestore.googleapis.comдля баз данных Firestore в нативном режиме.Нажмите Далее, чтобы настроить триггер.
В качестве типа условия выберите Пороговое значение.
Пороговое условие установлено на значение 250 мс. Оповещение срабатывает, когда значение задержки p99 остается неизменным в течение всего периода скользящего окна (5 минут).
В поле Пороговое значение укажите 250.
Нажмите Далее, чтобы настроить уведомления.
Укажите название правила оповещений и нажмите Далее.
Проверьте настройки оповещений и нажмите Create Policy (Создать правило).
MQL : лид, одобренный отделом маркетинга
Вы можете реализовать то же правило оповещения о задержке, используя запрос на языке запросов мониторинга (MQL). Другие примеры использования MQL можно найти в разделе Примеры запросов MQL.
fetch consumed_api
| metric 'serviceruntime.googleapis.com/api/request_latencies'
| filter (resource.service == 'firestore.googleapis.com')
| group_by 5m,
[value_request_latencies_percentile:
percentile(value.request_latencies, 99)]
| every 5m
| condition val() > 0.25 's'