모니터링 가능성 설정 관리

이 문서에서는 콘솔 또는 REST API를 사용하여 Gemini Enterprise 앱 또는 개별 에이전트의 관측 가능성 설정을 구성하는 방법을 설명합니다. Google Cloud

사용 설정 로직은 에이전트 유형에 따라 다릅니다.

  • Core Assistant 에이전트: 애플리케이션 수준 (엔진 수준) 전환을 사용합니다. 구성에서.
  • 기타 에이전트: (현재 Agent Designer 직원 제작 에이전트 및 Deep Research 에이전트로 제한됨) 개별 에이전트의 설정 내에서 에이전트 수준 전환을 사용합니다.

설정을 사용 설정한 후 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 앱 또는 개별 에이전트의 관측 가능성을 사용 설정하려면 콘솔 또는 REST API를 사용하면 됩니다. Google Cloud

콘솔

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

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

    Gemini Enterprise

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

  3. 구성하는 에이전트 유형에 따라 다음 중 하나를 수행합니다.

    • Core Assistant 에이전트: 구성을 클릭한 다음 관측 가능성 탭을 클릭합니다.
    • 기타 에이전트 (Agent Designer 직원 제작 에이전트 및 Deep Research 에이전트): 에이전트를 클릭하고 구성하려는 에이전트의 이름을 클릭한 다음 구성 탭을 클릭합니다.

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

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

REST

REST API를 사용하여 모니터링 가능성 설정을 구성하려면 다음 섹션을 참조하세요.

Core Assistant (앱 수준)의 관측 가능성 설정 구성

앱 수준에서 REST API를 사용하여 관측 가능성 설정을 구성하려면 (Core Assistant 에이전트에 적용됨) 다음 섹션을 참조하세요.

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

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

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입니다.

개별 에이전트의 관측 가능성 설정 구성

REST API를 사용하여 개별 에이전트 (예: Agent Designer 에이전트 또는 Deep Research 에이전트)의 관측 가능성을 사용 설정하려면 다음 명령어를 실행하여 에이전트의 observabilityConfig를 업데이트합니다.

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/assistants/default_assistant/agents/AGENT_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입니다.
  • AGENT_ID: 구성하려는 에이전트의 ID입니다.

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

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

콘솔

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

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

    Gemini Enterprise

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

  3. 구성하는 에이전트 유형에 따라 다음 중 하나를 수행합니다.

    • Core Assistant 에이전트: 구성을 클릭한 다음 관측 가능성 탭을 클릭합니다.
    • 기타 에이전트 (Agent Designer 직원 제작 에이전트 및 Deep Research 에이전트 포함): 에이전트를 클릭하고 구성하려는 에이전트의 이름을 클릭한 다음 구성 탭을 클릭합니다.

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

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

REST

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

앱 수준에서 관측 가능성 사용 중지 (Core Assistant)

애플리케이션 (앱) 수준에서 관측 가능성을 사용 중지하려면 다음 명령어를 실행합니다.

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입니다.

개별 에이전트의 관측 가능성 사용 중지

개별 에이전트 (예: Agent Designer 에이전트 또는 Deep Research 에이전트)의 관측 가능성을 사용 중지하려면 다음 명령어를 실행합니다.

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/assistants/default_assistant/agents/AGENT_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입니다.
  • AGENT_ID: 구성하려는 에이전트의 ID입니다.

다음 단계