Gemini Enterprise는 고객이 Gemini Enterprise와 데이터를 연결할 때 오류와 경고를 모니터링할 수 있도록 Cloud Logging을 제공합니다.
이 문서에서는 Cloud Logging을 사용하여 Gemini Enterprise의 제휴 커넥터 오류 로그 및 수집 커넥터 오류 로그에 액세스하는 방법을 설명합니다.
주요 개념
이 섹션에서는 Gemini Enterprise의 모니터링 가능성과 관련된 주요 개념을 소개합니다.
| 개념 | 설명 |
|---|---|
| Gemini Enterprise 커넥터 오류 로그 | Gemini Enterprise 커넥터 오류 로그는 Gemini Enterprise를 Jira 및 Microsoft OneDrive와 같은 서드 파티 데이터 소스와 통합할 때 발생하는 오류 및 실패를 캡처합니다. 이러한 로그에는 연결 문제, 데이터 변환 문제, API 오류가 포함됩니다. |
시작하기 전에
오류 로그에 액세스하기 전에 다음을 수행했는지 확인하세요.
로깅을 사용 설정하려면 Gemini Enterprise 관리자 IAM 역할 (
roles/discoveryengine.agentspaceAdmin)이 있어야 합니다.Cloud Logging에 액세스하려면 로그 뷰어 IAM 역할 (
roles/logging.viewer)이 있어야 합니다.Gemini Enterprise 앱을 만들었습니다. 앱을 만들려면 앱 만들기를 참조하세요.
데이터 스토어가 올바르게 구성되고 활성 상태인지 확인했습니다. 데이터 스토어 설정에 대한 자세한 내용은 Google 데이터 소스 연결 또는 서드 파티 데이터 소스 연결을 참조하세요.
제휴 커넥터 오류 로그를 볼 수 있도록 모니터링 가능성 설정을 사용 설정했습니다. 자세한 내용은 모니터링 가능성 설정 사용 설정을 참조하세요.
제휴 커넥터 오류 로그 액세스
데이터 제휴를 사용하여 Gemini Enterprise에 연결하는 데이터 스토어의 오류 로그를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.
탐색 메뉴에서 데이터 스토어를 클릭합니다.
원하는 데이터 스토어를 선택합니다.
로그 보기를 클릭합니다. 그러면 로그 탐색기 페이지가 열립니다.
Gemini Enterprise 커넥터 로그만 보려면 쿼리 편집기 필드에 다음 쿼리를 입력하고 쿼리 실행을 클릭합니다.
logName="projects/PROJECT_ID/logs/discoveryengine.googleapis.com%2Fconnector_activity" jsonPayload.logMetadata.name="projects/PROJECT_ID/locations/LOCATION/collections/COLLECTION_ID/dataConnector"다음을 바꿉니다.
PROJECT_ID: 프로젝트의 ID입니다.LOCATION: 커넥터의 위치입니다. 예를 들면global입니다.COLLECTION_ID: 커넥터가 포함된 컬렉션의 ID이며,Google Cloud 콘솔에 있는 데이터 스토어의 ID이기도 합니다.
필터를 사용하여 쿼리 범위를 세분화합니다. 예를 들어 모든 심각도를 클릭하고 오류 이상을 선택합니다. 쿼리 미세 조정에 대한 자세한 내용은 샘플 쿼리를 참조하세요.
수집 커넥터 오류 로그 액세스
데이터 수집을 사용하여 Gemini Enterprise에 연결하는 데이터 스토어의 오류 로그를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.
탐색 메뉴에서 데이터 스토어를 클릭합니다.
원하는 데이터 스토어를 선택합니다.
로그 보기를 클릭합니다. 그러면 로그 탐색기 페이지가 열립니다.
기본적으로 로그 탐색기 페이지는 기본 로그 범위에 나열된 리소스에서 로그 항목을 검색합니다. Gemini Enterprise 로그를 필터링하려면 다음 중 하나를 수행합니다.
- 모든 리소스 > 사용된 API > Discovery Engine API를 선택한 후 적용을 클릭합니다.
쿼리 창에 다음을 입력하고 쿼리 실행을 클릭합니다.
resource.type="consumed_api" resource.labels.service="discoveryengine.googleapis.com"
JSON 메타데이터를 필터링하여 쿼리 범위를 미세 조정합니다. 예를 들어
ImportDocuments메서드 로그를 쿼리하려면 다음 중 하나를 수행합니다.쿼리 표시줄에 다음을 입력합니다.
jsonPayload.context.reportLocation.functionName=~"ImportDocuments"JSON 메타데이터를 펼치고 클릭하여 필터링합니다.
그림 1. JSON 메타데이터를 클릭하여 필터링
대부분의 경고 및 오류에 대한 자세한 내용은
jsonPayload.message및jsonPayload.status를 참조하세요.더 심층적인 로그 분석을 위해 로그를 BigQuery와 같은 로그 싱크에 덤프합니다. 자세한 내용은 Google Cloud Observability 문서의 지원되는 대상으로 로그 라우팅을 참조하세요.