이 문서에서는 Google Antigravity 및 Antigravity CLI와 같은 조직의 AI 개발자 도구에 대한 사용량 측정항목 및 원격 분석을 보는 방법을 설명합니다. 이러한 측정항목은 사용자 도입, 토큰 소비, API 호출, 도구 실행을 보여줍니다.
시작하기 전에
AI 개발자 도구 측정항목을 보기 전에 다음 기본 요건을 충족해야 합니다.
AI 개발자 도구 사용 설정: AI 개발자 도구 측정항목을 보려면 조직에서 프로젝트에 AI 개발자 도구를 사용 설정해야 합니다. AI 개발자 도구 사용 설정을 참고하세요.
인보이스 결제 Cloud Billing 계정: 프로젝트에 Cloud Billing이 사용 설정되어 있어야 하며 인보이스 계정이 있어야 합니다. Cloud Billing 계정 유형을 참고하세요.
지원되는 버전: 사용자는 Gemini Enterprise Standard, Plus, Standard Emerging Market 또는 사용한 만큼만 지불 버전의 구독이 필요합니다.
필수 역할: 콘솔Google Cloud 에서 개발자 도구 측정항목 페이지에 액세스하려면 Gemini Enterprise 관리자(
roles/discoveryengine.agentspaceAdmin) 역할이 필요합니다.
측정항목 대시보드에 액세스
콘솔 Google Cloud 에서 AI 개발자 도구 측정항목을 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.
AI 개발자 도구를 사용 설정한 Google Cloud 프로젝트를 선택합니다.
탐색 메뉴에서 개발자 도구 측정항목 을 클릭합니다.
대시보드 오른쪽 상단에 있는 기간 컨트롤을 사용하여 보고 기간을 조정합니다.
컨트롤 설명 기간 선택기 메뉴 기본적으로 대시보드에는 자동 실시간 새로고침이 사용 설정된 지난 1일 의 데이터가 표시됩니다. 메뉴를 클릭하여 다음 중 하나를 실행합니다. -
**상대적 시간** 필터 필드에 직접 맞춤 기간을 입력합니다 (예:
15m,1h,1d, 또는1w). - 사전 설정된 상대적 기간을 선택합니다. 오늘, 어제, 지난 15분, 지난 30분, 지난 1시간, 지난 3시간, 지난 6시간, 지난 12시간, 지난 1일, 지난 2일, 지난 7일 또는 지난 14일.
- **시작 시간 및 종료 시간** 을 클릭하여 보고 기간의 맞춤 시작 및 종료 날짜와 시간을 지정합니다.
- 특정 시간 을 클릭하여 날짜와 시간을 지정하고 해당 타임스탬프를 중심으로 측정항목을 표시합니다.
- 시간대를 클릭하여 차트의 다른 표시 시간대를 선택합니다 (예: PDT (UTC-7)).
왼쪽 및 오른쪽 화살표 메뉴에서 선택한 기간만큼 보고 기간을 시간상 뒤로 ( ) 또는 앞으로 () 이동합니다. 예를 들어 지난 1일 을 선택한 경우를 클릭하면 차트가 하루 뒤로 이동합니다.기간 축소 특정 기간을 축소하려면 을 클릭합니다. 모든 차트가 업데이트되어 축소된 기간의 데이터를 표시합니다. 확대하고 뷰를 재설정하려면 기간 선택기 메뉴에서 기간을 선택합니다. 자동 새로고침 상대적 기간을 볼 때 대시보드 데이터의 자동 실시간 새로고침을 사용 설정 또는 중지합니다. 절대적 기간 (예: 맞춤 시작 시간 및 종료 시간 또는 이전 기간)을 선택하면 자동 새로고침이 지원되지 않으므로 자동 새로고침이 사용 중지됩니다. -
**상대적 시간** 필터 필드에 직접 맞춤 기간을 입력합니다 (예:
차트 데이터 탐색
개발자 도구 측정항목 대시보드의 각 차트는 시계열을 검사하고, 측정항목을 로그와 상호 연결하고, 기본 데이터를 분석하는 데 도움이 되는 대화형 컨트롤을 제공합니다.
| 컨트롤 | 설명 |
|---|---|
| 정보 | 차트 제목 옆에 있는 정보를 클릭하여 차트의 측정항목 쿼리에 적용된 필터, 그룹화, 집계 속성에 관한 세부정보를 확인합니다. |
| 알림 정책 만들기 | 측정항목 선 차트에서 차트 툴바의 알림 정책 만들기를 클릭하여 차트의 시계열 쿼리로 미리 채워진 Cloud Monitoring의 알림 워크플로를 엽니다. 그런 다음 측정항목의 기준점 조건과 알림 채널을 구성할 수 있습니다. |
| 데이터 탐색 | 차트 툴바에서 데이터 탐색 을 클릭하여 측정항목 쿼리를 측정항목 탐색기에서 엽니다. 측정항목 탐색기에서 다양한 측정기준에 걸쳐 기본 시계열 쿼리를 검사, 필터링, 그룹화, 수정하거나 맞춤 뷰를 맞춤 대시보드에 저장할 수 있습니다. |
| 전체 화면에서 보기 | 차트 툴바에서 차트 옵션 더보기를 클릭한 후 전체 화면에서 보기를 선택하여 차트를 화면에 맞게 확장하여 시계열 및 범례 데이터를 자세히 검사합니다. |
| 관련 로그 검사 |
측정항목 데이터를 동일한 기간에 작성된 로그 항목과 상호 연결하여 활동 및 오류를 해결할 수 있습니다.
|
사용 가능한 측정항목
다음 표에는 대시보드에서 사용할 수 있는 모든 측정항목이 나와 있습니다.
| 섹션 | 측정항목 이름 | 설명 |
|---|---|---|
| 활성 사용자 (도입) | 활성 사용자는 보고 기간 동안 하나 이상의 AI 개발자 도구 작업 (예: API 요청, 프롬프트 또는 도구 실행)을 시작한 순 사용자입니다. | |
| 시간당 활성 사용자 수 (평균) | 선택한 기간의 시간당 평균 순 활성 사용자 수를 표시합니다. | |
| 일일 활성 사용자 수 (평균) | 선택한 기간의 일일 평균 순 활성 사용자 수를 표시합니다. | |
| 주간 활성 사용자 수 (평균) | 선택한 기간의 주간 평균 순 활성 사용자 수를 표시합니다. | |
| 월간 활성 사용자 수 (평균) | 선택한 기간의 월간 평균 순 활성 사용자 수 (28일 활성 사용자)를 표시합니다. | |
| 시간당 활성 사용자 수 | 선택한 기간의 시간당 순 활성 사용자 수를 보여주는 추세선 차트입니다. | |
| 일일 활성 사용자 수 | 선택한 기간의 일일 순 활성 사용자 수를 보여주는 추세선 차트입니다. | |
| 주간 활성 사용자 수 | 선택한 기간의 주간 순 활성 사용자 수를 보여주는 추세선 차트입니다. | |
| 월간 활성 사용자 수 | 선택한 기간의 월간 순 활성 사용자 수 (28일 활성 사용자)를 보여주는 추세선 차트입니다. | |
| 도구 및 API 호출 | 총 토큰 수 | 선택한 기간 동안 AI 개발자 도구에서 소비한 결합된 입력 및 출력 토큰의 총수입니다. |
| 일일 토큰 사용량 | 시간 경과에 따른 일일 토큰 소비량을 보여주는 선 차트입니다. | |
| 일일 API 호출 |
AI 개발자 도구에서 수행한 일일 API 호출 수를 보여주는 선 차트입니다. 여기에는 error_type 라벨(예: 할당량 한도, 인증 오류 또는 클라이언트 오류)별 오류 분석이 포함됩니다.
|
|
| 일일 도구 호출 | AI 개발자 도구에서 시작한 일일 도구 호출 수를 보여주는 선 차트입니다. | |
| 수락된 일일 도구 호출 | 사용자가 수락하고 실행한 에이전트 제안 도구 호출 제안의 일일 수를 보여주는 선 차트입니다. | |
제한사항
AI 개발자 도구 측정항목에는 다음과 같은 제한사항이 적용됩니다.
- 일일 도구 호출 및 수락된 일일 도구 호출 측정항목은 데이터를 표시하지 않습니다.
다음 단계
- AI 개발자 도구 개요 에서 사용 가능한 도구 및 기능에 관해 자세히 알아보세요.
- 개발자 도구 설정을 구성하는 방법을 알아보세요. 자세한 내용은 AI 개발자 도구 설정 구성을 참고하세요.
- 커스텀 역할로 액세스를 관리하는 방법을 알아보세요. 자세한 내용은 AI 개발자 도구의 커스텀 역할 만들기를 참고하세요.