관측 가능성 설정 관리

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

  • 측정항목 탐색기에서 측정항목 보기
  • Trace 탐색기에서 trace 및 스팬 보기

주요 개념

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

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

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

시작하기 전에

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

관측 가능성 설정 사용 설정

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

콘솔

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

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

    Gemini Enterprise

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

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

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

    관측 가능성 설정 설명
    OpenTelemetry trace 및 로그의 계측 사용 설정 사용 설정하면 Cloud Logging에서 로그와 연결된 trace, 스팬, 스팬 로그, 측정항목 을 볼 수 있습니다.
    프롬프트 입력 및 대답 출력 로깅 사용 설정 사용 설정하면 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 앱의 관측 가능성 설정을 사용 중지하려면 콘솔 또는 REST API를 사용하면 됩니다. Google Cloud

콘솔

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

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

    Gemini Enterprise

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

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

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

    관측 가능성 설정 설명
    OpenTelemetry trace 및 로그의 계측 사용 설정 사용 중지하면 이 설정은 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입니다.

다음 단계