‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

צפייה ביומנים של Gemini Code Assist

במאמר הזה מוסבר איך להפעיל את האיסוף והאחסון של פעילות ב-Gemini Code Assist, כולל:

יומני פרומפטים ותשובות של Gemini Code Assist, כמו קלט של משתמשים, מידע הקשרי ותשובות.
יומני מטא נתונים של Gemini Code Assist, כמו מטא נתונים של טלמטריה ושורות קוד שהמשתמש אישר.

אם אתם צריכים ליצור מדדים של Gemini Code Assist, תוכלו לעיין במאמר בנושא מעקב אחרי השימוש ב-Gemini Code Assist.

‫Gemini Code Assist לא אוסף ולא שולח ל-Cloud Logging אינטראקציות אחרות של המשתמש עם Gemini Code Assist, כולל משוב בכתב. הנתונים שנאספים נשלחים ל-Cloud Logging לאחסון. כדי לבדוק את הנתונים האלה, מחפשים רשומות ביומן עם סוג המשאב cloudaicompanion.googleapis.com/Instance.

התכונה הזו לא מתעדת הנחיות או תשובות ב-Gemini ב-Vertex AI. הסבר על הפעלת יומנים של Gemini ב-Vertex AI מופיע במאמר הפעלת יומני ביקורת של גישה לנתונים.

תפקידים בניהול זהויות והרשאות גישה (IAM) קובעים את היכולת של גורם ראשי לגשת ליומנים. אפשר להעניק תפקידים מוגדרים מראש לישויות, או ליצור תפקידים בהתאמה אישית. מידע נוסף על ההרשאות הנדרשות זמין במאמר בנושא בקרת גישה.

כברירת מחדל, ב-Cloud Logging התוכן של הלקוחות שמאוחסן במצב מנוחה מוצפן. נתונים שמאוחסנים בדלי יומנים על ידי Logging מוצפנים באמצעות מפתחות להצפנת מפתחות, בתהליך שנקרא הצפנת מעטפה. כדי לגשת לנתוני הרישום שלכם, צריך גישה למפתחות ההצפנה של המפתחות האלה, ש-Google מנהלת בשבילכם בלי שתצטרכו לבצע פעולות כלשהן.

יכול להיות שהארגון שלכם מחויב לעמוד בדרישות רגולטוריות או בדרישות שקשורות לתאימות, או בדרישות מתקדמות להצפנה, שלא מסופקות על ידי הצפנה במנוחה כברירת מחדל. כדי לעמוד בדרישות הארגון, אתם יכולים לנהל את מפתחות ההצפנה שמגנים על הנתונים שלכם במקום ש-Google תנהל אותם.

מידע ספציפי על השימוש במפתחות הצפנה בניהול הלקוח (CMEK), כולל יתרונות ומגבלות, זמין במאמר מפתחות הצפנה בניהול הלקוח.

מגבלות

התיעוד של נתוני היומן ב-Gemini Code Assist מוגבל לאינטראקציות של משתמשים עם Gemini Code Assist בסביבת פיתוח משולבת (IDE).
כברירת מחדל, יומני Gemini Code Assist נאספים על בסיס כל פרויקט. הוראות להגדרת פרויקט מרכזי לאיסוף יומנים מכמה פרויקטים זמינות במאמר הגדרת רישום ביומן של כמה פרויקטים.

לפני שמתחילים

כדי לקבל את ההרשאות שנדרשות לצפייה ביומני Gemini Code Assist, צריך לבקש מהאדמין להקצות לכם את התפקיד Logs Viewer (‏roles/logging.viewer) ב-IAM לפרויקט. כדי לקרוא הסבר על מתן תפקידים, ראו איך מנהלים את הגישה ברמת הפרויקט, התיקייה והארגון.

יכול להיות שאפשר לקבל את ההרשאות הנדרשות גם באמצעות תפקידים בהתאמה אישית או תפקידים מוגדרים מראש.
כדאי לעיין בתמחור של Cloud Logging ובתמחור של Gemini Code Assist.
הפעלת רישום ביומן של Gemini Code Assist.

צפייה ביומני משתמשים ובמטא-נתונים של Gemini Code Assist

כדי לראות את יומני המשתמשים ואת יומני המטא-נתונים של Gemini Code Assist, מבצעים אחת מהפעולות הבאות:

המסוף

במסוף Google Cloud , נכנסים לדף Logs Explorer:
כניסה אל Logs Explorer

אם משתמשים בסרגל החיפוש כדי למצוא את הדף הזה, בוחרים בתוצאה שכותרת המשנה שלה היא Logging.
בסרגל הכלים, בוחרים פרויקט במסוף Google Cloud .
בסרגל הכלים, מרחיבים את התפריט All resources ובוחרים במשאב Cloud AI Companion Instance.

gcloud

מריצים את הפקודה הבאה:

