GraphQL 모니터링 대시보드 및 로깅(미리 보기)

Fabric에서 GraphQL용 API를 배포한 후 클라이언트에서 API를 사용하는 방법을 이해하고 API에 문제가 있는 경우 오류를 해결할 수 있습니다. Fabric GraphQL 모니터링 대시보드를 사용하여 GraphQL API 요청 활동을 시각화, 모니터링 및 문제 해결합니다. 이 기능은 현재 미리 보기로 제공됩니다. 이 문서에서는 모니터링을 사용하도록 설정하고 대시보드의 구성 요소를 효과적으로 사용하는 방법을 설명합니다.

필수 구성 요소

• 작업 영역 모니터링이 활성화되었습니다. 자세한 내용은 작업 영역 모니터링 개요 를 참조하십시오. 단계에 따라 작업 영역 모니터링을 사용하도록 설정합니다.
• 모니터링 및 로깅 기능을 사용하기 전에 Fabric에서 GraphQL에 대한 API가 있어야 합니다. 자세한 내용은 Fabric에서 GraphQL용 API 만들기 및 데이터추가를 참조하세요.

GraphQL API 모니터링 활성화

이 섹션에서는 GraphQL용 API에 대한 모니터링을 사용하도록 설정하는 데 필요한 단계를 안내합니다. 기본적으로 이 기능은 꺼져 있습니다.

1. 테넌트에서 GraphQL에 대한 각 API에 대한 메트릭 및/또는 로깅 환경을 사용하도록 설정하려면 GraphQL API를 열고 설정 아이콘을 선택합니다.

   

2. API 설정 창의 왼쪽 메뉴에서 모니터링(미리 보기) 옵션을 선택합니다. 작업 영역 모니터링 아직 사용하도록 설정되지 않은 경우 작업 영역 설정 이동하여 사용하도록 설정하는 메모가 표시됩니다.

   

3. 작업 영역에 대한 모니터링을 사용하도록 설정한 후에는 메트릭(API 대시보드), 로깅 전용(API 요청) 또는 둘 다를 사용하도록 설정하는 옵션이 표시됩니다. 메트릭과 로그는 Kusto의 별도 테이블에 저장되며 요구 사항에 따라 각 기능을 개별적으로 사용하도록 설정할 수 있습니다. 기본적으로 두 옵션은 모두 꺼져 있습니다.

   

API 요청 활동

모니터링을 사용하도록 설정하면 GraphQL API의 위쪽 리본에 있는 API 요청 활동 옵션이 활성화됩니다. 모니터링 세부 정보에 액세스하려면 선택합니다.

API 요청 활동 두 가지 기본 보기로 구성됩니다.

1. API 대시보드(메트릭용): 이 페이지에는 지정된 시간 범위에 대한 모든 카운터와 그래프가 표시됩니다.
2. API 요청(로깅용): 이 페이지에는 지정된 시간 범위 내의 API 요청이 나열됩니다.

다음 섹션에서는 각 옵션의 기능에 대해 설명합니다.

메트릭(API 대시보드)

API 대시보드는 다양한 메트릭 및 시각적 개체를 사용하여 API 활동에 대한 개요를 제공합니다. 액세스하려면 API 요청 활동 페이지에서 API 대시보드 탭을 선택합니다. 이제 특정 시간 범위에 대한 다음 매개 변수를 한눈에 볼 수 있습니다.

• 다음을 포함하는 전체 GraphQL API Health 인덱스:

  • 초당 API 요청
  • 성공률
  • 건강 상태

• API 요청 수

• 지연

• 성공 및 오류 수를 보여 주는 가로 막대형 차트의 요청 수

그래프를 마우스로 가리키면 도구 설명에서 특정 데이터 요소에 대한 자세한 정보를 볼 수 있습니다.

API 대시보드의

메트릭 주요 기능:

• 시간 범위 선택: 모니터링 그래프에 표시되는 데이터에 대해 다른 시간 범위를 선택할 수 있습니다. 작업 영역 모니터링 제한으로 인해 데이터 보존은 30일 동안만 사용할 수 있습니다.

  

• API 요청/초: 선택한 시간 범위에서 매 초마다 수행되는 API 요청 수를 볼 수 있습니다.

  

• 성공률: 선택한 시간 범위의 총 요청 수에 대해 성공한 요청 수인 성공률을 볼 수 있습니다.

  

• API당 성공률을 기반으로 하는 전체 GraphQL API Health 인덱스:

  • 녹색: 요청의 75-100% 성공(정상)

  • 노란색: 요청 50-74% 성공(주의 필요)

  • 빨간색: 50개 미만% 성공한 요청(비정상 상태)

    

• 총 API 요청 수: 선택한 시간 범위에서 총 API 요청 수를 볼 수 있습니다.

• 대기 시간 꺾은선형 차트: 그래프 위로 마우스를 가져가면 각 데이터 요소의 대기 시간과 날짜를 볼 수 있습니다.

  

• 성공 요청과 오류를 구분하는 가로 막대형 차트에 요청 수: 그래프를 마우스로 가리키면 각 데이터 요소에 대한 성공 및 오류의 날짜와 수를 볼 수 있습니다.

  

주의가 필요한 대시보드에서 비정상적인 동작이 표시되면 로그를 조사하여 잠재적인 문제를 식별하고 실패한 요청을 확인하고 대기 시간이 더 긴 것을 확인하고 문제를 해결하기 위해 로그 세부 정보를 조사하기 시작할 수 있습니다. 로깅 세부 정보에 액세스하려면 API 요청 활동 페이지에서 API 요청 탭을 선택합니다.

로깅(API 요청)

API 요청 페이지는 특정 시간 프레임에서 발생한 모든 API 요청에 대한 자세한 정보를 제공합니다. 액세스하려면 API 요청 작업 페이지에서 API 요청 탭을 선택합니다.

로깅의 주요 기능

• 시간 범위 선택: 요청 목록에 표시되는 데이터에 대해 다른 시간 범위를 선택할 수 있습니다(시간/일/주/월). 보존 제한은 30일입니다.

• 요청 ID로 나열된 최근 API 요청 및 이전 요청 목록을 봅니다.
• 작업의 유형(쿼리 또는 변형)을 봅니다.
• 요청(HTTP)에서 사용하는 전송 프로토콜을 봅니다.
• 요청 시간을 봅니다.
• 오름차순/내림차순으로 요청 목록을 정렬합니다.
• 요청 기간을 봅니다.
• 요청 목록을 오름차순/내림차순으로 정렬합니다.
• 응답 크기를 봅니다.
• 상태(성공 또는 실패)를 봅니다.
• 특정 응답/경고/오류 메시지를 포함하여 요청의 세부 정보를 봅니다.
• 특정 문자열 또는 문장을 필터링하고 검색합니다.
• 열 크기를 조정하고 보고서 테이블에서 열(오름차순/내림차순)을 정렬합니다.

관련 콘텐츠

• GraphQL용 Microsoft Fabric API
• 작업 영역 모니터링 알림
• 작업 영역 모니터링 개요
• GraphQL용 API 패브릭에서
• Fabric API for GraphQL 편집기
• GraphQL 스키마 보기 및 탐색기를 위한 Fabric API