Note
이 기능은 현재 공개 미리 보기 버전이며 변경될 수 있습니다. 이 GitHub Community 토론에서 자유롭게 피드백을 주세요.
API 인사이트 정보
GitHub Enterprise Cloud 조직 소유자와 조직 소유자가 지정한 사용자는 전체 조직 또는 특정 앱 및 사용자에 대한 REST API 활동을 볼 수 있습니다. 이를 통해 REST API 활동의 원본을 이해하고 기본 속도 제한에 대해 관리하여 관련된 시간 프레임, 앱 및 API 엔드포인트를 볼 수 있습니다. 기본 속도 제한에 대한 자세한 내용은 "REST API에 대한 트래픽률 제한"을(를) 참조하세요.
Note
현재 이 기능은 REST API 엔드포인트의 core 범주(비검색 관련)와 기본 속도 제한만 지원하고 보조 속도 제한은 지원하지 않습니다. API 범주에 대한 자세한 내용은 "트래픽률 제한에 대한 REST API 엔드포인트"을(를) 참조하세요. 기본 및 보조 속도 제한에 대한 자세한 내용은 "REST API에 대한 트래픽률 제한"을(를) 참조하세요.
API 인사이트에 대한 액세스 사용
조직 소유자는 사람들이 해당 조직의 API 인사이트를 볼 수 있도록 사용자 지정 조직 역할을 생성할 수 있습니다. 사용자에게 액세스 권한을 제공하려면 사용자 지정 조직 역할을 생성할 때 View organization API insights 권한을 선택합니다. 그런 다음, 조직 구성원 또는 팀에 사용자 지정 역할을 할당합니다. 자세한 내용은 "사용자 지정 조직 역할 소개"을(를) 참조하세요.
Warning
소유자가 아닌 사람에게 조직에 대한 액세스 권한을 부여하면 이들은 조직의 모든 사용자 및 앱에 대한 API 인사이트를 볼 수 있으므로 개인 정보 보호를 고려해야 합니다.
API 인사이트 집계 이해
기간 선택 기능을 사용하면 다음 표에 설명된 대로 미리 정의된 기간 또는 사용자 지정 기간 동안 API 인사이트를 볼 수 있습니다. 기본적으로 데이터는 UTC(협정 세계시)로 표시됩니다. 페이지의 오른쪽 위에 있는 "Period" 드롭다운 메뉴에서 표시된 데이터를 UTC에서 사용자의 브라우저 표준 시간대로 변경할 수 있습니다.
| Period | 설명 |
|---|---|
| 지난 30분 | 페이지를 볼 때 마지막 30분의 데이터입니다. |
| 지난 1시간 | 페이지를 볼 때 마지막 1시간의 데이터입니다. |
| 지난 3시간 | 페이지를 볼 때 마지막 3시간의 데이터입니다. |
| 지난 12시간 | 페이지를 볼 때 마지막 12시간의 데이터입니다. |
| 최근 24시간 | (기본값) 페이지를 볼 때 마지막 24시간의 데이터입니다. |
| 마지막 7일 | 페이지를 볼 때 마지막 7일의 데이터입니다. |
| 지난 31일 | 페이지를 볼 때 마지막 31일의 데이터입니다. |
| 사용자 지정 | 사용자가 제공하는 사용자 지정 날짜 및 시간 범위의 데이터입니다. 사용자 지정 범위는 마지막 31일 이내에 시작해야 합니다. |
조직에 대한 API 인사이트 보기
-
GitHub의 오른쪽 위 모서리에서 프로필 사진을 선택하고 조직을 클릭합니다.
-
조직 이름을 클릭합니다.
-
조직 이름 아래에서 인사이트를 클릭합니다.
-
"Insights" 탐색 메뉴에서 REST API를 클릭합니다.
-
선택적으로 API 인사이트를 볼 기간을 선택하려면 페이지 오른쪽 위에 있는 Period 드롭다운 메뉴에서 옵션을 선택합니다. 자세한 내용은 "API 인사이트 집계 이해"를 참조하세요.
-
필요에 따라 UTC(협정 세계시)로 날짜와 시간을 표시하거나 브라우저에서 사용하는 현지 표준 시간대로 표시하려면 페이지의 오른쪽 위에 있는 Period 드롭다운 메뉴에서 "UTC" 또는 "Local"을 선택합니다.
-
필요에 따라 차트에 REST API 요청을 표시하는 방법을 세분화하려면 페이지 오른쪽 위에 있는 Interval 드롭다운 메뉴에서 옵션을 선택합니다. 큰 간격은 차트의 API 활동에 대한 요약을 표시하는 반면, 더 작은 간격은 선택한 기간에 대해 더 자세한 정보를 표시합니다. 차트는 새 활동을 표시하도록 자동으로 업데이트되지 않습니다.
선택한 기간 및 간격은 자동으로 페이지 URL의 일부가 되므로 다른 사용자와 URL을 공유하는 경우 해당 사용자에게 동일한 보기가 표시됩니다.
조직의 앱 및 사용자에 대한 API 인사이트 보기
"Actors" 테이블에는 GitHub Apps과 선택한 기간 내에 현재 조직에서 REST API 요청을 한 사용자가 표시됩니다. 테이블은 새 활동을 표시하도록 자동으로 업데이트되지 않습니다.
- 먼저, "조직에 대한 API 인사이트 보기"에 있는 단계를 사용하여 조직에 대한 API 인사이트를 봅니다.
- "Actors" 테이블에 표시되는 앱 및 사용자를 필터링합니다.
- 이름으로 필터링하려면 "Actors" 테이블 위의 검색 필드에 이름의 처음 몇 글자를 입력합니다. 그런 다음 Enter 키를 누릅니다.
- 작업자 유형(앱 또는 사용자)으로 필터링하려면 "Actors" 테이블의 오른쪽 위에 있는 Type 드롭다운 메뉴에서 옵션을 선택합니다.
- 요청 유형(전체 또는 기본 속도 제한)을 기준으로 필터링하려면 "Actors" 테이블의 오른쪽 위에 있는 Requests 드롭다운 메뉴에서 옵션을 선택합니다.
조직의 특정 앱 또는 사용자에 대한 API 인사이트 보기
- 먼저, "조직에 대한 API 인사이트 보기"에 있는 단계를 사용하여 조직에 대한 API 인사이트를 봅니다.
- 필요에 따라 "Actors" 테이블에서 앱을 선택하여 REST API 활동 및 기본 속도 제한을 표시합니다. 결과 보기는 선택한 앱에 특정하며 액세스한 API 엔드포인트를 표시합니다.
- 필요에 따라 "Actors" 테이블에서 사용자를 선택하여 개인 REST API 활동을 표시합니다. 결과 보기는 선택한 사용자에 특정하며 사용자를 대신하여 personal access tokens의 API 활동과 OAuth apps의 요청을 표시합니다. 둘 다 사용자의 개인 기본 속도 제한에 기여합니다. 사용자에 대한 기본 속도 제한과 사용자를 대행하는 OAuth apps에 대한 자세한 내용은 "REST API에 대한 트래픽률 제한"을(를) 참조하세요.
- 필요에 따라 사용자별 보기에서 personal access token 또는 OAuth app을 클릭하여 사용자를 대신하여 수행된 REST API 활동을 봅니다.