Gemini Code Assist स्टैंडर्ड और एंटरप्राइज़ लॉगिंग को कॉन्फ़िगर करना

इस दस्तावेज़ में, Google API कंसोल या किसी एपीआई का इस्तेमाल करके, किसी प्रोजेक्ट के लिए Gemini Code Assist के स्टैंडर्ड और एंटरप्राइज़ लॉगिंग को कॉन्फ़िगर करने का तरीका बताया गया है.

सीमाएं

Google Cloud में Gemini Standard और Enterprise के लॉग डेटा को रिकॉर्ड करने की सुविधा, IDE में Gemini Code Assist के साथ उपयोगकर्ता के इंटरैक्शन तक ही सीमित है.

इसके अलावा, अगर उपयोगकर्ता ने VS Code का टेलीमेट्री ट्रैकिंग की सुविधा बंद कर दी है, तो Gemini for Google Cloud, Gemini Code Assist Standard और Enterprise के लिए डेटा को लॉग नहीं करता.

शुरू करने से पहले

पक्का करें कि आपका Google Cloud प्रोजेक्ट, किसी बिलिंग खाते से जुड़ा हो.

(ज़रूरी नहीं) IAM अनुमतियां देना

Gemini Code Assist के स्टैंडर्ड और एंटरप्राइज़ वर्शन में लॉगिंग को कॉन्फ़िगर करने के लिए, आपके पास पहचान और ऐक्सेस मैनेजमेंट से जुड़ी खास अनुमतियां होनी चाहिए. इन अनुमतियों के बारे में यहां बताया गया है. पक्का करें कि ये अनुमतियां, कस्टम आईएएम भूमिकाओं में जोड़ी गई हों.

इसके अलावा, Gemini for Google Cloud की सेटिंग एडमिन (roles/cloudaicompanion.settingsAdmin) आईएएम की पहले से तय भूमिका को असाइन किया जा सकता है. इसमें, Gemini for Google Cloud के एडमिन की सभी सेटिंग के साथ काम करने के लिए ज़रूरी सभी अनुमतियां शामिल होती हैं.

(ज़रूरी नहीं) अनुमतियों को सेटिंग और टारगेट से जोड़ना

अगर Google API Console में Gemini Code Assist के स्टैंडर्ड और एंटरप्राइज़ एडमिन सेटिंग को कॉन्फ़िगर किया जा रहा है, तो इस सेक्शन को छोड़ा जा सकता है.

Gemini for Google Cloud API की मदद से, Gemini Code Assist स्टैंडर्ड और एंटरप्राइज़ एडमिन सेटिंग को कॉन्फ़िगर करने के लिए, आपको सबसे पहले सेटिंग बनानी होंगी. इसके बाद, उन सेटिंग और टारगेट (जैसे, इंस्टेंस, विषय या प्रोजेक्ट) को "बाइंड" करने के लिए बाइंडिंग बनानी होंगी. ये टारगेट, Gemini Cloud Assist या Gemini Code Assist जैसे खास प्रॉडक्ट के लिए होते हैं.

सेटिंग बनाने और अपडेट करने की सभी अनुमतियां, प्रोजेक्ट लेवल पर होती हैं.

Gemini Code Assist की लॉगिंग कॉन्फ़िगर करना

नीचे दिए गए सेक्शन में, Cloud Logging में Gemini Code Assist Standard और Enterprise की गतिविधि को इकट्ठा और सेव करने के लिए ज़रूरी चरण बताए गए हैं. इनमें ये चरण शामिल हैं:

  • Gemini Code Assist के स्टैंडर्ड और Enterprise वर्शन के प्रॉम्प्ट और जवाबों के लॉग. जैसे, उपयोगकर्ता का इनपुट, संदर्भ के हिसाब से जानकारी, और जवाब.

  • Gemini Code Assist स्टैंडर्ड और Enterprise के मेटाडेटा लॉग, जैसे कि उपयोगकर्ता की अनुमति वाली कोड की लाइनें और टेलीमेट्री मेटाडेटा.

दोनों तरह के लॉग के बारे में ज़्यादा जानकारी के लिए, Gemini लॉग देखें लेख पढ़ें.

Gemini Code Assist के लिए लॉगिंग की सुविधा चालू करना

