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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

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

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

  1. В Google Cloud Console выберите Мониторинг :

    Перейти к мониторингу

  2. Убедитесь, что вы выбрали правильный проект.
  3. На панели навигации «Мониторинг» нажмите > справа от « Область показателей ». На следующем снимке экрана показана страница, которая отображается при выборе проекта AllEnvironments:

    Скриншот отслеживаемых показателей проекта. Перечислен каждый проект вместе с его идентификатором проекта и ролью.

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

  • Scoping project : в этом проекте хранятся проверки работоспособности, политики предупреждений, группы и панели мониторинга, которые вы настраиваете. Существует отношение 1:1 между областью действия метрик и проектом определения области действия. В этом примере проект AllEnvironments является проектом определения области.
  • Отслеживаемый проект : метрики проекта видны в текущей области метрик. В этом примере проекты Staging и Production являются отслеживаемыми проектами.

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

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

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

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

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

Снимок экрана с данными показателей квот для всех API Карт. Он показывает гистограмму, где каждый сегмент hte bar соответствует другому API.

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

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

  • Поля « Тип ресурса » и « Метрика » слева от диаграммы определяют данные метрики, отображаемые на диаграмме.
  • Раскрывающийся список типа диаграммы над диаграммой позволяет выбрать тип диаграммы. В этом примере установлено значение Столбчатая диаграмма с накоплением.
  • Временной интервал над графиком установлен на 1W (одна неделя).
  • Под диаграммой находится список сервисов , quota_metrics , методов API и значений метрик, которые определяют данные диаграммы. Выберите « Добавить фильтр» , чтобы использовать эту информацию для уточнения отображаемых данных.

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

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

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

  1. В облачной консоли выберите Мониторинг :

    Перейти к мониторингу

  2. В области навигации выберите Обозреватель метрик .
  3. На панели инструментов выберите Линейчатая диаграмма с накоплением в раскрывающемся списке типов диаграмм, чтобы просмотреть данные метрик в виде гистограммы.
  4. Выберите временной интервал, например 1W (одна неделя).
  5. Укажите данные, которые будут отображаться на диаграмме. Чтобы использовать интерфейс на основе меню или ввести фильтр, выберите вкладку Конфигурация . Чтобы использовать язык запросов мониторинга (MQL), выберите вкладку MQL .
    1. Чтобы составить график использования квоты, выберите « Потребительская квота» в качестве типа ресурса . В качестве альтернативы, если вы хотите создать диаграмму использования API, выберите « Используемый API » или «API Google Maps » (дополнительную информацию о показателях использования, доступных для API платформы Google Maps, см. в разделе «Показатели использования»). Наведите курсор на каждый тип ресурса, чтобы увидеть его описание.
    2. В качестве метрики выберите Оценить использование квоты . Диаграмма автоматически обновляется для отображения метрических данных. Обратите внимание, что существуют и другие параметры квоты для метрики. Наведите курсор на каждую метрику, чтобы увидеть описание. Дополнительные сведения о полях обозревателя метрик см. в разделах Выбор метрик и Выбор способа отображения данных диаграммы .
  6. (Необязательно) Используйте следующие параметры для уточнения отображения:
    1. Чтобы указать подмножество данных для отображения, добавьте фильтры . Чтобы добавить фильтр, выберите Добавить фильтр и заполните диалоговое окно. Дополнительные сведения см. в разделе Фильтрация данных диаграммы . Например, чтобы просмотреть данные для одного API:
      1. В поле Метка выберите метод .
      2. В поле Сравнение выберите = (равно) .
      3. В поле Значение выберите имя конкретного метода. Вам будет предложено выбрать имя метода с данными для отображения.
      4. Выберите Готово , чтобы обновить диаграмму.
    2. Чтобы сгруппировать временные ряды по метке, используйте поле « Группировать по» . Выбор значения для этого поля автоматически выбирает значение для поля Агрегатор .
    3. Чтобы указать, как объединять временные ряды, задайте поле Агрегатор . Например, если поле « Группировать по» пусто, а в поле « Агрегатор » указано среднее значение, на диаграмме отображается среднее значение временного ряда.
    4. Чтобы настроить обработку отдельных временных рядов, выберите Дополнительные параметры . Дополнительную информацию см. в разделе Выбор метрик при использовании обозревателя метрик .
  7. При желании добавьте на панель инструментов.

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

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

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

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

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

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

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

