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

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

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

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

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the 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-секундного временного интервала и диапазона ключей.

Что дальше?