Эта страница переведена с помощью Cloud Translation API.

Мониторинг платформы Google Maps

Cloud Monitoring собирает метрики для ваших API и сервисов, а также ресурсов Google Cloud, которые вы используете. В этой теме описывается, как настроить Cloud Monitoring и как использовать его для мониторинга использования API, создания панелей мониторинга и оповещений.

Cloud Monitoring имеет большой набор функций и опций. В этой теме представлен Cloud Monitoring и приведены основные примеры. Информацию обо всех функциях, включая множество дополнительных примеров, см. в документации Cloud Monitoring .

Настройте облачный мониторинг

Мониторинг позволяет просматривать и управлять показателями:

Для одного проекта
Для нескольких проектов в рамках одной организации
Для нескольких проектов в нескольких организациях

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

В консоли Google Cloud выберите Мониторинг :
Перейти к мониторингу
Убедитесь, что вы выбрали правильный проект.
В навигационной панели Monitoring нажмите > справа от Metrics Scope . На следующем снимке экрана показана страница, которая отображается при выборе проекта AllEnvironments:

Таблица с надписью Метрики, отслеживаемые этим проектом, содержит список проектов, чьи метрики доступны для текущей области метрик. Каждая строка в таблице содержит проект и роль этого проекта:

Проект определения области действия : этот проект хранит проверки работоспособности, политики оповещения, группы и панели мониторинга, которые вы настраиваете. Между областью действия метрик и проектом определения области действия существует отношение 1:1. В этом примере проект AllEnvironments является проектом определения области действия.
Контролируемый проект : Метрики для проекта видны в текущей области метрик. Для этого примера проекты Staging и Production являются контролируемыми проектами.

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

Дополнительную информацию, включая информацию о добавлении и удалении проектов, см. в разделе Настройка облачного мониторинга .

Исследуйте метрики

Чтобы исследовать метрические данные, постройте диаграмму с помощью Metrics Explorer , который входит в состав Cloud Monitoring. Например, если вы хотите просмотреть использование квоты API, вы можете использовать Metrics Explorer для построения диаграммы, которая отображает самые последние данные.

На следующем изображении показана диаграмма, иллюстрирующая использование квот для API Карт:

Скриншот данных показателей квоты для всех API Карт. Он показывает столбчатую диаграмму, где каждый сегмент столбца соответствует разному API.

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

На этом изображении:

Поля «Тип ресурса» и «Метрика» слева от диаграммы определяют данные метрик, отображаемые на диаграмме.
Раскрывающийся список типов диаграммы над диаграммой позволяет выбрать тип диаграммы. В этом примере он установлен на Stacked bar chart .
Временной интервал над графиком установлен на 1W (одна неделя).
Под диаграммой находится список service , quota_metrics , API method и metric value , которые определяют данные диаграммы. Выберите Add Filter , чтобы использовать эту информацию для уточнения отображаемых данных.

Когда вы покидаете страницу Metrics Explorer, диаграмма удаляется, поэтому вам не нужно удалять нежелательные артефакты. Кроме того, вы можете сохранить диаграмму на пользовательской панели мониторинга или поделиться ею. Подробнее о добавлении диаграммы на панель мониторинга см. в разделе Создание панелей мониторинга ниже.

Диаграмма одной метрики

Чтобы настроить диаграмму с помощью Metrics Explorer, выполните следующие действия:

