모니터링 가능성 설정 관리

이 문서에서는 Google Cloud 콘솔을 사용하여 Gemini Enterprise 앱의 관측 가능성 설정을 구성하는 방법을 설명합니다. 설정을 사용 설정하면 Gemini Enterprise 웹 앱에서 어시스턴트와의 상호작용을 통해 생성된 다음 데이터를 볼 수 있습니다.

  • 측정항목 탐색기에서 측정항목을 확인합니다.
  • Trace 탐색기에서 trace와 스팬을 확인합니다.

주요 개념

이 섹션에서는 Gemini Enterprise의 관측 가능성과 관련된 주요 개념을 소개합니다.

개념 설명
Trace 트레이스는 여러 서비스와 구성요소를 통과하는 단일 요청 또는 트랜잭션을 나타내는 스팬의 모음입니다.

예를 들어 트레이스는 요청의 전체 수명 주기를 나타냅니다. 여기에는 사용자가 Gemini Enterprise 어시스턴트에게 질문하는 경우, Gemini Enterprise 어시스턴트가 대답하는 경우, 대답으로 인해 트리거되는 후속 작업(예: 이메일 전송)이 포함됩니다.
스팬 스팬은 트레이스 내의 단일 시간 단위 작업입니다. 함수 호출, API 요청, 데이터베이스 쿼리와 같은 특정 작업을 나타냅니다. 각 스팬에는 시작 및 종료 시간, 고유 ID, 다른 스팬과의 관계와 같은 세부정보가 포함됩니다. 이러한 관계가 함께 트레이스를 형성합니다.
스팬 로그 스팬 로그는 특정 스팬과 연결된 타임스탬프가 지정된 자유 형식 메시지 또는 이벤트입니다. 스팬의 실행에 관한 자세한 컨텍스트 정보를 제공하여 사용자가 문제를 디버깅하고 요청 흐름을 이해할 수 있도록 지원합니다.
측정항목 측정항목은 시스템이 시간이 지남에 따라 수집하는 숫자 측정값입니다. 이러한 측정은 시스템의 성능, 리소스 사용률 또는 동작을 나타냅니다. 엔지니어는 측정항목을 사용하여 시스템 상태를 모니터링하고, 트렌드를 파악하고, 알림을 트리거합니다.
사용 감사 로그 사용 감사 로그는 Google Cloud 리소스 내의 관리 활동 및 액세스를 기록한 것입니다. 이러한 로그는 누가 언제 어디에서 어떤 작업을 수행했는지에 관한 세부정보를 제공합니다. 이러한 로그는 보안 감사, 규정 준수, 리소스 사용 방식을 이해하는 데 필수적입니다.
Gemini Enterprise 커넥터 오류 로그 Gemini Enterprise 커넥터 오류 로그는 Gemini Enterprise를 Jira, Microsoft OneDrive와 같은 서드 파티 데이터 소스와 통합할 때 발생하는 오류와 실패를 포착합니다. 이러한 로그에는 연결 문제, 데이터 변환 문제, API 오류가 포함됩니다.

시작하기 전에

다음 항목이 있는지 확인합니다.

모니터링 가능성 설정 사용 설정

Gemini Enterprise 앱의 관측 가능성을 사용 설정하려면Google Cloud 콘솔 또는 REST API를 사용하면 됩니다.

콘솔

Google Cloud 콘솔을 사용하여 모니터링 가능성 설정을 사용 설정하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

    Gemini Enterprise

  2. 구성을 원하는 앱의 이름을 클릭합니다.

  3. 구성을 클릭한 다음 관측 가능성 탭을 클릭합니다.

  4. 다음 설정을 사용 설정하거나 사용 중지할 수 있습니다.

    모니터링 가능성 설정 설명
    OpenTelemetry trace 및 로그의 계측 사용 설정 사용 설정하면 Cloud Logging에서 로그와 연결된 트레이스, 스팬, 스팬 로그, 측정항목을 볼 수 있습니다.
    프롬프트 입력 및 대답 출력 로깅 사용 설정 사용 설정하면 Cloud Logging이 사용자 프롬프트와 대답의 전체 콘텐츠를 로깅합니다. 여기에는 민감한 정보 또는 개인 식별 정보 (PII)가 포함됩니다. 이 설정을 사용 설정하려면 먼저 OpenTelemetry trace 및 로그의 계측 사용 설정을 사용 설정해야 합니다.