gcloud logging read "resource.type=cloudaicompanion.googleapis.com/Instance" --project PROJECT_ID  --limit 3

מחליפים את PROJECT_ID במזהה הפרויקט שרוצים לראות את היומנים של Gemini Code Assist שלו.

API

יוצרים קובץ JSON שמכיל את הפרטים הבאים:
```
  {
    "resourceNames": [
      "projects/PROJECT_ID"
    ],
    "pageSize": 5,
    "filter": "resource.type: cloudaicompanion.googleapis.com/Instance"
  }
```
מחליפים את הערך PROJECT_ID במזהה הפרויקט שרוצים לראות את היומנים שלו ב-Gemini Code Assist.

קבלת טוקן אימות:

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

משתמשים ב-cURL כדי לשלוח קריאה ל-entries.list:
```
curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  "https://logging.googleapis.com/v2/entries:list"
```
מחליפים את JSON_FILE_NAME בנתיב לקובץ JSON שיצרתם בשלב הקודם.

מידע נוסף על אימות זמין במאמר אימות לשימוש ב-REST.

התשובה מחזירה קבוצה של רשומות ביומן.

יומנים של Gemini Code Assist

LogEntry היא יחידת הנתונים הבסיסית ב-Cloud Logging. בקטעים הבאים מפורטים השדות שמופיעים ב-LogEntry עבור אירוע פלטפורמה של Gemini Code Assist, כמו בקשות משתמשים ותשובות של Gemini Code Assist.

בקשות ממשתמשים

בטבלה הבאה מופיעה רשימה של שדות שנמצאים ברשומה ביומן של בקשת משתמש:

