현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동 정보
최근 대시보드에서는 조직에서 모든 API 프록시 및 대상 서비스의 마지막 1시간 동안의 최근 API 트래픽을 모니터링할 수 있습니다. API 모니터링 데이터는 세부 목록 또는 히트맵으로 표시될 수 있습니다. 다음 섹션에서 각 보기를 확인합니다.
목록 보기 사용
목록 보기에는 조직에서 최근에 트래픽이 발생한 API 프록시 및 대상 서비스에 대한 요약 정보가 표시됩니다.
목록 보기 탐색
목록 보기를 표시하려면 Edge UI에서 분석 > API 모니터링 > 최근을 선택합니다.
목록 보기는 기본적으로 표시됩니다. 최근 대시보드에서 언제든 을 클릭하여 목록 보기로 돌아갈 수 있습니다.
그림에 표시된 것처럼 목록 보기를 사용하면 다음을 수행할 수 있습니다.
- 조직에서 최근 1시간 동안 트랜잭션이 발생한 모든 API 프록시 및 대상 서비스에 대한 요약 정보를 확인합니다. API 프록시 및 대상 서비스가 리전 및 환경별로 나열됩니다. (더 다양한 기록 보기는 API 모니터링 데이터에서 추세 확인을 참조하세요.)
- 경고가 있는 API 프록시 및 대상 서비스를 빠르게 확인합니다. (경고 설정에 대한 자세한 내용은 경고 및 알림 설정을 참조하세요.)
- 목록에서 API 프록시 또는 대상 서비스 이름을 클릭하여 오른쪽 창에 세부 데이터를 표시합니다.
현재 컨텍스트를 사용하여 다음 작업을 빠르게 수행합니다(현재 선택된 컨텍스트에 적용할 수 없는 경우 옵션이 회색으로 표시됨).
- 커스텀 보고서를 만들고 측정기준을 추가합니다. 을 클릭합니다.
- 경고를 만들고 경고 조건을 추가하고, 알림을 설정하고, 경고를 기준으로 커스텀 보고서를 생성합니다.
- 타임라인 또는 조사 대시보드에서 현재 컨텍스트를 확인합니다. 각각 > 타임라인에서 보기 또는 조사에서 보기를 클릭합니다.
이름 또는 URL(예: https://acme.com/api)로 목록 보기를 검색합니다. 검색 상자에 관련 문자열을 전체 또는 일부 입력합니다. 프록시, 대상, 리전 필드로 콘텐츠를 검색할 수 있습니다.
참고: 경고만 필터를 선택한 경우 경고가 있는 API 프록시 또는 대상 서비스가 검색 결과에 나열됩니다.
필요에 따라 페이지의 자동 새로고침을 사용 또는 사용 안함으로 설정합니다.
목록에서 대상 서비스 세부정보를 표시하고 숨깁니다.
알림이 있는 API 프록시 및 대상 서비스 식별
목록 보기를 볼 때 빨간색 경고 아이콘 과 빨간색 왼쪽 테두리 선은 경고가 포함된 API 프록시와 대상 서비스를 나타냅니다.
경고가 있는 API 프록시 또는 서비스 대상만 표시하려면 알림만을 클릭합니다.
4xx 및 5xx 오류 번호에 대한 한 눈에 보기 요약 정보와 전체 오류율을 보려면 테이블의 숫자 값 위로 마우스 포인터를 이동합니다.
API 프록시 또는 대상 서비스에 대한 자세한 데이터 보기
API 프록시 또는 대상 서비스의 세부 데이터를 보려면 목록 보기에서 해당 이름을 클릭합니다. 세부 데이터가 오른쪽 창에 표시됩니다.
자세한 내용을 보려면 다음 탭을 클릭합니다.
또한 현재 컨텍스트를 사용하여 다음 작업을 빠르게 수행할 수 있습니다.
참고: 현재 선택된 컨텍스트에 적용할 수 없는 경우 옵션이 회색으로 표시됩니다.
- 커스텀 보고서를 만들고 측정기준을 추가합니다. 을 클릭합니다.
- 경고를 만들고 경고 조건을 추가하고, 알림을 설정하고, 경고를 기준으로 커스텀 보고서를 생성합니다. > 경고 만들기를 클릭합니다.
- 타임라인 또는 조사 대시보드에서 현재 컨텍스트를 확인합니다. 각각 > 타임라인에서 보기 또는 조사에서 보기를 클릭합니다.
세부정보
세부정보 탭에서는 지정된 타임라인 (이전 그림에 표시됨)의 교통정보에 대한 빠른 보기를 제공합니다. 예를 들면 다음과 같습니다.
세부정보 | 설명 |
전체 트래픽 | 총 거래 횟수입니다. |
총 오류 수 | 총 오류 수입니다. |
총 오류율 | 오류를 유발한 트래픽의 비율입니다 (총 오류 수/총 트래픽).
참고: API 모니터링은 이 백분율을 사용자가 설정한 경고 조건과 비교합니다. 총 오류율이 임곗값을 초과하면 경고 표시기가 UI에 표시됩니다. |
평균 TPS | 초당 평균 트랜잭션입니다. |
총 지연 시간 (P99) | 5분 이상 연속으로 계산된 99번째 백분위수의 총 응답 지연 시간 값입니다. 참고: API 프록시에 대해서만 표시됩니다. |
목표 지연 시간 (P99) | 5분 이상 연속으로 계산된 99번째 백분위수의 대상 응답 지연 시간 값입니다. 참고: API 프록시에 대해서만 표시됩니다. |
오류 소스 | 발생한 API 프록시 번들 오류 (4xx 및 5xx)의 분석 및 총 비율입니다. |
트렌드
트렌드 탭은 선택된 구성요소에 대해 다음 그래프를 표시합니다.
- 4xx 및 5xx 오류의 오류율
- 트래픽(TPS)
- 총 지연 시간(밀리초)
모든 대상 지연 시간
그래프에서 각자 다른 지점 위로 마우스를 가져가면 각 지점에서 한 눈에 보기 오류 백분율, 총 트래픽 수, 지연 시간을 표시할 수 있습니다.
로그
로그 탭에서 4xx, 5xx, 모든 오류로 필터링하고 API 프록시, 대상 서비스(사용자 서비스), Apigee(Apigee 인프라)에 따라 오류 소스 범위를 좁힐 수 있습니다.
오류를 클릭하여 로그 대화상자를 열고 목록에서 세부정보를 확장합니다.
히트맵 사용
히트맵은 경고가 포함된 환경을 식별할 수 있도록 색상 블록 보기를 제공합니다.
- 녹색은 경고 조건 임곗값이 초과되지 않았음을 나타냅니다.
- 빨간색은 경고 조건 임곗값이 초과되었고 경고가 트리거되었음을 나타냅니다.
히트맵 탐색
최근 페이지에서 을 클릭하여 다음 그림에 표시된 것처럼 히트맵을 표시합니다.
이전 그림에 표시된 것처럼 히트맵을 사용하면 다음을 수행할 수 있습니다.
- 경고가 있는 API 프록시 및 대상 서비스를 빠르게 확인합니다. (경고 설정에 대한 자세한 내용은 경고 및 알림 설정을 참조하세요.)
- 드롭다운 목록에서 구성요소를 선택하여 디스플레이를 필터링하거나 상자를 더블클릭해서 추가로 드릴다운합니다. 프록시 및 대상 드롭다운 목록에서 컬렉션을 사용하여 필터링할 수 있습니다. 예:
- 히트맵에서 블록을 클릭하여 오른쪽 창에 세부 데이터를 표시합니다.
현재 컨텍스트를 사용하여 다음 작업을 빠르게 수행합니다(현재 선택된 컨텍스트에 적용할 수 없는 경우 옵션이 회색으로 표시됨).
- 커스텀 보고서를 만들고 측정기준을 추가합니다. 을 클릭합니다.
- 경고를 만들고 경고 조건을 추가하고, 알림을 설정하고, 경고를 기준으로 커스텀 보고서를 생성합니다. > 경고 만들기를 클릭합니다.
- 타임라인 또는 조사 대시보드에서 현재 컨텍스트를 확인합니다. 각각 > 타임라인에서 보기 또는 조사에서 보기를 클릭합니다.
확장 기준을 로그 또는 선형으로 설정하여 히트맵 표시 배율을 설정합니다. 선형은 전체 트래픽 비율에 따라 상자 크기를 조정합니다. 예를 들어 200개 호출이 포함된 프록시는 100개 호출이 포함된 프록시보다 크기가 2배입니다.
검색 상자에 관련 문자열을 전체 또는 일부 입력하여 히트맵을 검색합니다. 현재 표시된 내용에 따라 리전, 환경, 프록시, 대상 맵에서 콘텐츠를 검색할 수 있습니다.
참고: 경고만 필터를 선택한 경우 경고가 있는 API 프록시 또는 대상 서비스가 검색 결과에 나열됩니다.
필요에 따라 페이지의 자동 새로고침을 사용 또는 사용 안함으로 설정합니다.
알림이 있는 API 프록시 및 대상 서비스 식별
히트맵을 볼 때 red 블록은 환경, API 프록시, 대상 서비스에 경고가 포함되었음을 나타냅니다. 경고 설정에 대한 자세한 내용은 경고 및 알림 설정을 참조하세요.
예를 들어 다음 그림은 두 가지 환경을 보여줍니다.
- test 환경은 해당 트래픽 오류 백분율이 지정된 타임라인에 설정된 경고 조건 임곗값을 초과했기 때문에 red입니다.
- prod 환경은 해당 트래픽 오류 백분율이 지정된 타임라인의 경고 조건 임곗값을 초과하지 않았기 때문에 녹색입니다.
드롭다운 목록에서 구성요소를 선택하여 화면을 필터링합니다. 또는 상자를 더블클릭하여 환경 맵에서 API 프록시 맵으로 드릴다운하고, API 프록시 맵에서 해당 API 프록시의 서비스 대상 맵으로 드릴다운하여 경고가 포함된 API 프록시와 대상 서비스를 확인합니다.
환경 >> | 프록시 >> | 타겟 |
현재 선택된 항목에 따라 경고가 있는 환경, API 프록시, 서비스 대상만 표시하려면 경고만을 클릭합니다.
이전 수준으로 돌아가려면 을 클릭합니다.
환경, API 프록시 또는 대상 서비스에 대한 자세한 데이터 보기
환경, API 프록시, 대상 서비스의 세부 데이터를 보려면 히트맵에서 해당 상자를 클릭합니다. 세부 데이터가 오른쪽 창에 표시됩니다.
목록 보기에 제공된 것과 동일한 정보가 탭에 제공됩니다. 자세한 내용은 다음을 참고하세요.
맵에서 상자를 클릭해도 이전 1시간 동안의 호출 수 및 오류율에 대한 한 눈에 보기가 표시됩니다.
최근 대시보드에서 커스텀 보고서 만들기
선택한 조건 집합을 기준으로 커스텀 보고서를 만듭니다. 생성 후 필요에 따라 커스텀 보고서를 편집하여 측정항목 및 측정기준을 추가하거나 삭제할 수 있습니다. 예를 들어 조사 범위를 특정 액세스 토큰, 개발자 앱, API 프록시로 좁힐 수 있습니다. 자세한 내용은 애널리틱스 측정항목, 측정기준, 필터 참조를 참조하세요.
자세한 내용은 커스텀 보고서 만들기를 참조하세요.
최근 대시보드에서 커스텀 보고서를 만들려면 다음 안내를 따르세요.
- Edge UI에서 분석 > API 모니터링 > 최근을 클릭합니다.
목록 보기 또는 히트맵 필터 드롭다운에서 API 프록시 또는 대상 서비스를 선택하여 세부정보를 확인합니다. 참고: 프록시 및 대상 필터가
All
로 설정된 경우 커스텀 보고서를 사용할 수 없습니다.오른쪽 모서리에서 을 클릭합니다.
커스텀 보고서 페이지는 관련 필드가 미리 채워져 있고 기본 측정기준 및 측정항목이 포함된 상태로 새 탭에 표시됩니다. 기본적으로 커스텀 보고서는 이름이
API Monitoring Recent Generated
로 지정됩니다. 참고: 커스텀 보고서가 현재 컨텍스트에 이미 있으면 보고서가 열립니다.원하는 대로 커스텀 보고서를 수정하고 저장을 클릭합니다.
목록에서 보고서 이름을 클릭하고 커스텀 보고서를 실행합니다.