디버그 뷰로 메시지 데이터 보기

이 페이지는 Apigee 및 Apigee Hybrid에 적용됩니다.

학습할 내용

이 튜토리얼에서는 다음 방법을 배웁니다.

응답 메시지의 헤더 및 본문 콘텐츠를 확인합니다.
오류 메시지를 참조합니다.

필요한 사항

시작하기 전에 개요 및 기본 요건의 단계를 완료해야 합니다.
프록시에 정책이 최소 한 개 이상 있음
명령줄에서 API 호출을 수행하기 위해 머신에 설치된 curl

메시지 데이터 보기

Apigee 프록시 편집기의 디버그 뷰를 사용하면 API 프록시 요청과 응답 흐름의 응답 시간과 같은 헤더, 변수, 객체, 기타 세부정보를 볼 수 있습니다. 또한 디버그 뷰를 사용하면 API 프록시에서 요청이나 응답을 처리하는 방식을 확인할 수 있습니다. 디버그 뷰에 대한 자세한 내용은 디버그 사용을 참조하세요.

이전 튜토리얼에서는 SpikeArrest 정책을 사용하여 요청 수를 제한했습니다. 이 페이지에서는 디버그 뷰를 사용하여 해당 비율이 초과될 때 어떻게 되는지 확인하는 방법을 설명합니다.

새 프록시 편집기

API 프록시의 개발 탭에서 Spike Arrest 정책의 <Rate>를 1pm으로 다시 수정한 다음 프록시를 저장합니다. 이렇게 하면 성공 및 실패(제한 초과)한 API 호출을 모두 확인할 수 있습니다.
API 프록시 편집기에서 디버그 탭을 클릭합니다.
디버그 세션 시작을 클릭합니다.

대화상자에서 다음을 수행합니다.

디버그 세션을 실행할 환경을 선택합니다.
(선택사항) 필터 드롭다운 목록에서 만들려는 디버그 세션의 모든 트랜잭션에 적용할 필터를 선택합니다. 기본값은 None (All transactions)이며 디버그 데이터의 모든 트랜잭션을 포함합니다.
필터 사용에 대한 자세한 내용은 디버그 세션에서 필터 사용을 참조하세요. 기본 제공 필터에 대한 자세한 내용은 사전 정의된 필터 사용을 참조하세요.
시작을 클릭합니다.

최소 200 응답 하나 이상과 429 응답 하나 이상이 왼쪽 창에 표시될 때까지 curl(또는 웹브라우저의 URL)을 여러 차례 사용하여 다시 API 프록시를 호출합니다.

참고: 비율 제한을 초과하는 기본 HTTP 상태 코드는 429 Too many requests입니다.
왼쪽 창에서 429 트랜잭션을 클릭합니다. 그러면 오른쪽 창에 트랜잭션의 Gantt 차트가 표시됩니다.

Spike Arrest 정책의 행이 있으며 여기에 오류 아이콘이 표시됩니다.
오류 라벨이 지정된 행을 클릭합니다. 그러면 차트 오른쪽에 오류 세부정보가 표시됩니다. 다음 그림에서는 오류 세부정보의 속성 섹션을 보여줍니다.

Gannt 차트 아래에 있는 뒤로 및 다음 버튼을 클릭하여 흐름에서 단계 사이를 이동하고 각 단계의 세부정보를 볼 수 있습니다.

전체 디버그 세션을 단일 문서로 다운로드하려면 세션 다운로드를 클릭합니다. 디버그 세션은 완료된 후 24시간 이내에 삭제되므로 해당 시간 이후에 세션을 보려면 미리 다운로드해야 합니다.

기본 프록시 편집기

API 프록시의 개발 탭에서 Spike Arrest 정책의 <Rate>를 1pm으로 다시 수정한 다음 프록시를 저장합니다. 이렇게 하면 성공 및 실패(제한 초과)한 API 호출을 모두 확인할 수 있습니다.
API 프록시 편집기에서 디버그 탭을 클릭합니다.
디버그 세션 시작에서 프록시가 배포된 환경을 선택합니다.
디버그 세션 시작을 클릭합니다.
디버그 트랜잭션 창에 200 응답과 429 응답이 각각 최소 하나 이상 표시될 때까지 curl(또는 웹브라우저의 URL)을 사용하여 API 프록시를 다시 호출합니다.
```
curl -v https://YOUR_ENV_GROUP_HOSTNAME/my-proxy
```
여기서 YOUR ENV_GROUP_HOSTNAME은 환경 그룹 호스트 이름입니다. 환경 그룹 호스트 이름 찾기를 참조하세요.

아래에는 200 응답 및 429 응답이 나와 있습니다.

참고: 비율 한도를 초과하는 기본 HTTP 상태 코드는 429 Too many requests입니다.
조직에서 사용하는 모든 Spike Arrest 정책의 상태 코드를 다르게 하려면(예: 500) 조직에서 속성을 설정해야 합니다. Cloud 고객이라면 Google Cloud Customer Care에 문의하여 해당 속성을 설정하세요.
왼쪽 트랜잭션 창에서 200 트랜잭션을 클릭합니다. 디버그 세부정보는 트랜잭션 맵의 기본 창에 로드되며 요청/응답 다이어그램이 표시됩니다. Spike Arrest 아이콘은 요청 흐름에 있습니다.
흐름 다이어그램에서 가장 오른쪽에 있는 응답의 원 아이콘을 클릭합니다(다음 다이어그램 참조).
단계 세부정보 창에는 흐름의 해당 시점에서 사용 가능한 데이터가 표시됩니다. 이 창을 스크롤하면 HTTP 응답 헤더와 본문 콘텐츠가 표시됩니다.
이제 디버그에서 오류를 살펴봅니다.
트랜잭션 창에서 429 트랜잭션을 클릭합니다. 기본 편집기 창에서 요청 항목만 있는 흐름 다이어그램을 볼 수 있습니다. 오류를 나타내는 빨간색 느낌표가 있는 Spike Arrest 아이콘도 포함됩니다.

Spike Arrest 아이콘 오른쪽에 있는 작은 튜브 모양의 오류 아이콘을 클릭하고 단계 세부정보 창에서 급증 저지 위반 세부정보를 확인합니다.

흐름 다이어그램에서 뒤로 버튼과 다음 버튼을 클릭하면 흐름에서 포인트 사이를 이동하고 디버그 세부정보를 볼 수 있습니다.

전체 디버그 세션을 단일 문서로 보려면 디버그 세션 다운로드를 클릭하여 다운로드합니다.

자세한 내용은 디버그 사용을 참조하세요.