Начните работу с Key Visualizer.

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

Прежде чем начать

Для использования Key Visualizer для Cloud Firestore необходимо включить API Firestore Key Visualizer.

Роли, необходимые для включения API.

Для включения API вам потребуется разрешение serviceusage.services.enable . Если вы создали проект, то, скорее всего, у вас уже есть это разрешение через роль Владельца ( roles/owner ). В противном случае вы можете получить это разрешение через роль Администратора использования сервисов ( roles/serviceusage.serviceUsageAdmin ). Узнайте, как предоставлять роли .

Включить API

Требуемые роли

Убедитесь, что вашей учетной записи назначена одна из следующих ролей IAM:

  • Владелец облачного хранилища данных
  • Cloud Datastore Key Visualizer Viewer
  • Редактор
  • Владелец

Эти роли включают следующие разрешения IAM, необходимые для доступа к Key Visualizer:

  • datastore.keyVisualizerScans.get
  • datastore.keyVisualizerScans.list
  • datastore.databases.getMetadata
  • resourcemanager.projects.get

Вы также можете определить пользовательскую роль с необходимыми правами доступа.

Просмотр снимка в течение определенного периода времени.

Каждое сканирование Key Visualizer охватывает двухчасовой период. Сканирование за определенный период доступно для баз данных, трафик которых превышает 3000 операций с документами в минуту в течение этого периода.

Чтобы запустить Key Visualizer:

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

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

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

  3. В навигационном меню нажмите «Визуализатор ключей» .

  4. Выберите временной интервал и показатель из доступных вариантов сканирования Key Visualizer:

    1. Нажмите на значок карандаша в правом верхнем углу. Выберите дату и временной интервал .

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

    2. В качестве источника выберите «Все данные документа» или «Все данные индекса» .

    3. Нажмите «Обновить» .

  5. Выберите показатель для анализа:

    Щелкните раскрывающийся список метрик в верхнем левом углу и выберите метрику для просмотра. По умолчанию Key Visualizer откроется с метрикой «Операции/с» для ключей документов и метрикой «Операции записи индекса/с» для ключей индексов.

Для сравнения метрик или поиска корреляций данных можно отображать несколько метрик Key Visualizer одновременно. См. раздел «Поиск связей между различными метриками» .

Просмотр обзора активности

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

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

  • Диапазоны, обозначенные темными цветами, характеризуются незначительной или нулевой активностью.
  • Яркие цветовые гаммы демонстрируют значительно большую активность.
  • Светящаяся белая полоса посередине характеризуется очень высокой активностью.

Пример сканирования с помощью Key Visualizer.

Сканирование ключей документа

Показатель Ops/s измеряет количество запросов в секунду для каждого диапазона ключей. Этот показатель представляет собой сумму запросов на запись, поиск и запросы к данным. Key Visualizer отображает этот показатель по умолчанию при открытии тепловой карты.

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

Сканирование ключевых слов индекса

Показатель Index Write Ops/s в данной ячейке измеряет среднее количество операций записи в индекс в секунду в течение соответствующего 10-секундного временного интервала и диапазона ключей.

Что дальше?