REST

REST API를 사용하여 관측 가능성 설정을 구성하려면 다음 섹션을 참고하세요.

앱을 만들 때 관측 가능성 사용 설정

관측 가능성이 사용 설정된 새 앱을 만들려면 다음 명령어를 실행합니다.

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines?engineId=APP_ID" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_ENTERPRISE",
    "searchAddOns": ["SEARCH_ADD_ON_LLM"],
    "requiredSubscriptionTier": "SUBSCRIPTION_TIER_SEARCH_AND_ASSISTANT"
  },
  "industryVertical": "GENERIC",
  "appType": "APP_TYPE_INTRANET",
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

다음을 바꿉니다.

  • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
    • 미국 멀티 리전의 경우 us
    • EU 멀티 리전의 경우 eu
    • 전역 위치의 경우 global
    자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
  • PROJECT_ID: 프로젝트의 ID입니다.
  • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
  • APP_ID: 만들려는 앱의 ID입니다.
  • APP_DISPLAY_NAME: 만들려는 앱의 표시 이름입니다.

기존 앱의 모니터링 가능성 사용 설정

기존 앱에서 관측 가능성을 사용 설정하려면 다음 명령어를 실행합니다.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": true,
    "sensitiveLoggingEnabled": true
  }
}'

다음을 바꿉니다.

  • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
    • 미국 멀티 리전의 경우 us
    • EU 멀티 리전의 경우 eu
    • 전역 위치의 경우 global
    자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
  • PROJECT_ID: 프로젝트의 ID입니다.
  • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
  • APP_ID: 앱의 ID입니다.

모니터링 가능성 설정 사용 중지

Gemini Enterprise 앱의 관측 가능성 설정을 사용 중지하려면 Google Cloud 콘솔 또는 REST API를 사용하면 됩니다.

콘솔

Google Cloud 콘솔을 사용하여 관측 가능성 설정을 사용 중지하려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

    Gemini Enterprise

  2. 관측 가능성 설정을 사용 중지하려는 앱의 이름을 클릭합니다.

  3. 구성을 클릭한 다음 관측 가능성 탭을 클릭합니다.

  4. 다음 설정을 사용 중지할 수 있습니다.

    모니터링 가능성 설정 설명
    OpenTelemetry trace 및 로그의 계측 사용 설정 이 설정을 사용 중지하면 트레이스, 스팬, 스팬 로그, 측정항목의 수집이 중지됩니다. 또한 프롬프트 입력 및 대답 출력 로깅 사용 설정 설정이 사용 중지되므로 로그가 Cloud Logging으로 전송되지 않습니다.
    프롬프트 입력 및 대답 출력 로깅 사용 설정 사용 중지되면 Cloud Logging은 프롬프트 입력 및 대답 출력을 로깅하지 않습니다.

REST

REST API를 사용하여 관측 가능성 설정을 사용 중지하려면 다음 명령어를 실행합니다.

curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID?updateMask=observabilityConfig" \
-d '{
  "observabilityConfig": {
    "observabilityEnabled": false,
    "sensitiveLoggingEnabled": false
  }
}'

다음을 바꿉니다.

  • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
    • 미국 멀티 리전의 경우 us
    • EU 멀티 리전의 경우 eu
    • 전역 위치의 경우 global
    자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
  • PROJECT_ID: 프로젝트의 ID입니다.
  • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).
  • APP_ID: 앱의 ID입니다.

다음 단계