Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
이 섹션에서는 API 모니터링과 Edge 애널리틱스를 비교합니다. API 모니터링과 Edge 애널리틱스 모두 API 데이터를 수집하고 볼 수 있지만 목표가 서로 다릅니다.
- API 모니터링의 목표는 API가 의도한 대로 작동하는지 확인하는 것입니다. 이를 위해서는 사용 가능한 최신 데이터를 확인해야 합니다. API 모니터링은 실시간에 매우 가까운 데이터를 제공하며 문제가 발생하면 알림을 보내는 알림을 만들 수 있습니다.
- Edge 애널리틱스의 목표는 API의 장기적 동작을 파악하여 API가 비즈니스 요구사항을 지원하는지 확인하거나 필요한 경우 변경할 수 있도록 하는 것입니다. 이러한 목적을 위해서는 실시간 데이터를 보는 것이 그다지 중요하지 않습니다. 따라서 애널리틱스 데이터는 일반적으로 최대 10분 정도 지연됩니다.
API 모니터링 데이터는 주로 오류 코드 및 지연 시간과 관련이 있으며 애널리틱스 데이터의 일부 하위 집합입니다.
API 모니터링 데이터와 애널리틱스 데이터의 차이
이 섹션에서는 Edge 애널리틱스와 API 모니터링에서 수집한 데이터 간의 몇 가지 사소한 차이점을 설명합니다. API 모니터링과 애널리틱스는 서로 다른 데이터 파이프라인을 사용하므로 모니터링에서 생성된 맞춤 보고서와 애널리틱스에서 생성된 보고서 간에 약간의 차이가 있을 수 있습니다. 예를 들어 제한 시간 오류에 대해 보고된 결과(백엔드 제한 시간(요청의 HTTP 상태 코드 504) 및 클라이언트 제한 시간(HTTP 상태 코드 499))에 불일치가 있을 수 있습니다. 이러한 요청은 애널리틱스 맞춤 보고서에는 상태 코드 200으로 표시될 수 있지만 모니터링 맞춤 보고서에는 상태 코드 504 또는 499로 표시됩니다.API 모니터링
API 모니터링은 API 성능에 대한 실시간 통계를 제공하고, API가 의도한 대로 작동하도록 문제를 신속하게 진단하고 수정하는 데 도움을 줍니다.
API 모니터링을 사용하면 다음을 수행할 수 있습니다.
- API 가용성을 높이고 평균 진단 시간 (MTTD)을 단축합니다.
- 소비자가 영향을 받기 전에 상황별 알림을 기반으로 적절한 조치를 취합니다.
- Apigee 오류 코드를 활용하여 진단 속도를 높입니다.
- 문제 영역을 빠르게 격리하여 오류, 성능, 지연 시간 문제, 소스를 진단합니다.
Edge API 분석
Edge API 분석은 API를 통해 전달되는 정보를 수집하고 분석합니다. API 분석은 다음과 같은 정보를 캡처합니다.
- 시간 경과에 따른 API 트래픽 추세
- 인기 앱
- 최고의 개발자는 누구인가요?
- 가장 인기 있는 API 메서드
- API 응답 시간이 가장 빠르고 가장 느린 시점
- API 트래픽이 가장 많은 지역은 어디인가요?
API 분석에서 수집하는 데이터
API 분석은 API 전반의 다양한 데이터를 수집하고 분석합니다. 예를 들어 API가 배포되는 동안 애널리틱스에서는 수신된 메시지 수, 개발자 수, 응답 시간, 오류, 사용 중인 앱 수, 요청 크기, 기타 여러 데이터를 지속적으로 기록합니다.
측정항목 및 측정항목 사용 방법에 관한 자세한 내용은 Metrics 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, 앱, 고객 또는 기타 데이터로 식별된 고객 사용 패턴을 파악할 수 있습니다.
- 모든 팀은 요청에서 수집된 맞춤 데이터에 액세스하여 헤더 값, 쿼리 매개변수, 요청 페이로드와 같은 특정 정보를 추적할 수 있습니다.