В консоли Cloud выберите Мониторинг :
Перейти к мониторингу
На панели навигации выберите Обозреватель метрик .
На панели инструментов выберите пункт «Сложенная столбчатая диаграмма» в раскрывающемся списке типов диаграммы, чтобы просмотреть данные показателей в виде столбчатой диаграммы.
Выберите временной интервал, например, 1W (одна неделя).
Укажите данные, которые будут отображаться на диаграмме. Чтобы использовать интерфейс на основе меню или ввести фильтр, выберите вкладку «Конфигурация» . Чтобы использовать язык запросов мониторинга (MQL), выберите вкладку MQL .
Примечание: MQL предоставляет выразительный текстовый интерфейс для данных временных рядов Cloud Monitoring. Все примеры в этой теме используют Cloud console. Для получения дополнительной информации см. Введение в язык запросов мониторинга .
1. Чтобы построить график использования квоты, выберите Consumer Quota в качестве типа ресурса . В качестве альтернативы, если вы хотите создать график использования API, выберите Consumed API или Google Maps API (см. раздел Показатели использования для получения более подробной информации о показателях использования, доступных для API платформы Google Карт). Наведите указатель мыши на каждый тип ресурса, чтобы увидеть его описание.
2. Для метрики выберите Оценить использование квоты . Диаграмма автоматически обновится для отображения данных метрики.
  Примечание: Если на диаграмме не отображаются данные, увеличьте временной интервал или выйдите и выполните несколько запросов API для генерации данных метрик.
  Обратите внимание, что для метрики есть и другие варианты квот. Наведите курсор на каждую метрику, чтобы увидеть описание. Для получения дополнительной информации о полях Metrics Explorer см. Выбор метрик и Выбор способа отображения данных в виде диаграммы .
(Необязательно) Используйте следующие параметры для уточнения отображения:
1. Чтобы указать подмножество данных для отображения, добавьте фильтры . Чтобы добавить фильтр, выберите Добавить фильтр и завершите диалоговое окно. Для получения дополнительной информации см. Фильтрация данных диаграммы . Например, чтобы просмотреть данные для одного API:
  1. В поле Метка выберите метод .
  2. В поле Сравнение выберите = (равно) .
  3. В поле Значение выберите имя конкретного метода. Вам будет предложено выбрать имя метода с данными для отображения.
  4. Выберите Готово , чтобы обновить диаграмму.
2. Для группировки временных рядов по метке используйте поле Group by . Выбор значения для этого поля автоматически выбирает значение для поля Aggregator .
3. Чтобы указать, как объединять временные ряды, установите поле Aggregator . Например, если поле Group by пустое, а поле Aggregator установлено на mean, то диаграмма отобразит среднее значение временного ряда.
4. Чтобы настроить способ обработки отдельных временных рядов, выберите Дополнительные параметры . Дополнительные сведения см. в разделе Выбор метрик при использовании Metrics Explorer .
При желании можно добавить на панель управления.
При выходе со страницы Metrics Explorer диаграмма удаляется. При желании вы можете выбрать Save Chart , чтобы сохранить диаграмму на новой или существующей панели мониторинга. Подробнее о добавлении диаграммы на панель мониторинга см. в разделе Creating dashboards ниже.

Диаграмма нескольких показателей

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

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

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

Более подробную информацию об изучении показателей см. в разделе:

Создание информационных панелей

Панели мониторинга позволяют просматривать и контролировать данные временных рядов в виде набора диаграмм. Cloud Monitoring поддерживает предопределенные панели мониторинга и пользовательские панели мониторинга:

Предопределенные панели мониторинга автоматически устанавливаются для используемых вами служб Google Cloud. Эти панели мониторинга не настраиваются.
Пользовательские панели мониторинга — это панели мониторинга, которые вы создаете. Пользовательские панели мониторинга позволяют вам определять данные, которые вы хотите просматривать, и как просматривать эти данные. Например, вы можете отображать данные метрик, политики оповещения и журналы, хранящиеся в вашем проекте. Вы можете отображать данные временных рядов на диаграмме, с помощью датчика или системы показателей или в табличной форме.

Для создания пользовательских панелей мониторинга вы можете использовать Cloud console или Cloud Monitoring API. На следующем изображении показана пользовательская панель мониторинга с двумя диаграммами:

График квот слева
Диаграмма количества API справа