Панели мониторинга позволяют просматривать и отслеживать данные временных рядов в виде набора диаграмм. Облачный мониторинг поддерживает предопределенные информационные панели и настраиваемые информационные панели:

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

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

  • Таблица квот слева
  • Диаграмма количества API справа

Скриншот настраиваемой информационной панели с двумя диаграммами. Диаграмма слева — это диаграмма квот, а диаграмма справа — диаграмма использования API. На обеих диаграммах точки времени указаны на их горизонтальной оси.

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

Если вы решите управлять настраиваемыми информационными панелями с помощью Cloud Monitoring API , обозреватель показателей предоставит вам две полезные утилиты:

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

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

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

  1. В облачной консоли выберите Мониторинг :

    Перейти к мониторингу

  2. В области навигации выберите Панели мониторинга .
  3. На странице «Обзор сводных панелей» нажмите « Создать сводную панель » .
  4. Для каждой диаграммы, которую вы хотите добавить на панель мониторинга, выполните следующие действия:
    1. Выберите тип диаграммы из Добавить диаграмму или перетащите ее из библиотеки в область диаграммы.

      Отображается предварительно сконфигурированная диаграмма выбранного типа. В следующем примере показана линейная диаграмма и панель ее конфигурации:

      Скриншот обозревателя метрик, который вы используете для создания диаграммы для добавления на панель мониторинга.

    2. Выберите Тип ресурса и Метрику и примените любые фильтры так же, как вы делали выше при создании диаграммы.

      Дополнительные сведения о доступных вариантах см. в разделе Добавление виджетов панели мониторинга .

  5. (Необязательно) На панели инструментов панели инструментов нажмите « Добавить диаграмму» , чтобы добавить другую диаграмму, а затем повторите предыдущие шаги, чтобы настроить диаграмму.
  6. Когда вы закончите редактирование, щелкните стрелку влево, чтобы покинуть панель мониторинга, или выберите любой другой пункт меню « Мониторинг ». Ваша панель управления сохраняется автоматически.

Просмотр панели мониторинга

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

  1. В облачной консоли выберите Мониторинг :

    Перейти к мониторингу

  2. В области навигации выберите Панели мониторинга .
  3. Выберите свою настраиваемую панель мониторинга или предопределенную панель мониторинга из списка.

Для получения дополнительной информации о создании панелей мониторинга см.:

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

Для мониторинга использования API платформы Google Maps доступны две группы показателей: показатели времени выполнения службы (тип ресурса entity_api ) , доступные для большинства метрик Google Cloud API и платформы Google Maps , конкретные показатели API платформы Google Maps (тип ресурса maps.googleapis.com /Апи ).

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

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

В метрике «Счетчик запросов » вы можете разделить трафик использования по меткам protocol , grpc_status_code , response_code и response_code_class . Кроме того, вы можете разделить показатели platform_type Google Maps по типу платформы.

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

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

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

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

