Apigee Edge 문서입니다.
Apigee X 문서로 이동 정보
조사 대시보드를 사용하면 모든 API 트래픽에 대한 측정항목 및 속성의 피벗 테이블을 보고 측정항목 간의 관계형 활동을 비교하여 문제를 더 빨리 조사하고 진단할 수 있습니다. 대시보드에서 지난 30일 동안의 데이터에 액세스할 수 있습니다.
Edge UI에서 분석 > API 모니터링 > 조사를 선택하여 조사 대시보드를 엽니다. 대시보드에는 두 가지 주요 영역이 있습니다.
- 상태 코드를 사용하면 API 프록시 및 대상 서비스의 상태 코드 측정항목을 조사할 수 있습니다.
- 지연 시간을 사용하면 API 프록시 및 대상 서비스의 지연 시간 문제를 조사할 수 있습니다.
조사 대시보드에서 특정 경고로 인해 발생한 문제를 조사할 수도 있습니다. 경고가 발생하면 경고 기록 페이지에서 경고 이름을 클릭하여 조사 대시보드에서 경고를 엽니다.
조사 대시보드를 사용하여 문제 진단
예를 들어 5xx 오류율이 지정된 임곗값을 초과함을 나타내는 경고를 수신됩니다. 이 문제를 조사하려면 조사 대시보드에서 다음 태스크를 수행하세요.
- 오류 코드 및 시간 비교 매트릭스를 확인하여 지난 1시간 동안의 오류 코드 활동을 확인하세요.
- 오류 코드와 HTTP 상태 비교 매트릭스로 전환하여 이전 단계에서 파악한 것처럼 최근 1시간 동안 개수가 증가한 오류 코드와 관련된 특정 HTTP 상태 코드를 식별합니다.
- 이전 단계에서 식별된 오류 코드를 트리거하는 API 프록시를 식별하려면 오류 코드 및 프록시 비교 매트릭스로 전환합니다.
- 매트릭스에서 오류 코드가 많은 API 프록시와 연결된 상자를 클릭하여 세부정보를 확인하고 로그에 액세스합니다.
- 경고를 설정하고 커스텀 보고서를 생성하여 문제 진단에 도움을 받으세요.
트레이스 및 기타 도구를 사용하여 API 프록시를 추가로 문제 해결하여 문제의 해결 방법을 찾습니다.
상태 코드 대시보드 사용
상태 코드 대시보드를 사용하면 조직의 API 프록시 및 대상 서비스에 대한 상태 코드 측정항목을 조사할 수 있습니다. 지난 30일 동안 언제든지 1시간 또는 4시간 기간의 상태 코드 측정항목을 볼 수 있습니다.
상태 코드 대시보드 살펴보기
상태 코드 대시보드를 표시하려면 Edge UI에서 분석 > API 모니터링 > 조사를 선택합니다. 상태 코드 대시보드에는 기본적으로 다음이 표시됩니다.
그림에 강조 표시된 것처럼 조사 대시보드에서 다음을 수행할 수 있습니다.
- x축과 y축을 설정하여 측정항목 간의 관계 활동을 비교하고 더 많은 유용한 정보를 얻을 수 있도록 각 매트릭스를 구성합니다.
- 블록의 색상 음영을 기반으로 상대 볼륨이 가장 높은 측정항목을 빠르게 식별합니다. 블록이 어두울수록 상대 볼륨이 높습니다.
- 매트릭스에서 블록을 클릭하여 측정항목 세부정보를 확인합니다.
- 다음을 기준으로 데이터를 필터링합니다.
- 환경
- 리전
- 프록시
- 상태 코드(모든 트래픽, 모든 오류, 2xx, 4xx 또는 5xx 포함)
- 지난 30일의 날짜 및 시간
- 1시간 또는 4시간 기간
대시보드를 사용하면 다음 태스크를 빠르게 수행할 수 있습니다.
- 측정항목 세부정보 패널의 로그에 액세스합니다.
- 최근 또는 타임라인에서 또는
> 최근 보기 또는 타임라인에서 보기를 각각 클릭하여 대시보드에서 현재 컨텍스트를 봅니다. - 커스텀 보고서를 만들고
를 클릭하여 측정기준을 더 추가합니다. - 경고를 만들고 경고 조건을 추가하고, 알림을 설정하고, 경고를 기준으로 커스텀 보고서를 생성합니다.
상태 코드 매트릭스 구성
상태 코드 대시보드를 선택하면 기본적으로 다음 매트릭스가 표시됩니다.
- 오류 코드와 시간 비교
- 오류 코드와 HTTP 상태 비교
- 오류 소스와 API 프록시 비교
x- 및 y축 드롭다운 목록의 값을 선택하여 다음 측정항목 2개를 비교하도록 각 매트릭스를 구성합니다.
- 오류 코드
- 오류 정책
- 오류 소스
- HTTP 상태
- 프록시
- 시간
- 지역
- 대상(대상 서비스 또는 ServiceCallout 정책입니다. 대상이 ServiceCallout 정책인 경우 표시된 값에
sc://라는 프리픽스가 붙습니다. 예:sc://my.endpoint.net)
상태 코드 측정항목 세부정보 보기
매트릭스에서 블록을 클릭하여 특정 측정항목의 세부정보를 확인합니다.
의심되는 원인과 관련된 세부정보가 오른쪽 창에 표시됩니다.
- 환경
- 조직
- 리전
- 오류 소스(프록시, 대상 또는 Apigee 인프라)
세부정보에는 다음이 포함될 수도 있습니다.
- Fault Policy(오류 정책): 정책 유형(내부 이름) 및 사용자 정의 정책 이름을 포함하여 런타임 오류를 트리거한 정책에 관한 정보입니다. API 프록시 흐름에 정책을 연결할 때 이름을 정의합니다.
- 프록시 이름
- HTTP 상태 코드
- 오류 코드
카디널리티가 특정 측정항목에 대해 1보다 큰 경우 세부정보 패널에 개발자 앱별 배포, 오류 정책별 배포, 오류 코드별 배포, HTTP 상태별 배포 등의 오류 배포 세부정보가 포함될 수 있습니다. 예:
오류 소스가 대상인 경우 세부정보 패널에 대상별 오류율이 포함됩니다. 예:
지연 시간 대시보드 사용
지연 시간 대시보드에는 조직의 API 프록시 및 대상 서비스에 대한 지연 시간 정보가 표시됩니다. 지난 30일 중 언제든지 1시간 기간의 지연 시간 측정항목을 조사할 수 있습니다.
지연 시간 대시보드 살펴보기
지연 시간 대시보드를 표시하려면 Edge UI에서 분석 > API 모니터링 > 조사를 선택합니다. 상태 코드 대시보드가 기본적으로 표시됩니다. 필터 영역에서 지연 시간을 선택하여 지연 시간 대시보드를 표시합니다.
지연 시간 대시보드를 선택하면 기본적으로 다음 매트릭스가 표시됩니다.
- 프록시와 시간 비교(최대 지연 시간(밀리초))
- 프록시와 총 지연 시간 비교(최대 지연 시간(밀리초))
- 프록시와 모든 대상 지연 시간(최대 지연 시간(밀리초))
프록시 드롭다운 메뉴에서 대상을 선택하여 대상 지연 시간을 봅니다.
기본적으로 지연 시간 대시보드에는 이전 1시간 동안 총 P99 지연 시간이 가장 긴 프록시 10개의 정보가 표시됩니다. 또는 상위 10개 드롭다운 메뉴를 사용하여 특정 프록시 또는 컬렉션을 선택합니다.
지연 시간 대시보드에는 상태 코드 대시보드의 모든 기능이 포함되어 있지만 다음과 같은 차이점이 있습니다.
- 총 응답 지연 시간 백분위수(p50, p90, p95, p99)만 구성합니다.
- 지연 시간 측정항목의 경우 1시간 범위만 선택할 수 있습니다.
- 필터에서 지역에 모두를 선택할 수 없습니다. 표시할 특정 지역을 선택해야 합니다.
지연 시간 측정항목 세부정보 보기
매트릭스에서 블록을 클릭하여 특정 측정항목의 세부정보를 확인합니다.
다음을 포함하여 프록시의 지연 시간(파란색 선) 및 대상(보라색 선)과 관련된 세부정보가 오른쪽 창에 표시됩니다.
- 총 지연 시간(프록시 지연 시간 + 대상 지연 시간)
- 대상별 지연 시간(대상 응답 시간)
- HTTP 상태별 배포
그래프 위로 마우스를 가져가면 자세한 정보를 볼 수 있습니다.
대상별 지연 시간 그래프는 최대 지연 시간을 기준으로 상위 16개 대상을 보여주며, 대상별로 하나의 그래프가 사용됩니다. 그래프 위로 마우스를 가져가거나 드롭다운 목록을 선택하여 각 대상에 해당하는 그래프를 결정합니다.
측정항목 세부정보의 로그 보기
상태 코드 또는 지연 시간의 측정항목 세부정보를 볼 때 로그 보기를 클릭하면 선택한 측정항목의 모든 로그를 볼 수 있습니다.
트래픽 로그 대화상자가 열리고 최대 1,000개의 로그 항목이 표시됩니다. 로그 항목을 클릭하여 목록에서 세부정보를 펼칩니다.
다음을 기준으로 로그를 추가로 필터링할 수 있습니다.
- 트래픽 소스
- 오류 유형
- 최소 응답 시간
트래픽 로그 대화상자에서는 로그 데이터를 다운로드할 수 없습니다. 하지만 맞춤 보고서를 만들거나 Google Cloud Storage 또는 BigQuery와 같은 자체 데이터 저장소에 분석 데이터를 다운로드하여 자체 데이터 분석을 수행할 수 있습니다.
조사 대시보드에서 커스텀 보고서 만들기
선택한 조건 집합을 기준으로 커스텀 보고서를 만듭니다. 생성 후 필요에 따라 커스텀 보고서를 편집하여 측정항목 및 측정기준을 추가하거나 삭제할 수 있습니다. 예를 들어 조사 범위를 특정 액세스 토큰, 개발자 앱, API 프록시로 좁힐 수 있습니다. 자세한 내용은 애널리틱스 측정항목, 측정기준, 필터 참조를 참조하세요.
자세한 내용은 커스텀 보고서 만들기를 참조하세요.
커스텀 보고서를 만들려면 다음 안내를 따르세요.
매트릭스에서 블록을 클릭하면 세부정보가 표시됩니다.
오른쪽 창에서
아이콘을 클릭합니다.
커스텀 보고서 페이지가 관련 필드가 미리 채워져 있는 새 탭에 표시됩니다.
참고: 기본 커스텀 보고서 설정에 대한 자세한 내용은 커스텀 보고서 만들기를 참조하세요.
필요에 따라 커스텀 보고서를 수정합니다. 커스텀 보고서 관리를 참고하세요.
저장을 클릭하여 맞춤 보고서를 저장합니다.
보고서는 기본적으로 지난 1시간 동안 수집된 데이터를 사용하여 실행되며 데이터는 커스텀 보고서 대시보드에 표시됩니다. 커스텀 보고서 대시보드 살펴보기를 참조하세요.
보고서 페이지에서 API 모니터링을 사용하여 생성된 맞춤 보고서의 이름은 API Monitoring Investigate Generated 형식을 사용합니다.
특정 경고 조사
특정 알림을 조사하려면 알림 기록 페이지에서 알림 이름을 선택합니다. 조사 대시보드가 표시됩니다. 대시보드 상단에 그래프가 포함되어 있으며 알림과 관련된 정보만 포함되어 있습니다.