Скриншот пользовательской панели мониторинга, отображающей две диаграммы. Диаграмма слева — это диаграмма квот, а диаграмма справа — это диаграмма использования API. Обе диаграммы содержат временные точки на горизонтальной оси.

Создайте пользовательскую панель мониторинга, создав диаграммы метрик, а затем добавив диаграммы на панель мониторинга. Вы можете создать диаграмму в обозревателе метрик , а затем добавить ее на новую или существующую панель мониторинга. Или вы можете создать панель мониторинга, а затем отредактировать ее, чтобы добавить диаграмму.

Если вы решили управлять пользовательскими панелями мониторинга с помощью API облачного мониторинга , обозреватель метрик предоставит вам две полезные утилиты:

Чтобы сгенерировать представление JSON для диаграммы, которую вы планируете добавить на панель мониторинга, настройте диаграмму с помощью Metrics Explorer. Затем вы можете получить доступ к представлению JSON из пункта меню Дополнительные параметры на панели инструментов Metrics Explorer.
Чтобы определить синтаксис для фильтра мониторинга, который используется с API Cloud Monitoring, используйте интерфейс Metrics Explorer с меню для настройки диаграммы. После выбора метрики и фильтров переключитесь в режим прямого фильтра , чтобы просмотреть эквивалентный фильтр мониторинга.

Создайте собственную панель инструментов

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

В консоли Cloud выберите Мониторинг :
Перейти к мониторингу
На панели навигации выберите Панели мониторинга .
На странице «Обзор панелей мониторинга» нажмите «Создать панель мониторинга» .
Примечание: Если вы редактируете существующую панель мониторинга, убедитесь, что вы находитесь в режиме редактирования. В правом верхнем углу, если Редактирование не отображается, нажмите Просмотр и выберите Переключиться в режим редактирования .
Для каждой диаграммы, которую вы хотите добавить на панель управления, выполните следующие действия:
1. Выберите тип диаграммы из меню «Добавить диаграмму» или перетащите ее из библиотеки в область графика.
  Отображается предварительно настроенная диаграмма выбранного типа. В следующем примере показана линейная диаграмма и ее панель конфигурации:
  Примечание: Если на диаграмме не отображаются данные, увеличьте временной интервал или выйдите и выполните несколько запросов API для генерации данных метрик.
2. Выберите тип ресурса и метрику , а затем примените любые фильтры так же, как вы делали выше при создании диаграммы.
  Дополнительную информацию о доступных вариантах см. в разделе Добавление виджетов на панель управления .
(Необязательно) На панели инструментов панели инструментов нажмите «Добавить диаграмму» , чтобы добавить еще одну диаграмму, а затем повторите предыдущие шаги, чтобы настроить диаграмму.
Когда вы закончите редактирование, выберите левую стрелку, чтобы выйти из панели мониторинга, или выберите любой другой пункт меню мониторинга . Ваша панель мониторинга сохраняется автоматически.

Просмотреть панель инструментов

Чтобы просмотреть панель мониторинга, выполните следующие действия:

В консоли Cloud выберите Мониторинг :
Перейти к мониторингу
На панели навигации выберите Панели мониторинга .
Выберите пользовательскую или предопределенную панель мониторинга из списка.

Более подробную информацию о создании панелей мониторинга см. в разделе:

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

Для мониторинга использования API платформы Google Карт доступны две группы метрик: метрики Serviceruntime (тип ресурса used_api ), доступные для большинства API Google Cloud , и метрики платформы Google Карт , специфичные для API платформы Google Карт (тип ресурса maps.googleapis.com/Api ).

Обе метрики поддерживают один и тот же набор меток ресурсов для разделения трафика использования API: project_id , service , method , version , location и credential_id . Смотрите описания меток ресурсов в документации для соответствующего ресурса Metrics:

Каждая группа метрик имеет два типа метрик для мониторинга использования: количество запросов и задержки запросов .

