Вы просматриваете документацию Apigee Edge .
Перейдите в документацию Apigee X.info
В этом разделе сравниваются мониторинг API и аналитика на периферии сети . Хотя и мониторинг API, и аналитика на периферии сети позволяют собирать и просматривать данные API, у них разные цели:
- Цель мониторинга API — обеспечить корректную работу ваших API. Для этого вам необходимы самые актуальные доступные данные. Мониторинг API предоставляет данные, максимально приближенные к реальному времени, и позволяет создавать оповещения, которые уведомят вас в случае возникновения проблемы.
- Цель Edge Analytics — понять долгосрочное поведение ваших API, чтобы вы могли убедиться, что они соответствуют вашим бизнес-требованиям, или внести необходимые изменения. Для этих целей данные в реальном времени менее критичны. Следовательно, данные аналитики поступают с небольшой задержкой, обычно не более 10 минут.
Обратите внимание, что данные мониторинга API, которые в основном связаны с кодами ошибок и задержкой, представляют собой небольшую часть аналитических данных.
Различия между данными мониторинга API и аналитическими данными.
В этом разделе описаны некоторые незначительные различия между данными, собираемыми с помощью Edge Analytics и API Monitoring. Поскольку мониторинг API и аналитика используют разные конвейеры обработки данных, вы можете заметить незначительные различия между пользовательскими отчетами, созданными мониторингом, и отчетами, созданными аналитикой. Например, вы можете увидеть расхождения в результатах по ошибкам таймаута — как по таймаутам бэкэнда (код состояния HTTP 504 для запроса), так и по таймаутам клиента (код состояния HTTP 499). В пользовательских отчетах аналитики они могут отображаться с кодом состояния 200, а в пользовательских отчетах мониторинга — с кодом состояния 504 или 499.Мониторинг API
Мониторинг API предоставляет информацию о производительности API в режиме реального времени и помогает быстро диагностировать и устранять проблемы, чтобы ваши API работали должным образом.
Мониторинг API позволяет вам:
- Повысить доступность API и сократить среднее время до постановки диагноза (MTTD).
- Принимайте соответствующие меры на основе контекстных оповещений до того, как это повлияет на потребителей.
- Используйте коды ошибок Apigee для ускорения диагностики.
- Быстро выявляйте проблемные области, чтобы диагностировать ошибки, проблемы с производительностью и задержкой, а также определить их источник.
Аналитика API Edge
Edge API Analytics собирает и анализирует информацию, передаваемую через API. API Analytics фиксирует такую информацию, как:
- Динамика трафика вашего API с течением времени.
- Какие приложения вы считаете лучшими?
- Кто ваши лучшие разработчики?
- Какие методы API наиболее популярны?
- Когда время ответа API является самым быстрым/самым медленным?
- В каком географическом плане вы наблюдаете наибольший трафик API?
Данные, собранные с помощью API Analytics.
API Analytics собирает и анализирует широкий спектр данных, передаваемых между API. Например, во время развертывания вашего API Analytics постоянно записывает количество полученных сообщений, количество разработчиков, время ответа, ошибки, количество используемых приложений, размер запроса и многие другие данные.
Для ознакомления с метриками и способами их использования см. раздел «Использование API метрик для измерения производительности программ API» . Полный список метрик см. в справочнике по метрикам, измерениям и фильтрам в Analytics .
Собирайте пользовательские метрики
Вы также можете собирать пользовательские метрики с помощью политики StatisticsCollector . Политика StatisticsCollector может записывать информацию из заголовков запросов, XML/JSON-данных, параметров запросов, URI и других источников на сервер аналитики для анализа и создания отчетов.
Доступ к данным аналитики
После создания вы можете получить доступ к предопределенным и пользовательским метрикам, используя инструменты визуализации API Analytics, включая панель мониторинга, пользовательские отчеты и геокарту. Дополнительную информацию об инструментах визуализации, предоставляемых API Analytics, см. в разделе « Панели мониторинга Analytics» . Дополнительную информацию о пользовательских отчетах см. в разделе «Создание пользовательских отчетов» .
Сравните мониторинг API и аналитику API.
Разработчики API используют как мониторинг API, так и аналитику API. Одно из основных различий между ними заключается в механизме оповещений, встроенном в мониторинг API. Оповещения позволяют вашей операционной команде реагировать на проблемы с вашими API в режиме реального времени, чтобы гарантировать доступность и корректную работу ваших API.
Условия оповещения определяют конкретные пороговые значения кода состояния (2xx/4xx/5xx), задержки и кода ошибки, при превышении которых запускаются визуальные оповещения в пользовательском интерфейсе и отправляются уведомления по различным каналам, таким как электронная почта, Slack, PageRduty или веб-хуки. Вы можете настроить оповещения на уровне среды, API-прокси, целевого сервиса или региона.
После срабатывания оповещения ваша операционная группа может использовать пользовательский интерфейс мониторинга API для расследования проблемы и выявления ее первопричины. Затем вы можете сгенерировать пользовательский отчет, включающий предопределенную информацию об оповещении, например:
- Общее время ответа
- Целевое время отклика
- Ошибки прокси
- Целевые ошибки
- Запрос UUID
- гораздо больше
API-аналитика предназначена для сбора широкого спектра данных, которые могут быть использованы различными командами. Например:
- Операционная группа может использовать данные аналитики для выявления периодов высокой или низкой нагрузки, чтобы масштабировать ваши сервисы в соответствии с меняющимися потребностями.
- Маркетинговая команда может использовать данные аналитики для определения моделей использования сервиса клиентами, выявленных на основе отдельных API, приложений, данных о клиентах или других данных.
- Все команды могут получить доступ к пользовательским данным, собранным из запроса, для отслеживания конкретной информации, такой как значения заголовков, параметры запроса или полезная нагрузка запроса.