현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
이 섹션에서는 API 모니터링과 에지 분석을 비교합니다. API 모니터링과 Edge 애널리틱스 모두 API 데이터를 수집하고 확인할 수 있지만 목표는 서로 다릅니다.
- API 모니터링의 목표는 API가 의도대로 실행되고 있는지 확인하는 것입니다. 이를 위해 사용 가능한 최신 데이터를 확인하는 것이 좋습니다. API Monitoring은 실시간에 가까운 데이터를 제공하며, 문제가 발생할 경우 이를 알려주는 알림을 만들 수 있습니다.
- Edge 애널리틱스의 목표는 API의 장기적인 동작을 파악하여 비즈니스 요구사항을 지원하는지 확인하거나 필요한 경우 변경할 수 있도록 하는 것입니다. 이러한 목적을 위해서는 실시간 데이터를 보는 것이 덜 중요합니다. 따라서 애널리틱스 데이터는 약간 지연되지만 일반적으로 최대 10분까지 지연됩니다.
API 모니터링 데이터는 대부분 오류 코드 및 지연 시간과 관련이 있으며, 애널리틱스 데이터의 작은 하위 집합입니다.
API 모니터링 데이터와 애널리틱스 데이터의 차이점
이 섹션에서는 Edge 애널리틱스와 API 모니터링에서 수집하는 데이터 간의 사소한 차이점을 설명합니다. API 모니터링과 애널리틱스는 서로 다른 데이터 파이프라인을 사용하므로 Monitoring에서 생성된 커스텀 보고서와 애널리틱스에서 생성된 보고서 사이에 약간의 차이가 있을 수 있습니다. 예를 들어 시간 제한 오류(요청의 HTTP 상태 코드 504)와 클라이언트 제한 시간 (HTTP 상태 코드 499) 모두 시간 초과 오류에 대해 보고된 결과에 불일치가 나타날 수 있습니다. 애널리틱스 맞춤 보고서에는 상태 코드 200으로 표시될 수 있지만 Monitoring 맞춤 보고서에는 상태 코드 504 또는 499로 표시됩니다.API 모니터링
API 모니터링은 API 성능에 대한 실시간 통계를 제공하고 문제를 빠르게 진단하고 수정하여 API가 의도한 대로 계속 작동하도록 도와줍니다.
API 모니터링을 사용하면 다음을 수행할 수 있습니다.
- API 가용성을 높이고 평균 진단 시간 (MTTD)을 단축할 수 있습니다.
- 소비자가 영향을 받기 전에 상황별 알림을 기반으로 적절한 조치를 취합니다.
- Apigee 결함 코드를 활용하여 진단 속도를 높이세요.
- 문제 영역을 신속하게 격리하여 오류, 성능, 지연 시간 문제와 그 원인을 진단합니다.
Edge API 분석
Edge API 애널리틱스는 API를 통해 전달되는 정보를 수집하고 분석합니다. API 애널리틱스는 다음과 같은 정보를 캡처합니다.
- 시간 경과에 따른 API 트래픽 추세
- 인기 앱
- 상위 개발자는 누구인가요?
- 가장 인기 있는 API 메서드
- API 응답 시간이 가장 빠른/가장 느린 시기
- 지리적으로 API 트래픽이 가장 많이 발생하는 곳
API 애널리틱스에서 수집하는 데이터
API 애널리틱스는 API 간에 전송되는 광범위한 데이터를 수집하고 분석합니다. 예를 들어 API가 배포되는 동안 애널리틱스에서는 수신된 메시지 수, 개발자 수, 응답 시간, 오류, 사용 중인 앱 수, 요청 크기, 기타 여러 데이터를 지속적으로 기록합니다.
측정항목에 대한 소개와 사용 방법에 대한 자세한 내용은 측정항목 API를 사용하여 API 프로그램 성능 측정을 참고하세요. 전체 측정항목 목록은 애널리틱스 측정항목, 측정기준 및 필터 참조를 확인하세요.
커스텀 측정항목 수집
StatisticsCollector 정책을 사용하여 커스텀 측정항목을 수집할 수도 있습니다. StatisticsCollector 정책은 분석 및 보고서 생성을 위해 요청 헤더, XML/JSON 페이로드, 쿼리 매개변수, URI, 기타 위치의 정보를 애널리틱스 서버에 쓸 수 있습니다.
애널리틱스 데이터에 액세스
생성된 후에는 대시보드, 맞춤 보고서, GeoMap 등 API 애널리틱스 시각화 도구를 사용하여 사전 정의된 측정항목과 맞춤 측정항목에 액세스할 수 있습니다. API 애널리틱스에서 제공하는 시각화 도구에 대한 자세한 내용은 애널리틱스 대시보드를 참고하세요. 맞춤 보고서에 대한 자세한 내용은 맞춤 보고서 만들기를 참고하세요.
API 모니터링과 API 분석 비교하기
API 개발자는 API 모니터링과 API 분석을 모두 사용합니다. 두 도구의 주요 차이점 중 하나는 API 모니터링에 내장된 알림 메커니즘입니다. 알림을 사용하면 운영팀이 API 관련 문제에 실시간으로 대응하여 API의 가용성과 성능을 예상할 수 있습니다.
알림 조건은 특정 상태 코드 (2xx/4xx/5xx), 지연 시간, 오류 코드 기준점을 정의합니다. 이를 초과하면 UI에서 시각적 알림을 트리거하고 이메일, Slack, Pagerduty, 웹훅 등 다양한 채널을 통해 알림을 전송합니다. 환경, API 프록시나 대상 서비스, 리전 수준에서 경고를 설정할 수 있습니다.
알림이 트리거되면 운영팀에서 API 모니터링 UI를 사용하여 문제를 조사하고 근본 원인을 파악할 수 있습니다. 그러면 다음과 같이 사전 정의된 알림 정보가 포함된 커스텀 보고서를 생성할 수 있습니다.
- 총 응답 시간
- 대상 응답 시간
- 프록시 오류
- 대상 오류
- 요청 UUID
- 기타
API 분석은 여러 팀에서 사용할 수 있도록 광범위한 데이터를 캡처하도록 설계되었습니다. 예를 들면 다음과 같습니다.
- 운영팀은 애널리틱스 데이터를 사용하여 트래픽이 많거나 적은 기간을 파악하여 변화하는 수요에 맞춰 서비스를 확장하거나 축소할 수 있습니다.
- 마케팅팀은 애널리틱스 데이터를 사용하여 개별 API, 앱, 고객 또는 기타 데이터로 식별된 고객 사용 패턴을 파악할 수 있습니다.
- 모든 팀이 요청에서 수집된 커스텀 데이터에 액세스하여 헤더 값, 쿼리 매개변수 또는 요청 페이로드와 같은 특정 정보를 추적할 수 있습니다.