В метрике Request Count вы можете разделить трафик использования по меткам меток protocol , grpc_status_code , response_code и response_code_class . Кроме того, вы можете разделить по platform_type в метриках Google Maps Platform.

В метрике «Задержка запроса» можно разделить трафик использования по меткам меток protocol , platform_type , response_code и response_code_class только в метриках платформы Google Карт.

Более подробную информацию о типах и метках метрик смотрите в документации по соответствующей группе метрик:

Сопоставление меток статуса ответа и кода ответа

В таблице ниже показано сопоставление между кодом статуса ответа и кодом ответа HTTP, возвращаемым в ответ на запросы API платформы Google Карт, и метками кода ответа, доступными в Cloud Monitoring: код ответа HTTP, класс кода ответа HTTP, код статуса GRPC . Код статуса GRPC — это числовой код ответа gRPC для запросов gRPC или эквивалентный код gRPC для запросов HTTP.

Примечание: По историческим причинам код ответа HTTP, возвращаемый в ответ на запросы API платформы Google Карт, может отличаться от кода ответа HTTP в отчетах об использовании ( метрики платформы Google Карт ) и мониторинге облака ( мониторинг платформы Google Карт ). Метрики отчетов об использовании используют набор значений кодов ответа, которые соответствуют тем, которые используются в новых API. Это улучшает наблюдаемость использования API в метриках платформы Google Карт и мониторинге платформы Google Карт .

Коды ответов, возвращаемые в ответах API		Коды ответов, сообщенные в Мониторинг
Статус API Карт	HTTP-код ответа	HTTP-код ответа	Класс кода ответа HTTP	Код статуса GRPC
ХОРОШО	200, 204, 302	200, 204, 302	2хх, 3хх	0 (ОК)
ДАННЫЕ_НЕ_ДОСТУПНЫ, НЕ НАЙДЕНО, НУЛЕВЫЕ_РЕЗУЛЬТАТЫ	200	200, 404 ^{( 1 )}	2хх, 4xx ^{( 1 )}	5 (НЕ НАЙДЕНО) ^{( 1 )}
INVALID_REQUEST (недопустимое значение параметра), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, и т. д.	200, 400	400	4хх	3 (НЕДОПУСТИМЫЙ_АРГУМЕНТ)
INVALID_REQUEST (недопустимый/отсутствующий параметр, ошибка анализа запроса)	200, 400	400	4хх	3 (НЕДОПУСТИМЫЙ_АРГУМЕНТ)
ЗАПРОС_ОТКЛОНЕН	200, 403, 200, 400	403, 401 ^{( 1 )}	4xx ^{( 1 )}	7 (РАЗРЕШЕНИЕ_ОТКАЗАНО), 16 (НЕ ПОДТВЕРЖДЕНО)
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, РЕСУРС_ИСЧЕРПАН, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	429 ^{( 1 )}	4xx ^{( 1 )}	8 (РЕСУРС_ИСЧЕРПАН)
НЕИЗВЕСТНАЯ_ОШИБКА	200, 500, 503	500 ^{( 1 )} , 503	5xx ^{( 1 )}	2 (НЕИЗВЕСТНО)/13 (ВНУТРЕННИЙ) ^{( 1 )} , 14 (НЕТ В НАЛИЧИИ)
¹ Для повышения согласованности отчетов о кодах ошибок API платформы Google Карт переходят: 1) с кода/класса ответа HTTP `200` / `2xx` на `404` / `4xx` (и кода статуса GRPC с `0` ( `OK` ) на `5` ( `NOT_FOUND` )) для статусов API Карт: `DATA_NOT_AVAILABLE` , `NOT_FOUND` , `ZERO_RESULTS` - status , 2) с кода/класса ответа HTTP `200` / `2xx` , `400` / `4xx` на `403` / `4xx` (и кода статуса GRPC `7` ( `PERMISSION_DENIED` )) для статуса API Карт: `REQUEST_DENIED` , 3) с кода/класса ответа HTTP `200` / `2xx` , `403` / `4xx` на `401` / `4xx` (код статуса GRPC `16` ( `UNAUTHENTICATED` )) для Статус API Карт: `REQUEST_DENIED` , 4) от кода/класса ответа HTTP `200` / `2xx` , `403` / `4xx` до `429` / `4xx` для статусов API Карт: `OVER_QUERY_LIMIT` , `dailyLimitExceeded` , `rateLimitExceeded` , `userRateLimitExceeded` , 5) от кода/класса ответа HTTP `200` / `2xx` до `500` / `5xx` (и кода статуса GRPC `2` ( `UNKNOWN` ), `13` ( `INTERNAL` )) для статуса API Карт: `UNKNOWN_ERROR` . Вы можете видеть оба кода ответа в течение переходного периода. Коды ответов, возвращаемые в ответах API Карт, не меняются. Вы можете изучить разбивку кодов ответов, сообщаемых с течением времени, в Metrics Explorer .