निम्न विकल्पों में से कोई एक चुनें:

कंसोल

  1. पक्का करें कि आपने प्रोजेक्ट में, Cloud Logging एपीआई को चालू किया हो.

  2. पक्का करें कि आपके पास उस प्रोजेक्ट के लिए, पहचान और ऐक्सेस मैनेजमेंट से जुड़ी ये अनुमतियां हों जिस पर सदस्यता का मालिकाना हक है:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings
  3. एपीआई कंसोल में, Gemini के लिए एडमिन पेज पर जाएं.

    Gemini for Google Cloud पर जाना

    Gemini for Google Cloud पेज लोड हो जाता है.

  4. बाईं ओर मौजूद नेविगेशन मेन्यू में, सेटिंग पर क्लिक करें.

    सेटिंग पेज लोड हो जाता है.

  5. (ज़रूरी नहीं) प्रोजेक्ट में Gemini Code Assist Standard और Enterprise के उपयोगकर्ताओं से जनरेट किए गए मेटाडेटा को रिकॉर्ड करने के लिए, Code Assist के मेटाडेटा के लिए लॉगिंग पर क्लिक करें.

  6. (ज़रूरी नहीं) प्रोजेक्ट में, Gemini Code Assist Standard और Enterprise के उपयोगकर्ताओं से जनरेट किए गए प्रॉम्प्ट और जवाब रिकॉर्ड करने के लिए, Code Assist के प्रॉम्प्ट और जवाबों को लॉग करना पर क्लिक करें.

  7. बदलाव सेव करें पर क्लिक करें.

एपीआई

Gemini Code Assist Standard और Enterprise के लिए लॉगिंग की सुविधा चालू करने के लिए, loggingSetting तरीके का इस्तेमाल करें.

  1. पक्का करें कि आपने प्रोजेक्ट में, Cloud Logging एपीआई को चालू किया हो.

  2. पक्का करें कि आपके पास उस प्रोजेक्ट के लिए, पहचान और ऐक्सेस मैनेजमेंट से जुड़ी ये अनुमतियां हों जिसका मालिकाना हक सदस्यता के पास है:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings
  3. सेटिंग और सेटिंग के हिसाब से वैल्यू बनाएं:

    1. टोकन पाएं:

      TOKEN=$(gcloud auth print-access-token)
      
  4. Gemini Code Assist स्टैंडर्ड और Enterprise के मेटाडेटा लॉग चालू करें.

    1. सेटिंग बनाने के लिए, यह कमांड चलाएं:

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

      इनकी जगह ये डालें:

      • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी डालें.
      • SETTING_ID: सेटिंग का यूनीक नाम डालें, जैसे कि Gemini Code Assist log metadata के लिए gcalm1.

      अगर निर्देश पूरा हो जाता है, तो यह एक जवाब दिखाता है, जिसमें log_metadata को true पर सेट किया गया है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"
      

    इनकी जगह ये डालें:

    • TARGET_PROJECT_NAME: वह टारगेट प्रोजेक्ट डालें जिस पर सेटिंग लागू करनी है.
    • SETTING_ID: सेटिंग बनाते समय, उसी SETTING_ID का इस्तेमाल करें, लेकिन उसमें b1 जोड़ें. उदाहरण के लिए, Gemini Code Assist log metadata के लिए 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>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
    }
    
  5. Gemini Code Assist स्टैंडर्ड और Enterprise के उपयोगकर्ता के लॉग चालू करें.

    1. सेटिंग बनाने के लिए, यह कमांड चलाएं:

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

      इनकी जगह ये डालें:

      • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी डालें.
      • SETTING_ID: सेटिंग का यूनीक नाम डालें, जैसे कि Gemini Code Assist prompts and responses के लिए gcapar1.

      अगर निर्देश पूरा हो जाता है, तो यह एक जवाब दिखाता है, जिसमें log_prompts_and_responses को true पर सेट किया गया है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "log_prompts_and_responses": true
      }
      
    2. Gemini Code Assist Standard और Enterprise उपयोगकर्ता लॉग सेटअप करने के लिए, यह कमांड चलाएं:

      curl \
        -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/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"
      

    इनकी जगह ये डालें:

    • TARGET_PROJECT_NAME: वह टारगेट प्रोजेक्ट डालें जिस पर सेटिंग लागू करनी है.
    • SETTING_ID: सेटिंग बनाते समय, उसी SETTING_ID का इस्तेमाल करें, लेकिन उसमें b1 जोड़ें. उदाहरण के लिए, Gemini Code Assist prompts and responses के लिए gcaparb1 का इस्तेमाल करें.

    अगर कमांड काम करता है, तो यह ऑपरेशन का मेटाडेटा, यहां दिए गए फ़ॉर्मैट में दिखाता है:

    {
      "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>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
    }
    