שדה	ערכים והערות
`LogEntry.resource.type`	סוג המשאב של Gemini Code Assist: ‏ `cloudaicompanion.googleapis.com/Instance`.
`LogEntry.resource.labels.resource_container`	המזהה הייחודי של מאגר המשאבים שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.resource.labels.location`	המיקום שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.resource.labels.instance_id`	המזהה הייחודי של המשאב שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.labels.method`	יכול להיות אחד מהערכים הבאים, בהתאם למה שהפעיל את `logEntry`: `CompleteTask`: לדוגמה, בקשת צ'אט מ-Gemini Code Assist. `GenerateCode`: לדוגמה, בקשה ליצירת קוד, כמו בקשת שינוי קוד ב-Gemini Code Assist. `CompleteCode`: לדוגמה, בקשה להשלמת קוד כשעובדים בסביבת הפיתוח המשולבת (IDE), כמו הצעות מוטבעות ב-Gemini Code Assist.
`LogEntry.labels.product`	שם השירות שהיומן חל עליו. יומנים שרלוונטיים לשימוש ב-Gemini Code Assist משתמשים בערך המוצר `code_assist`. אם היומן רלוונטי ל-Gemini Cloud Assist, הערך הוא `cloud_assist`. אחרת, הערך הוא `unknown`.
`LogEntry.labels.request_id`	מזהה ייחודי שמאפשר לקשר בין בקשה לבין רשומה ביומן התגובות.
`LogEntry.labels.user_id`	המזהה של המשתמש שיזם את הבקשה הזו.
`LogEntry.jsonPayload`	המטען הייעודי (Payload) של הרשומה ביומן.
`LogEntry.logName`	מזהה את היומן.

בדוגמה הבאה מוצגת רשומה ביומן לאירוע של הנחיה בצ'אט:

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "user@company.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "taskCompletionRequest":
      input: {
        messages: [{
          author: "USER"
          content: "What are some best practices to save cost on my Google Cloud bill?"
        }]
        preamble: ""
      }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

בדוגמה הבאה מוצגת רשומה RequestLog של הנחיות להצעות קוד מוטמעות אוטומטיות ושל הנחיות ל-Gemini Code Assist בקובץ קוד.

נתוני ההנחיות להצעות קוד מוטבעות משתמשים באובייקט codeCompletionRequest (כפי שמוצג בדוגמה הבאה), בעוד שיצירה שמופעלת באופן ידני משתמשת ב-codeGenerationRequest.

{
  "insertId": "654581e30003b19e340bbd96",
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
        instance_id: "default"
        location: "global"
        resource_container: "my-project-id"
     }
  },
  "timestamp": "2023-11-03T23:27:31.242078Z",
  "labels": {
    "product": "code_assist",
    "request_id": "4ea1e265-ea5d-4d11-b3c8-39bad9c96326"
    "user_id": "user@company.com"
  },
  "jsonPayload" : {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
    "codeCompletionRequest": {
      "input_data_context": {
        "additional_context": {
          "files": [
            {
              "language": "go",
              "path": "{/path/to/../current-file.go",
              "segments": [
                {
                  "content": "...Prefix Text..."
                },
                {
                  "content": "...Suffix Text..."
                }
              ],
              "state": ["EDITED"]
            },
            {
              "language": "go",
              "path": "/path/to/../recent-file.go",
              "segments": [
                {
                  "content": "...File Text..."
                }
              ],
              "state": ["RECENTLY_OPENED"]
            }
          ]
        }
      }
    }
  }
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2023-11-03T23:27:31.255648319Z"
  "severity": "INFO"
}

יומני אינטראקציות עם נציג תמיכה

חלק מהאינטראקציות עם Gemini יכולות ליצור כמה רשומות ביומן (בקשה, תשובה ומטא-נתונים) עבור פעולת משתמש אחת. דוגמאות לאינטראקציות כאלה:

סוכן שמבצע משימה שכוללת שימוש בכלי (לדוגמה, המודל מפעיל פונקציות פנימיות כמו read_file או replace, כפי שמוצג בדוגמאות של היומן).
סוכן שמקיים אינטראקציה עם סוכנים אחרים.

רשומה ביומן הבקשות

בדוגמה הבאה מוצגת רשומה ביומן עבור בקשה שמתחילה אינטראקציה עם סוכן:

{
  "insertId": "qe9xxub2r",
  "jsonPayload": {
    "taskCompletionRequest": {
      "input": {
        "messages": [
          {
            "author": "USER",
            "content": "hi can you add one test here\nCurrent File Path:\n```cpp\n/usr/local/google/home/pdec/test.cpp\n```\n\n"
          }
        ],
        "preamble": ""
      }
    },
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "resource_container": "my-project-id",
      "instance_id": "default",
      "location": "global"
    }
  },
  "timestamp": "2025-10-08T10:09:52.225165428Z",
  "severity": "INFO",
  "labels": {
    "request_id": "e60facb1485b17b7",
    "client_version": "unknown",
    "product": "code_assist",
    "method": "CompleteTask",
    "user_id": "user@company.com",
    "client_name": "cloudcode_cli"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2025-10-08T10:09:52.581787548Z"
}

רשומה ביומן התשובות

בדוגמה הבאה מוצגת רשומה ביומן התגובות מאינטראקציה עם סוכן שכוללת כמה הודעות:

{
  "insertId": "qe9xxub2t",
  "jsonPayload": {
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.ResponseLog",
    "taskCompletionResponse": {
      "output": {
        "messages": [
          {
            "content": "**Reading File Contents**\n\nI'm currently focused on reading the contents of `/usr/local/google/home/pdec/test.cpp`. This will inform what kind of test needs to be written and how it should be structured.\n\n\n",
            "author": "MODEL"
          },
          {
            "author": "MODEL",
            "content": "**File Inspection Begins**\n\nI've initiated the process of reading the test file. My immediate goal is to grasp its existing structure and identify the testing framework, if one exists. This will directly influence the design of the new test case I'll be adding.\n\n\n"
          },
          {
            "author": "MODEL",
            "content": "Of course. What is the test about? I'll read the file to understand the context."
          },
          {
            "content": "read_file({\"absolute_path\":\"/usr/local/google/home/pdec/test.cpp\"})",
            "author": "MODEL"
          }
        ]
      }
    }
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "resource_container": "my-project-id",
      "instance_id": "default",
      "location": "global"
    }
  },
  "timestamp": "2025-10-08T10:09:52.227354297Z",
  "severity": "INFO",
  "labels": {
    "product": "code_assist",
    "request_id": "e60facb1485b17b7",
    "user_id": "user@company.com",
    "client_version": "unknown",
    "method": "CompleteTask",
    "client_name": "cloudcode_cli"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fresponse",
  "receiveTimestamp": "2025-10-08T10:09:52.581787548Z"
}

רשומה ביומן של מטא-נתונים

בדוגמה הבאה מוצגת רשומה ביומן של מטא-נתונים מאינטראקציה עם נציג:

{
  "insertId": "qe9xxub2s",
  "jsonPayload": {
    "apiRequest": {},
    "clientName": "cloudcode_cli",
    "requestId": "e60facb1485b17b7",
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog",
    "clientVersion": "unknown"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "location": "global",
      "instance_id": "default",
      "resource_container": "my-project-id"
    }
  },
  "timestamp": "2025-10-08T10:09:52.226420727Z",
  "severity": "INFO",
  "labels": {
    "method": "CompleteTask",
    "product": "code_assist",
    "user_id": "user@company.com"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata",
  "receiveTimestamp": "2025-10-08T10:09:52.581787548Z"
}

בדוגמאות הבאות מוצגת דוגמה נוספת של רשומות ביומן לאינטראקציה עם נציג, עם מזהה בקשה 4b66a582bad9cf2c:

רשומה ביומן הבקשות

{
  "insertId": "4qvt8nb2k",
  "jsonPayload": {
    "taskCompletionRequest": {
      "input": {
        "messages": [
          {
            "author": "USER",
            "content": "FunctionResponse{name: read_file, response: {\"output\":\"#include <iostream>\\n\\n// Function to calculate the greatest common divisor (GCD) of two numbers.\\nint gcd(int a, int b) {\\n    if (b == 0) {\\n        return a;\\n    }\\n    return gcd(b, a % b);\\n}\\n\\n// Function to calculate the least common multiple (LCM) of two numbers.\\nint lcm(int a, int b) {\\n    return (a * b) / gcd(a, b);\\n}\\n\\n// Function to check if a number is prime.\\nint is_prime(int a) {\\n    if (a < 2) {\\n        return 0;\\n    }\\n    for (int i = 2; i * i <= a; ++i) {\\n        if (a % i == 0) {\\n            return 0;\\n        }\\n    }\\n    return 1;\\n}\\n\\n// Function for extended Euclidean algorithm.\\nint extended_gcd(int a, int b, int &x, int &y) {\\n    if (b == 0) {\\n        x = 1;\\n        y = 0;\\n        return a;\\n    }\\n    int x1, y1;\\n    int d = extended_gcd(b, a % b, x1, y1);\\n    x = y1;\\n    y = x1 - (a / b) * y1;\\n    return d;\\n}\\n\\n// Test function\\nvoid run_tests() {\\n    // Test gcd\\n    if (gcd(10, 15) == 5) {\\n        std::cout << \\\"gcd(10, 15) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(10, 15) failed\\\" << std::endl;\\n    }\\n\\n    // Test lcm\\n    if (lcm(10, 15) == 30) {\\n        std::cout << \\\"lcm(10, 15) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"lcm(10, 15) failed\\\" << std::endl;\\n    }\\n\\n    // Test is_prime\\n    if (is_prime(7) == 1) {\\n        std::cout << \\\"is_prime(7) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(7) failed\\\" << std::endl;\\n    }\\n    if (is_prime(10) == 0) {\\n        std::cout << \\\"is_prime(10) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(10) failed\\\" << std::endl;\\n    }\\n\\n    // Test extended_gcd\\n    int x, y;\\n    int g = extended_gcd(35, 15, x, y);\\n    if (g == 5 && 35 * x + 15 * y == g) {\\n        std::cout << \\\"extended_gcd(35, 15) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"extended_gcd(35, 15) failed\\\" << std::endl;\\n    }\\n\\n    // Test is_prime with 1\\n    if (is_prime(1) == 0) {\\n        std::cout << \\\"is_prime(1) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(1) failed\\\" << std::endl;\\n    }\\n\\n    // Test is_prime with 9\\n    if (is_prime(9) == 0) {\\n        std::cout << \\\"is_prime(9) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(9) failed\\\" << std::endl;\\n    }\\n\\n    // Test is_prime with 13\\n    if (is_prime(13) == 1) {\\n        std::cout << \\\"is_prime(13) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(13) failed\\\" << std::endl;\\n    }\\n\\n    // Test lcm with 7 and 9\\n    if (lcm(7, 9) == 63) {\\n        std::cout << \\\"lcm(7, 9) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"lcm(7, 9) failed\\\" << std::endl;\\n    }\\n\\n    // Test gcd with 12 and 18\\n    if (gcd(12, 18) == 6) {\\n        std::cout << \\\"gcd(12, 18) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(12, 18) failed\\\" << std::endl;\\n    }\\n\\n    // Test gcd with two primes\\n    if (gcd(7, 13) == 1) {\\n        std::cout << \\\"gcd(7, 13) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(7, 13) failed\\\" << std::endl;\\n    }\\n\\n    // Test is_prime with 97\\n    if (is_prime(97) == 1) {\\n        std::cout << \\\"is_prime(97) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"is_prime(97) failed\\\" << std::endl;\\n    }\\n\\n    // Test extended_gcd with 48 and 18\\n    int x2, y2;\\n    int g2 = extended_gcd(48, 18, x2, y2);\\n    if (g2 == 6 && 48 * x2 + 18 * y2 == g2) {\\n        std::cout << \\\"extended_gcd(48, 18) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"extended_gcd(48, 18) failed\\\" << std::endl;\\n    }\\n\\n    // Test gcd with 27 and 18\\n    if (gcd(27, 18) == 9) {\\n        std::cout << \\\"gcd(27, 18) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(27, 18) failed\\\" << std::endl;\\n    }\\n    // test 999 and 123\\n    if (gcd(999, 123) == 3) {\\n        std::cout << \\\"gcd(999, 123) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(999, 123) failed\\\" << std::endl;\\n    }\\n    \\n    \\n}\\n\\nint main() {\\n    run_tests();\\n    return 0;\\n}\"}}"
          }
        ],
        "preamble": ""
      }
    },
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.RequestLog"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "resource_container": "my-project-id",
      "instance_id": "default",
      "location": "global"
    }
  },
  "timestamp": "2025-10-08T10:10:03.457717366Z",
  "severity": "INFO",
  "labels": {
    "request_id": "4b66a582bad9cf2c",
    "method": "CompleteTask",
    "client_version": "unknown",
    "product": "code_assist",
    "client_name": "cloudcode_cli",
    "user_id": "user@company.com"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Frequest",
  "receiveTimestamp": "2025-10-08T10:10:03.606059154Z"
}

רשומה ביומן התגובות

{
  "insertId": "4qvt8nb2m",
  "jsonPayload": {
    "taskCompletionResponse": {
      "output": {
        "messages": [
          {
            "author": "MODEL",
            "content": "**Testing the functions**\\n\\nI'm focusing on adding a new test case to `test.cpp`.  The existing `run_tests` function is a great starting point. I'm considering which function to test further – maybe `extended_gcd`? I'll review the current tests for that function and then devise a new test scenario to add.\\n\\n\\n"
          },
          {
            "author": "MODEL",
            "content": "**Evaluating LCM Test**\\n\\nI've finalized the new test case for the `lcm` function within the `test.cpp` file.  I'm adding a test for `lcm(12, 18)` to confirm the result is 36. I plan to use the `replace` command to inject this new test directly before the closing brace of the `run_tests` function.  I've identified a unique line in `test.cpp` as the anchor for replacement.\\n\\n\\n"
          },
          {
            "author": "MODEL",
            "content": "**Inserting the new test**\\n\\nI've created a test case for `lcm(12, 18)`, confirming the expected result of 36. To implement this, I'm targeting the `run_tests` function.  I'll use the `replace` command and will search the end of the `run_tests` function to inject the new test, right before the closing brace.  I'm ready to implement this and confirm that it passes.\\n\\n\\n"
          },
          {
            "author": "MODEL",
            "content": "I've reviewed the file. I'll add a test case for the `lcm` function with inputs 12 and 18."
          },
          {
            "content": "replace({\"file_path\":\"/usr/local/google/home/pdec/test.cpp\",\"instruction\":\"add a test for the lcm function with 12 and 18\",\"new_string\":\"    // test 999 and 123\\n    if (gcd(999, 123) == 3) {\\n        std::cout << \\\"gcd(999, 123) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(999, 123) failed\\\" << std::endl;\\n    }\\n    \\n    // Test lcm with 12 and 18\\n    if (lcm(12, 18) == 36) {\\n        std::cout << \\\"lcm(12, 18) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"lcm(12, 18) failed\\\" << std::endl;\\n    }\\n    \\n}\",\"old_string\":\"    // test 999 and 123\\n    if (gcd(999, 123) == 3) {\\n        std::cout << \\\"gcd(999, 123) passed\\\" << std::endl;\\n    } else {\\n        std::cout << \\\"gcd(999, 123) failed\\\" << std::endl;\\n    }\\n    \\n    \\n}\"})",
            "author": "MODEL"
          }
        ]
      }
    },
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.ResponseLog"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "location": "global",
      "resource_container": "my-project-id",
      "instance_id": "default"
    }
  },
  "timestamp": "2025-10-08T10:10:03.461137399Z",
  "severity": "INFO",
  "labels": {
    "client_name": "cloudcode_cli",
    "client_version": "unknown",
    "method": "CompleteTask",
    "request_id": "4b66a582bad9cf2c",
    "product": "code_assist",
    "user_id": "user@company.com"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fresponse",
  "receiveTimestamp": "2025-10-08T10:10:03.606059154Z"
}

רשומה ביומן המטא-נתונים

{
  "insertId": "4qvt8nb2l",
  "jsonPayload": {
    "clientVersion": "unknown",
    "apiRequest": {},
    "clientName": "cloudcode_cli",
    "requestId": "4b66a582bad9cf2c",
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "resource_container": "my-project-id",
      "location": "global",
      "instance_id": "default"
    }
  },
  "timestamp": "2025-10-08T10:10:03.459902984Z",
  "severity": "INFO",
  "labels": {
    "product": "code_assist",
    "user_id": "user@company.com",
    "method": "CompleteTask"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata",
  "receiveTimestamp": "2025-10-08T10:10:03.606059154Z"
}

תשובות של Gemini Code Assist

בטבלה הבאה מוצגים שדות התשובה של Gemini Code Assist והתיאורים שלהם:

שדה	ערכים והערות
`LogEntry.resource.type`	סוג המשאב של Gemini Code Assist: ‏ `cloudaicompanion.googleapis.com/Instance`.
`LogEntry.resource.labels.resource_container`	המזהה הייחודי של מאגר המשאבים שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.resource.labels.location`	המיקום שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.resource.labels.instance_id`	המזהה הייחודי של המשאב שבו נעשה שימוש ב-Gemini Code Assist.
`LogEntry.labels.method`	יכול להיות אחד מהערכים הבאים, בהתאם למה שהפעיל את `logEntry`: `CompleteTask`: לדוגמה, בקשת צ'אט מ-Gemini Code Assist. `GenerateCode`: לדוגמה, בקשה ליצירת קוד, כמו בקשת שינוי קוד ב-Gemini Code Assist. `CompleteCode`: לדוגמה, בקשה להשלמת קוד כשעובדים בסביבת הפיתוח המשולבת (IDE), כמו הצעות מוטבעות ב-Gemini Code Assist.
`LogEntry.labels.product`	שם השירות שהיומן חל עליו. יומנים שרלוונטיים לשימוש ב-Gemini Code Assist משתמשים בערך המוצר `code_assist`. אם היומן רלוונטי ל-Gemini Cloud Assist, הערך הוא `cloud_assist`. אחרת, הערך הוא `unknown`.
`LogEntry.labels.request_id`	מזהה ייחודי שמאפשר לקשר בין בקשה לבין רשומה ביומן התגובות.
`LogEntry.labels.user_id`	המזהה של המשתמש שיזם את הבקשה הזו.
`LogEntry.jsonPayload`	המטען הייעודי (Payload) של הרשומה ביומן. כל ציטוטי המקור ששימשו ליצירת התשובה נכללים באובייקט הזה בתור `attribution_context`.
`LogEntry.logName`	מזהה את היומן.

יומני מטא-נתונים של Gemini Code Assist

כדי שיופקו יומני המטא-נתונים, צריך להפעיל את הגדרת הטלמטריה של התוסף Gemini Code Assist בתוספים של VS Code ושל IntelliJ.

יומני המטא-נתונים של Gemini Code Assist הם בעלי מבנה זהה לזה של יומני Gemini Code Assist, אבל הם מציינים שדות שונים. בטבלה הבאה מופיעה רשימה של שדות שנמצאים ברשומה ביומן של בקשת משתמש:

שדה	ערכים והערות
`LogEntry.@type`	סוג המשאב של מטא-נתונים ב-Gemini Code Assist: ‏ `type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog`.
`LogEntry.labels.method`	במקרה של יומני מטא-נתונים, ערך התווית הוא `Export.Metrics`.
`LogEntry.labels.product`	שם השירות שהיומן חל עליו. יומנים שרלוונטיים לשימוש ב-Gemini Code Assist משתמשים בערך המוצר `code_assist`. אם היומן רלוונטי ל-Gemini Cloud Assist, הערך הוא `cloud_assist`. אחרת, הערך הוא `unknown`.
`LogEntry.labels.user_id`	המזהה של המשתמש שיזם את הבקשה הזו.
`LogEntry.jsonPayload`	מציין אם מדובר באירוע `codeExposure` או באירוע `code.Acceptance`. אירוע `codeExposure` מציין חשיפה של הצעה לקוד למשתמש. אירוע `code.Acceptance` מציין שהמשתמש ביצע פעולת אישור כלשהי, כמו הקלדה, הקשה על Tab או אישור מלא.
`LogEntry.jsonPayload.clientName`	שם סביבת הפיתוח המשולבת, למשל `CloudCodeVscode`.
`LogEntry.jsonPayload.clientVersion`	מספר הגרסה של ה-IDE.
`LogEntry.jsonPayload.codeAcceptance`	במערכות VS Code ו-IntelliJ IDE בלבד, הערך הזה מציין שהמשתמש ביצע פעולת הסכמה כלשהי, כמו הקלדה, הקשה על Tab או הסכמה מלאה. הוא כולל גם את השדות הבאים: `linesCount`: המספר הכולל של שורות הקוד שהמשתמש אישר. ‫`commentLinesCount`: מספר שורות ההערות בקוד שהמשתמש אישר. המאפיין הזה מופיע רק אם Gemini Code Assist יכול לקבוע כמה מהשורות שאושרו הן שורות של הערות. ‫`originalRequestId`: מזהה שמקשר אירוע `codeExposure` לאפס או יותר אירועים מסוג `codeAcceptance`. אפשר להשתמש בנתונים האלה כדי לחשב את המדדים שיעור האישור ושורות קוד שאושרו. ‫`programmingLanguage`: שפת התכנות של הקוד שאושר, כמו `python`.
`LogEntry.jsonPayload.codeExposure`	לסביבות פיתוח משולבות (IDE) של VS Code ו-IntelliJ בלבד, מציין שהייתה חשיפה של הצעה לקוד למשתמש. הוא כולל גם את השדות הבאים: ‫`programmingLanguage`: שפת התכנות של החשיפה, למשל `python`. ‫`originalRequestId`: מזהה שמקשר אירוע `codeExposure` לאפס או יותר אירועים מסוג `codeAcceptance`. אפשר להשתמש בנתונים האלה כדי לחשב את המדדים שיעור האישור ושורות קוד שאושרו.
`LogEntry.jsonPayload.chatExposure`	מציין שהייתה חשיפה של תשובה בצ'אט למשתמש. הוא כולל גם את השדות הבאים: ‫`originalRequestId`: מזהה שמקשר אירוע `chatExposure` לאפס או יותר אירועים מסוג `chatAcceptance`. אפשר להשתמש בנתונים האלה כדי לחשב את המדדים שיעור ההסכמה לשימוש בצ'אט ומספר השורות בצ'אט שאושרו. ‫`is_agentic`: מזהה שמציין אם chatExposure מגיע ממצב סוכן. אפשר להשתמש בנתונים האלה כדי להבחין בין שיעור קבלת הצ'אט ומספר שורות הקוד שהתקבלו במצב Agent לבין אלה שלא במצב Agent.
`LogEntry.jsonPayload.chatAcceptance`	מציין שהמשתמש ביצע אירוע אישור כלשהו בבלוקים של הקוד בתגובה בצ'אט. הוא כולל גם את השדות הבאים: ‫`interactionType`: סוג האינטראקציה שהייתה למשתמש עם בלוק הקוד, כמו `ACCEPT_CODE_BLOCK`. ‫`programmingLanguage`: שפת התכנות של הקוד שאושר, כמו `python`. `linesCount`: המספר הכולל של שורות הקוד שהמשתמש אישר. ‫`originalRequestId`: מזהה שמקשר אירוע `chatExposure` לאפס או יותר אירועים מסוג `chatAcceptance`. ‫`is_agentic`: מזהה שמציין אם האישור של הצ'אט הגיע ממצב סוכן. אפשר להשתמש בנתונים האלה כדי להבחין בין שיעור קבלת הצ'אט ומספר שורות הקוד שהתקבלו במצב Agent לבין אלה שלא במצב Agent.

בדוגמה הבאה אפשר לראות רשומה ביומן codeExposure:

{
  insertId: "whfrqgc1gj"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    codeExposure: {
      originalRequestId: "cac019824a0b25ba"
      programmingLanguage: "python"
    }
  requestId: "0c5178fe-446f-4ab6-b996-520dec100cf8"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:35.662837985Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
  type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:35.021564463Z"
}

בדוגמה הבאה אפשר לראות רשומה ביומן codeAcceptance:

{
  insertId: "whfrqgc1gk"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    codeAcceptance: {
      linesCount: 2
      originalRequestId: "cac019824a0b25ba"
      programmingLanguage: "python"
    }
    requestId: "ddf11040-c315-452e-b7cd-928c3f97984e"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:37.632662272Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
    type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:36.778692483Z"
}

בדוגמה הבאה אפשר לראות רשומה ביומן chatAcceptance:

{
  "insertId": "1oru1grbow",
  "jsonPayload": {
    "clientVersion": "1.103.2",
    "requestId": "32a0b0b8c967d8e8",
    "clientName": "CloudCodeVscode",
    "chatAcceptance": {
      "interactionType": "ACCEPT_CODE_BLOCK",
      "programmingLanguage": "go",
      "linesCount": "15",
      "originalRequestId": "75f7c41e63162567"
    },
    "@type": "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
  },
  "resource": {
    "type": "cloudaicompanion.googleapis.com/Instance",
    "labels": {
      "resource_container": "my-project-id",
      "instance_id": "default",
      "location": "global"
    }
  },
  "timestamp": "2025-08-25T09:34:01.240377123Z",
  "severity": "INFO",
  "labels": {
    "product": "code_assist",
    "method": "Export.Metrics",
    "user_id": "user@company.com"
  },
  "logName": "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata",
  "receiveTimestamp": "2025-08-25T09:34:01.704925625Z"
}

בדוגמה הבאה אפשר לראות רשומה ביומן chatExposure:

{
  insertId: "3diaj2c208"
  jsonPayload: {
    @type: "type.googleapis.com/google.cloud.cloudaicompanion.logging.v1.MetadataLog"
    clientName: "CloudCodeVscode"
    clientVersion: "1.93.1"
    chatExposure: {
      originalRequestId: "cac019824a0b25ba"
    }
  requestId: "0c5178fe-446f-4ab6-b996-520dec100cf8"
  }
  labels: {
    method: "Export.Metrics"
    product: "code_assist"
    user_id: "user@company.com"
  }
  logName: "projects/my-project-id/logs/cloudaicompanion.googleapis.com%2Fmetadata"
  receiveTimestamp: "2025-02-03T23:34:35.662837985Z"
  resource: {
    labels: {
      instance_id: "default"
      location: "global"
      resource_container: "my-project-id"
    }
  type: "cloudaicompanion.googleapis.com/Instance"
  }
  severity: "INFO"
  timestamp: "2025-02-03T23:34:35.021564463Z"
}

חישוב שיעור הקבלה

בקטעים הבאים מוסבר איך לחשב את שיעור האישור של הצעות הקוד, את שיעור האישור של התשובות בצ'אט ואת שיעור האישור הכולל המשולב באמצעות יומני המטא-נתונים של Gemini Code Assist.

חישוב שיעור האישורים של הקוד

כדי לחשב את שיעור קבלת הקוד באמצעות יומני מטא-נתונים של Gemini Code Assist, מחפשים את המספר הכולל של מזהים ייחודיים מאירועים עם codeAcceptance.originalRequestId ומחלקים אותו במספר הכולל של מזהים ייחודיים מאירועים עם codeExposure.originalRequestId.

אפשר לדייק את החישוב הזה לפי שפת תכנות ולפי משתמש באמצעות השדות המתאימים של אירועי היומן של המטא-נתונים.

חישוב שיעור קבלת הצ'אטים

כדי לחשב את שיעור קבלת הצ'אטים באמצעות יומני מטא-נתונים של Gemini Code Assist, צריך למצוא את המספר הכולל של מזהים ייחודיים מאירועים עם chatAcceptance.originalRequestId ולחלק אותו במספר הכולל של מזהים ייחודיים מאירועים עם chatExposure.originalRequestId.

אפשר לדייק את החישוב הזה לפי שפת תכנות ולפי משתמש באמצעות השדות המתאימים של אירועי היומן של המטא-נתונים.

חישוב שיעור האישורים הכולל

כדי לחשב את שיעור האישור הכולל באמצעות יומני מטא-נתונים של Gemini Code Assist, צריך למצוא את המספר הכולל של האירועים שאושרו ולחלק אותו במספר הכולל של אירועי החשיפה:

שיעור האישורים הכולל = סך כל האירועים שאושרו חלקי סך כל אירועי החשיפה

סך כל האירועים שאושרו: המספר הכולל של מזהים ייחודיים מאירועים עם codeAcceptance.originalRequestId בתוספת המספר הכולל של מזהים ייחודיים מאירועים עם chatAcceptance.originalRequestId.
אירועי חשיפה כוללים: המספר הכולל של מזהים ייחודיים מאירועים עם הערך codeExposure.originalRequestId, ועוד המספר הכולל של מזהים ייחודיים מאירועים עם הערך chatExposure.originalRequestId.

הנוסחה הזו מספקת שיעור קבלה שמשקף את ההסתברות הכוללת לקבלת הצעה כלשהי בכל התכונות של Gemini Code Assist.

חישוב של שורות קוד שאושרו

בקטעים הבאים מוסבר איך לחשב את מספר שורות הקוד שהתקבלו מהצעות קוד, את מספר שורות הקוד שהתקבלו מהצ'אט ואת סך כל שורות הקוד שהתקבלו באמצעות יומני המטא-נתונים של Gemini Code Assist.

חישוב של שורות קוד שאושרו

כדי לחשב את שורות הקוד שהתקבלו, צריך למצוא את הערך המקסימלי של codeAcceptance.linesCount לכל codeAcceptance.originalRequestId ייחודי. לאחר מכן, מחברים את הערכים המקסימליים האלה כדי לחשב את המספר הכולל של שורות הקוד שהמערכת קיבלה.

אפשר לדייק את החישוב הזה לפי שפת תכנות ולפי משתמש באמצעות השדות המתאימים של אירועי היומן של המטא-נתונים.

חישוב שורות קוד שהתקבלו מהצ'אט

כדי לחשב את שורות הקוד שהתקבלו מהצ'אט, צריך למצוא את הערך של השדה chatAcceptance.linesCount לכל chatAcceptance.originalRequestId ייחודי. לאחר מכן, מחברים את הערכים המקסימליים האלה כדי לחשב את מספר השורות הכולל של הצ'אטים שהתקבלו.

חישוב של מספר השורות הכולל של קוד שאושר

כדי לחשב את סך השורות שאושרו באמצעות יומני המטא-נתונים של Gemini Code Assist, מחברים את שורות הקוד שאושרו ושורות הקוד שאושרו מהצ'אט.

צפייה ביומנים של Gemini Code Assist קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

מגבלות

לפני שמתחילים

צפייה ביומני משתמשים ובמטא-נתונים של Gemini Code Assist

המסוף

gcloud

API

יומנים של Gemini Code Assist

בקשות ממשתמשים

יומני אינטראקציות עם נציג תמיכה

רשומה ביומן הבקשות

רשומה ביומן התשובות

רשומה ביומן של מטא-נתונים

תשובות של Gemini Code Assist

יומני מטא-נתונים של Gemini Code Assist

חישוב שיעור הקבלה

חישוב שיעור האישורים של הקוד

חישוב שיעור קבלת הצ'אטים

חישוב שיעור האישורים הכולל

חישוב של שורות קוד שאושרו

חישוב של שורות קוד שאושרו

חישוב שורות קוד שהתקבלו מהצ'אט

חישוב של מספר השורות הכולל של קוד שאושר

המאמרים הבאים

צפייה ביומנים של Gemini Code Assist