Gemini Code Assist Standard 및 Enterprise 로깅 구성

콘솔

1. 프로젝트에서 Cloud Logging API를 사용 설정했는지 확인합니다.

2. 콘솔 Google Cloud 에서 Gemini 관리자 페이지로 이동합니다.

   Gemini 관리자로 이동

3. 왼쪽 탐색 메뉴에서 설정 을 클릭합니다.

4. (선택사항) Code Assist 메타데이터 로깅 을 클릭하여 프로젝트에서 Gemini Code Assist Standard 및 Enterprise 사용자가 생성한 메타데이터를 기록합니다.

5. (선택사항) Code Assist 프롬프트 및 응답 로깅 을 클릭하여 프로젝트에서 Gemini Code Assist Standard 및 Enterprise 사용자가 생성한 프롬프트와 대답을 기록합니다.

6. 변경사항 저장을 클릭합니다.

API

Gemini Code Assist Standard 및 Enterprise의 로깅을 사용 설정하려면 loggingSettings 리소스를 사용하여 원하는 로깅 설정을 정의하고 loggingSettings.settingBindings 리소스를 사용하여 설정을 프로젝트에 바인딩합니다.

1. 프로젝트에서 Cloud Logging API 를 사용 설정했는지 확인합니다.

2. 설정 및 설정별 값을 만듭니다.

   1. 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)
      

3. Gemini Code Assist Standard 및 Enterprise 로그를 사용 설정합니다. 사용자 로그와 메타데이터 로그는 각각 log_prompts_and_responses 및 log_metadata 필드를 사용하여 사용 설정됩니다. 필드 중 하나를 사용 설정하지 않으려면 요청에서 제외합니다.

   1. 다음 명령어를 실행하여 설정을 만듭니다.

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "log_prompts_and_responses": true,
          "log_metadata": true,
          } ' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings?logging_setting_id=LOGS_SETTING_ID"
      

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 바인딩 리소스가 저장된 프로젝트의 프로젝트 ID. 이는 바인딩의 상위 프로젝트입니다.
      • LOGS_SETTING_ID: 고유한 설정 이름(예: gcalm)

      명령어가 성공하면 log_prompts_and_responses와 log_metadata가 true로 설정된 응답 본문이 반환됩니다.

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "log_prompts_and_responses": true,
        "log_metadata": true
      }
      

   2. 다음 명령어를 실행하여 Gemini Code Assist Standard 및 Enterprise 로그 설정 바인딩을 만듭니다.

      curl -X POST \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
          "target": "projects/TARGET_PROJECT_NAME"
          }' \
        "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/LOGS_SETTING_ID/settingBindings?setting_binding_id=LOGS_BINDING_ID"
      

   다음을 바꿉니다.

   • TARGET_PROJECT_NAME: 바인딩을 바인딩할 대상 프로젝트. 컨테이너 프로젝트와 동일한 경우가 많습니다. 하지만 설정 리소스가 중복되지 않도록 설정을 여러 프로젝트에 바인딩할 수 있습니다.
   • LOGS_BINDING_ID: 설정을 만들 때와 동일한 SETTING_ID를 사용하지만 b1을 추가합니다. 예를 들어, gcalmb1을 사용합니다.

   명령어가 성공하면 다음 형식의 작업 메타데이터가 반환됩니다.

   {
     "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
       "createTime": "2025-01-23T15:27:50.076075570Z",
       "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/loggingSettings/<var>LOGS_SETTING_ID</var>/settingBindings/<var>LOGS_BINDING_ID</var>",
       "verb": "create",
       "requestedCancellation": false,
       "apiVersion": "v1"
     },
     "done": false
   }
   

콘솔

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

   Gemini 관리자로 이동

2. 왼쪽 탐색 메뉴에서 설정 을 클릭합니다.

3. Code Assist 메타데이터 로깅 을 클릭하여 프로젝트에서 Gemini Code Assist Standard 및 Enterprise 사용량의 메타데이터 기록을 사용 중지합니다.

4. 변경사항 저장을 클릭합니다.

API

Gemini Code Assist Standard 및 Enterprise의 로깅을 사용 중지하려면 loggingSetting 메서드를 사용합니다.