שימוש בתובנות של Developer Connect

במסמך הזה מוסבר איך להפיק תועלת מהתובנות שמספק Developer Connect.

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

כדי להשתמש בתובנות של Developer Connect, צריך לפעול לפי השלבים שמפורטים במאמר הגדרת תובנות של Developer Connect. במאמר הזה מפורטים התפקידים וההרשאות שנדרשים כדי לגשת לתובנות של Developer Connect.

שימוש בתובנות של Developer Connect ב-Gemini Cloud Assist

אתם יכולים להשתמש ב-Gemini Cloud Assist כדי לראות את התובנות שנוצרו על ידי Developer Connect.

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

כש-Gemini Cloud Assist משייך אירוע פריסה לחקירה שלכם, המערכת מציגה כרטיס בשם Deployment of [DEPLOYMENT_NAME] (פריסה של [DEPLOYMENT_NAME]).

לוחצים על אירועים קשורים בכרטיסים כדי לפתוח את היומנים הרלוונטיים בכלי Logs Explorer.

אם Gemini Cloud Assist מזהה שפריסה ספציפית גורמת לשגיאה, הוא כולל את הפריסה הזו כאחת מההשערות, עם הכותרת 'Recent Deployment Impacting Application Behavior' (פריסה מהזמן האחרון שמשפיעה על התנהגות האפליקציה), וגם המלצות לתיקון.

צפייה בערכים ביומן התובנות של Developer Connect

התובנות שנוצרות באמצעות התובנות של Developer Connect מאוחסנות כרשומות ביומן ב-Cloud Logging, כך שאתם יכולים לראות את המטא-נתונים של הפריסה ב-Cloud Logging. כדי לראות את הרשומות ביומן שנוצרו על ידי התובנות של Developer Connect, משתמשים בפקודה gcloud logging read ומסננים לפי שם היומן, באופן הבא:

gcloud logging read logName=projects/PROJECT_ID/logs/developerconnect.googleapis.com/sdlc_deployment` \
--project=PROJECT_ID

בפקודה הזו, מחליפים את PROJECT_ID במזהה הפרויקט שבו יצרתם את הגדרת התובנות של Developer Connect.

הפקודה הזו מחזירה יומנים עם השם sdlc_deployment, אבל אפשר גם לסנן לפי ערכים אחרים, למשל מזהה התצורה של התובנות של Developer Connect‏ (labels.insights_config_id=), כדי להציג רשומות ביומן של תצורה ספציפית של תובנות.

הנה דוגמה לרשומה ביומן JSON שנוצרה על ידי תובנות של Developer Connect:

{
  "insertId": "11h69plf2713tb",
  "jsonPayload": {
    "previousDeployment": {
      "resource": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster",
      "deploymentId": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster/k8s/namespaces/default/apps/replicasets/dci-test-app-c8cf94d46",
      "artifactDetails": [
        {
          "commitReferences": [
            {
              "commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e",
              "commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e"
            }
          ],
          "packages": [
            {
              "packageVersion": "3.40.1-2+deb12u1",
              "packageName": "libsqlite3-0"
            },
            {
              "packageVersion": "0.45.1",
              "packageName": "wheel"
            },
          ],
          "artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709"
        }
      ],
      "statusSummary": "1/1 Running",
      "timestamp": "2025-03-21T21:13:28Z"
    },
    "currentDeployment": {
      "resource": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster",
      "statusSummary": "5/5 Running",
      "artifactDetails": [
        {
          "packages": [
            {
              "packageVersion": "3.40.1-2+deb12u1",
              "packageName": "libsqlite3-0"
            },
            {
              "packageVersion": "0.45.1",
              "packageName": "wheel"
            },
          ],
          "artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709",
          "commitReferences": [
            {
              "commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e",
              "commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e"
            }
          ]
        },
        {
          "artifactUri": "us-central1-docker.pkg.dev/P/R/dci-test-app-image@sha256:86ee1874886beb7d2042e40e3ff7253a974c579d49dbbfbba576aad13c880709",
          "packages": [
                       {
              "packageVersion": "3.40.1-2+deb12u1",
              "packageName": "libsqlite3-0"
            },
            {
              "packageVersion": "0.45.1",
              "packageName": "wheel"
            },
          ],
          "commitReferences": [
            {
              "commitSha": "5460433ebfc4b2a7602e21f90828559b4891943e",
              "commitUrl": "https://github.com/USER/REPO/commit/5460433ebfc4b2a7602e21f90828559b4891943e"
            }
          ]
        }
      ],
      "deploymentId": "//container.googleapis.com/projects/P/locations/L/clusters/dci-cluster/k8s/namespaces/default/apps/replicasets/recommendation-app-c8cf94d46",
      "timestamp": "2025-03-21T21:16:33Z"
    }
  },
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "project_id": "REDACTED",
      "cluster_name": "REDACTED"
    }
  },
  "timestamp": "2025-03-21T21:16:33Z",
  "severity": "INFO",
  "labels": {
    "insights_config_id": "projects/P/locations/L/insightsConfigs/ecommerce-699",
    "insights_config_deployment_id": "projects/P/locations/L/insightsConfigs/ecommerce-699/deployments/ee54cbae-08f4-4970-a61b-bc28740572c7"
  },
  "logName": "projects/P/logs/developerconnect.googleapis.com%2Fsdlc_deployment",
  "receiveTimestamp": "2025-03-21T21:18:01.154658625Z",
  "apphub": {
    "application":