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