Создать оповещения

Оповещения дают своевременное оповещение о проблемах в ваших приложениях, чтобы вы могли быстро решить проблемы. В Cloud Monitoring политика оповещения описывает обстоятельства, при которых вы хотите получать оповещения, и то, как вы хотите получать уведомления.

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

Сообщите мне, когда количество запросов для определенного API превысит 1000 запросов за 5-минутное окно.
Уведомить дежурную группу, если 90-й процентиль ответов HTTP 200 превысит задержку в 100 мс для 3 или более API.

На следующем изображении показано определение оповещения для генерации уведомления, когда количество запросов к API превышает 20 в течение 5-минутного окна:

Скриншот определения оповещения, показывающий количество запросов API для всех API Карт в виде отдельных линий, а порог оповещения — в виде горизонтальной линии.

На этом изображении:

На диаграмме показано количество вызовов API с течением времени для различных API.
Красная линия показывает порог оповещения. Вызовы API, превышающие этот порог в течение 5-минутного окна, вызывают оповещение. В этом примере вы можете видеть, что один API превысил лимит.

При выполнении условий политики оповещения Cloud Monitoring открывает инцидент и отправляет уведомления:

Инцидент — это постоянная запись, которая хранит информацию о контролируемых ресурсах, когда условие было выполнено. Когда условие перестает выполняться, инцидент автоматически закрывается. Вы можете просмотреть все инциденты, открытые и закрытые, с помощью панели оповещений.
Вы указываете, кто должен получать уведомления, когда настраиваете политику оповещения. Мониторинг поддерживает общие каналы уведомлений, включая электронную почту, Cloud Mobile App и такие сервисы, как PagerDuty или Slack. Полный список каналов уведомлений см. в разделе Параметры уведомлений .

Типы оповещений

Cloud Monitoring поддерживает множество типов оповещений. Например, вы можете определить:

Оповещения о пороговых значениях метрики : активируйте оповещение, если метрика поднимается выше или опускается ниже значения в течение определенного периода времени или метрика увеличивается или уменьшается на предопределенный процент.
Оповещения о бюджете : установите пороговые правила для запуска уведомлений, когда ваши расходы (фактические расходы или прогнозируемые расходы) превышают процент вашего бюджета (на основе установленных вами правил). Оповещение не ограничивает использование API, оно только оповещает вас, когда сумма ваших расходов приближается к указанной сумме.
Оповещения о квотах : Google Cloud устанавливает различные квоты, которые можно использовать для отслеживания и ограничения ресурсов, потребляемых проектом или организацией. Используйте оповещения для отправки уведомлений, когда ваше использование приближается к пределу квоты.

Более подробную информацию см. в разделе Типы политик оповещения .

Управление политиками оповещения

Вы можете добавить политику оповещения в свой проект с помощью консоли Cloud или API Cloud Monitoring. Для получения информации о том, как просмотреть список политик оповещения на основе метрик вашего проекта и как изменить эти политики, см. следующее:

Создать оповещение

При создании оповещения вы:

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

В примере ниже показано, как настроить оповещение, срабатывающее, когда уровень использования сервиса платформы Google Карт для любого API превышает 2 запроса за 5-минутное окно.

Чтобы создать оповещение, выполните следующие действия:

В консоли Cloud выберите Мониторинг :
Перейти к мониторингу
Выберите «Оповещение» .
Выберите Изменить канал уведомлений, чтобы определить, как оповещение выдает свое уведомление. В этом примере вы будете использовать свой адрес электронной почты.
1. Для канала электронной почты выберите Добавить новый .
2. Введите адрес электронной почты и отображаемое имя .
3. Выберите Сохранить .
Выберите «Оповещение» .
Выберите Создать политику .
Выберите временной интервал, например, 7 дней .
В разделе «Условия оповещения» выберите «Новое условие» :
1. Нажмите «Выбрать метрику» , выберите «Потребляемый API» в качестве ресурса и «Количество запросов» в качестве метрики, а затем нажмите «Применить» .
  Примечание: Если Request Count не отображается в списке метрик, выйдите и сделайте несколько запросов API. Вы не можете выбрать метрику, если для нее нет существующих данных.
2. (Необязательно) Под диаграммой находится список service , quota_metrics , API method и metric value . Выберите Add filter , чтобы отфильтровать данные на основе этой информации. Например, вы можете использовать фильтр, чтобы указать, что метод должен быть равен google.places.Autocomplete.http для срабатывания оповещения.
3. В разделе «Преобразование данных» выберите 5 мин для скользящего окна и среднее значение для функции скользящего окна .
4. Выберите Далее .
В разделе Настроить триггер оповещения установите значение Порог на 2, чтобы указать, что оповещение должно срабатывать, когда в 5-минутном окне больше 2 запросов. Обратите внимание, что теперь на диаграмме отображается красная линия, указывающая предел оповещения для выбранного временного интервала. На диаграмме вы можете увидеть, где могло бы сработать оповещение. Вы можете использовать эту диаграмму, чтобы настроить предел по мере необходимости.
Нажмите Далее .
На странице «Настройка уведомлений и завершение оповещения» :
1. Выберите адрес электронной почты, который вы создали для канала уведомлений .
2. В поле «Имя оповещения» введите «Мое тестовое оповещение» .
3. Выберите Создать политику .
Сделайте несколько запросов API. Убедитесь, что вы сделали более двух запросов API в течение пяти минут, чтобы сгенерировать оповещение по электронной почте.
Получив электронное письмо с оповещением, перейдите на страницу оповещений .
1. В таблице со списком оповещений нажмите на оповещение, чтобы просмотреть дополнительную информацию.
2. Щелкните название оповещения, чтобы просмотреть информацию о нем, включая диаграмму, показывающую событие, вызвавшее его.

Более подробную информацию о оповещениях см. здесь:

Настройте облачный мониторинг

Мониторинг позволяет просматривать и управлять показателями:

Для одного проекта
Для нескольких проектов в рамках одной организации
Для нескольких проектов в нескольких организациях

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

В консоли Google Cloud выберите Мониторинг :
Перейти к мониторингу
Убедитесь, что вы выбрали правильный проект.
В навигационной панели Monitoring нажмите > справа от Metrics Scope . На следующем снимке экрана показана страница, которая отображается при выборе проекта AllEnvironments:

Проект определения области действия : этот проект хранит проверки работоспособности, политики оповещения, группы и панели мониторинга, которые вы настраиваете. Между областью действия метрик и проектом определения области действия существует отношение 1:1. В этом примере проект AllEnvironments является проектом определения области действия.
Контролируемый проект : Метрики для проекта видны в текущей области метрик. Для этого примера проекты Staging и Production являются контролируемыми проектами.