Gemini Code Assist के लिए लॉगिंग की सुविधा बंद करना

निम्न विकल्पों में से कोई एक चुनें:

कंसोल

  1. पक्का करें कि आपके पास उस प्रोजेक्ट के लिए, पहचान और ऐक्सेस मैनेजमेंट से जुड़ी ये अनुमतियां हों जिस पर सदस्यता का मालिकाना हक है:

    • loggingSettings.delete
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsDelete
    • cloudaicompanion.settingBindings.loggingSettingsUse
    • cloudaicompanion.instances.queryEffectiveSettingBindings
  2. एपीआई कंसोल में, Gemini के लिए एडमिन पेज पर जाएं.

    Gemini for Google Cloud पर जाना

    Gemini for Google Cloud पेज लोड हो जाता है.

  3. बाईं ओर मौजूद नेविगेशन मेन्यू में, सेटिंग पर क्लिक करें.

    सेटिंग पेज लोड हो जाता है.

  4. प्रोजेक्ट में Gemini Code Assist Standard और Enterprise के इस्तेमाल से मेटाडेटा रिकॉर्ड करने की सुविधा बंद करने के लिए, Code Assist के मेटाडेटा के लिए लॉगिंग पर क्लिक करें.

  5. बदलाव सेव करें पर क्लिक करें.

एपीआई

Gemini Code Assist Standard और Enterprise के लिए लॉगिंग की सुविधा चालू करने के लिए, loggingSetting तरीके का इस्तेमाल करें.

  1. पक्का करें कि आपके पास उस प्रोजेक्ट के लिए, पहचान और ऐक्सेस मैनेजमेंट से जुड़ी ये अनुमतियां हों जिसका मालिकाना हक सदस्यता के पास है:

    • loggingSettings.create
    • loggingSettings.list
    • loggingSettings.update
    • loggingSettings.get
    • cloudaicompanion.instances.loggingSettings.use
    • cloudaicompanion.instances.queryEffectiveSetting
    • settingBindings.loggingSettingsList
    • settingBindings.loggingSettingsGet
    • settingBindings.loggingSettingsUpdate
    • settingBindings.loggingSettingsCreate
    • serviceusage.services.enable
  2. सेटिंग और सेटिंग के हिसाब से वैल्यू बनाएं:

    1. टोकन पाएं:

      TOKEN=$(gcloud auth print-access-token)
      
  3. Gemini Code Assist Standard और एंटरप्राइज़ मेटाडेटा लॉग की सेटिंग को बंद करने के लिए, यह कमांड चलाएं:

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

    इनकी जगह ये डालें:

    • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी डालें.
    • SETTING_ID: सेटिंग का मौजूदा नाम डालें, जैसे कि Gemini Code Assist log metadata के लिए gcalm1.

      अगर निर्देश पूरा हो जाता है, तो यह एक जवाब दिखाता है, जिसमें log_metadata को false पर सेट किया गया है:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/loggingSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "log_metadata": false
      }
      
  4. Gemini Code Assist Standard और Enterprise उपयोगकर्ता लॉग की सेटिंग को बंद करने के लिए, यह कमांड चलाएं:

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

    इनकी जगह ये डालें:

    • CONTAINER_PROJECT_NAME: पैरंट प्रोजेक्ट आईडी डालें.
    • SETTING_ID: सेटिंग का मौजूदा नाम डालें, जैसे कि Gemini Code Assist prompts and responses के लिए gcapar1.

      अगर निर्देश पूरा हो जाता है, तो यह एक जवाब दिखाता है, जिसमें log_prompts_and_responses को false पर सेट किया गया है:

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

आगे क्या करना है