34장. API에 대한 3scale 응답 코드 로그 설정 및 평가

클라이언트가 API를 사용하는 방법을 확인하고 서버가 예상대로 실행되는지 실시간으로 확인하려면 3scale에서 응답 코드를 설정하고 사용합니다.

절차

  • Docker 또는 OpenShift 배포를 사용하는 APIcast 게이트웨이를 시작할 때 APICAST_RESPONSE_CODES 환경 변수를 1 또는 true 로 설정합니다. 이렇게 하면 응답 코드 추적이 가능합니다.

예제

활성화된 경우 APIcast 게이트웨이는 업스트림 서비스에서 반환한 API 응답의 HTTP 상태 코드를 캡처하여 인증된 호출을 위해 전송하고 서비스 관리 API( authrep 호출)로 전송합니다. 예제:

https://su1.3scale.net/transactions/authrep.xml?service_token={SERVICE_TOKEN}&service_id={SERVICE_ID}&user_key={USER_KEY}&usage%5Bhits%5D=1&log%5Bcode%5D=200"

이 예에서는log[code]=200 이 전송되므로 API에서 200 상태 코드로 응답했습니다.

검증

통합을 확인하려면 유효한 3scale 자격 증명을 사용하여 API 제품에 대한 호출을 수행한 다음 분석 > 사용 페이지에서 호출이 올바르게 보고되었는지 확인합니다.

참고
  • 응답 코드 추적은 모든 응답의 정확한 수를 나타내는 것은 아닙니다.
  • 이 뷰의 값은 기간 동안 추세를 시각적으로 표시하는 것입니다.
  • 응답 코드 추적 및 3scale 인증 캐싱 모드: 지원되지 않는 조합은 없습니다.
사용 화면

모든 것이 제대로 진행되면 Analytics >Response 코드 페이지로 이동합니다. 응답이 2xx, 4xx 또는 5x인지 여부에 따라 최신 트래픽이 색상으로 구분된 그래프를 볼 수 있습니다.

응답 코드 화면

그래프 도구를 사용하면 응답 코드 기록을 볼 수 있습니다. 또한 응답 코드 통계를 다양한 기간과 세분성 수준으로 확인할 수 있습니다. 시간 선택 표시줄을 클릭하고 요구 사항을 충족하는 시간 및 세분화를 정의합니다.