Коды ответов, возвращаемые в ответах API Коды ответов, переданные в мониторинг
Статус API Карт Код HTTP-ответа Код HTTP-ответа Класс кода ответа HTTP Код состояния GRPC
ХОРОШО 200,
204,
302
200,
204,
302
2хх,
3хх
0 (ОК)
ДАННЫЕ_НЕДОСТУПНЫ,
НЕ НАЙДЕН,
ZERO_RESULTS
200 200/404 ( 1 ) 2хх/4хх ( 1 ) 0 (ОК),
5 (НЕ НАЙДЕНО) ( 1 )
NOT_FOUND (Street View Static, API геолокации и дорог),
ZERO_RESULTS (статический API Просмотра улиц)
404 404 4хх 5 (НЕ НАЙДЕНО)
INVALID_REQUEST (недопустимое значение параметра),
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
и т.п.
200/400 400 4хх 3 (INVALID_ARGUMENT)
INVALID_REQUEST (неверный/отсутствующий параметр, ошибка синтаксического анализа запроса) 200/400 400 4хх 3 (INVALID_ARGUMENT)
ЗАПРОС ОТКЛОНЕН 200/403 403 4хх 7 (РАЗРЕШЕНИЕ_ОТКАЗАНО)
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
дневной лимитпревышен,
ограничение скорости превышено,
userRateLimitExceeded
200/403,
429
403,
429
4хх 7 (РАЗРЕШЕНИЕ_ОТКАЗАНО),
8 (RESOURCE_EXHAUSTED)
НЕИЗВЕСТНАЯ ОШИБКА 200/500,
503
500,
503
5хх 2 (НЕИЗВЕСТНО)
1 Чтобы повысить согласованность отчетов о кодах ошибок, API-интерфейсы платформы Google Maps мигрируют ( статус ) с кода/класса ответа HTTP > 200 / 2xx на 404 / 4xx (и код состояния GRPC с 0 ( OK ) на 5 ( NOT_FOUND )) для Статусы API Карт: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS . Вы можете увидеть оба кода ответа в течение переходного периода. Коды ответов, возвращаемые в ответах Maps API, не меняются. Вы можете изучить разбивку кодов ответов, сообщаемых с течением времени, в обозревателе метрик .

Создание оповещений

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

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

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

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

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

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

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

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

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

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

Облачный мониторинг поддерживает множество типов предупреждений. Например, вы можете определить:

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

Дополнительные сведения см. в разделе Типы политик предупреждений .

Управление политиками предупреждений

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

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

Когда вы создаете оповещение, вы:

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

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

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

  1. В облачной консоли выберите Мониторинг :

    Перейти к мониторингу

  2. Выберите Оповещение .
  3. Выберите «Редактировать канал уведомлений» , чтобы определить, как оповещение выдает свое уведомление. В этом примере вы будете использовать свой адрес электронной почты.
    1. Для канала электронной почты выберите Добавить новый .
    2. Введите адрес электронной почты и отображаемое имя .
    3. Выберите Сохранить .
  4. Выберите Оповещение .
  5. Выберите Создать политику .
  6. Выберите временной интервал, например 7 дней .
  7. В разделе «Условия оповещения » выберите « Новое условие »:
    1. Нажмите «Выбрать метрику » и выберите « Потребляемый API » в качестве ресурса и « Количество запросов » в качестве метрики, а затем нажмите « Применить» .
    2. (Необязательно) Под диаграммой находится список услуг , quota_metrics , метод API и значение метрики . Выберите Добавить фильтр , чтобы отфильтровать данные на основе этой информации. Например, вы можете использовать фильтр, чтобы указать, что метод должен быть равен google.places.Autocomplete.http для запуска предупреждения.
    3. В разделе «Преобразовать данные» выберите 5 минут для функции « Прокручивающееся окно » и среднее значение для функции « Прокручивающееся окно» .
    4. Выберите Далее .
  8. В разделе Настройка триггера оповещения установите для порогового значения значение 2, чтобы указать, что оповещение должно запускаться при наличии более 2 запросов в 5-минутном окне. Обратите внимание, что на диаграмме теперь отображается красная линия, указывающая предел предупреждений для выбранного временного интервала. На графике видно, где могло сработать оповещение. Вы можете использовать эту диаграмму, чтобы помочь вам настроить лимит по мере необходимости.
  9. Нажмите «Далее» .
  10. На странице Настройка уведомлений и завершение оповещения :
    1. Выберите адрес электронной почты, который вы создали для канала уведомлений .
    2. В разделе Имя оповещения введите My Test Alert .
    3. Выберите Создать политику .
  11. Сделайте несколько запросов к API. Убедитесь, что вы делаете более двух запросов API в течение пяти минут, чтобы создать оповещение по электронной почте.
  12. После того, как вы получите электронное письмо с предупреждением, перейдите на страницу предупреждений .
    1. В таблице со списком предупреждений щелкните предупреждение, чтобы просмотреть дополнительную информацию.
    2. Щелкните имя предупреждения, чтобы просмотреть информацию о предупреждении, включая диаграмму, показывающую событие, вызвавшее его.

Для получения дополнительной информации об оповещениях см.: