Menggunakan insight Developer Connect

Dokumen ini menjelaskan cara memanfaatkan kecerdasan yang disediakan oleh insight Developer Connect.

Sebelum memulai

Sebelum dapat menggunakan insight Developer Connect, Anda harus mengikuti langkah-langkah di Menyiapkan insight Developer Connect. Peran dan izin yang diperlukan untuk insight Developer Connect dijelaskan dalam artikel tersebut.

Menggunakan insight Developer Connect di Gemini Cloud Assist

Anda dapat menggunakan Gemini Cloud Assist untuk melihat insight yang dihasilkan oleh insight Developer Connect.

Saat penyelidikan dibuat di Gemini Cloud Assist, sistem akan otomatis mengambil deployment yang relevan dengan aplikasi App Hub atau dalam project Anda, bergantung pada cara Anda menyiapkannya. Saat membuat diagnosis, Gemini Cloud Assist menggunakan deployment ini sebagai konteks.

Saat Gemini Cloud Assist mengorelasikan peristiwa deployment dengan penyelidikan Anda, sistem akan menampilkan kartu berjudul "Deployment [DEPLOYMENT_NAME]".

Klik Peristiwa yang Berkorelasi pada kartu untuk membuka log yang relevan di Logs Explorer.

Jika Gemini Cloud Assist yakin bahwa deployment tertentu menyebabkan error, Gemini Cloud Assist akan menyertakan deployment tersebut sebagai salah satu hipotesis, dengan judul "Deployment Terbaru yang Memengaruhi Perilaku Aplikasi", beserta rekomendasi untuk perbaikan.

Melihat entri log insight Developer Connect

Karena insight yang dibuat menggunakan insight Developer Connect disimpan sebagai entri log di Cloud Logging, Anda dapat melihat metadata deployment di Logging. Untuk melihat entri log yang dibuat oleh insight Developer Connect, gunakan perintah gcloud logging read dengan memfilter menurut nama log, sebagai berikut:

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

Dalam perintah ini, ganti PROJECT_ID dengan ID project tempat Anda membuat konfigurasi insight Developer Connect.

Perintah ini menampilkan log dengan nama sdlc_deployment, tetapi Anda juga dapat memfilter menurut nilai lain, misalnya, ID konfigurasi insight Developer Connect Anda (labels.insights_config_id=) untuk menampilkan entri log untuk konfigurasi insight tertentu.

Berikut adalah contoh entri log JSON yang dihasilkan oleh insight 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": {
      "container": "projects/dci-test-project-3",
      "location": "us-central1",
      "id": "dci-test-app"
    },
    "workload": {
      "id": "dci-test-app",
      "environmentType": "PRODUCTION",
      "criticalityType": "MISSION_CRITICAL"
    }
  }
}

Melihat peristiwa deployment insight Developer Connect

Selain melihat insight menggunakan Logging, Anda dapat mencantumkan peristiwa deployment dari command line dan melihat detail untuk peristiwa deployment tersebut.

Mencantumkan peristiwa deployment

Untuk mencantumkan peristiwa deployment untuk konfigurasi insight tertentu, jalankan perintah berikut:

gcloud alpha developer-connect insights-configs deployment-events list \
       --insights-config=INSIGHTS_CONFIG_ID \
       --location=LOCATION \
       --project=PROJECT_ID

Ganti kode berikut:

  • INSIGHTS_CONFIG_ID adalah nama yang diberikan ke konfigurasi insight Developer Connect saat dibuat.

  • LOCATION adalah region tempat Anda membuat konfigurasi insight Developer Connect.

  • PROJECT_ID adalah ID project Google Cloud tempat Anda membuat konfigurasi insight.

Berikut adalah contoh output JSON dari perintah deployment-events list, yang menampilkan peristiwa deployment yang dihasilkan oleh insight Developer Connect:

[
  {
    "artifactDeployments": [
      {
        "artifactAlias": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:1234567890",
        "artifactReference": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:1234567890",
        "containerStatusSummary": "Running-N/A : 1",
        "deployTime": "2025-10-20T16:10:48Z",
        "id": "0a9b8c7d6e5f4g3h2i1",
        "sourceCommitUris": [
          "https://github.com/myGitHub/my-GitHub-project/commit/5806255405d"
        ]
      }
    ],
    "deployTime": "2025-10-20T16:10:48Z",
    "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/daf0987654321",
    "runtimeConfig": {
      "uri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/deployments/my-deployment"
    },
    "runtimeDeploymentUri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/replicasets/my-deployment-6c74f4cdbb",
    "state": "STATE_ACTIVE"
  },
  {
    "artifactDeployments": [
      {
        "artifactAlias": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:24680",
        "artifactReference": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:24680",
        "containerStatusSummary": "Terminated-Error (Exit Code: 137) : 1",
        "deployTime": "2025-10-20T15:29:32Z",
        "id": "2a4b6c8d0e",
        "sourceCommitUris": [
          "https://github.com/myGitHub/my-GitHub-project/commit/n6f8e1269f2c18"
        ],
        "undeployTime": "2025-10-20T18:46:47Z"
      }
    ],
    "deployTime": "2025-10-20T15:29:32Z",
    "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/nkj987654321",
    "runtimeConfig": {
      "uri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/replicasets/my-deployment"
    },
    "runtimeDeploymentUri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/replicasets/my-deployment-6c74f4cdbb",
    "state": "STATE_INACTIVE",
    "undeployTime": "2025-10-20T18:46:47Z"
  }
]

Melihat detail peristiwa deployment

Untuk melihat detail peristiwa deployment untuk konfigurasi insight tertentu, termasuk kerentanan, jalankan perintah berikut:

gcloud alpha developer-connect insights-configs deployment-events describe DEPLOYMENT_EVENT_ID \
       --insights-config=INSIGHTS_CONFIG_ID \
       --location=LOCATION \
       --project=PROJECT_ID

Ganti kode berikut:

  • DEPLOYMENT_EVENT_ID adalah ID unik untuk peristiwa deployment.

    Anda bisa mendapatkan ID ini dari daftar peristiwa yang ditampilkan dari perintah gcloud alpha developer-connect insights-configs deployment-events list. ID berada di akhir jalur dalam elemen name: untuk acara. Misalnya, dalam JSON peristiwa deployment berikut, ID peristiwa adalah nkj987654321:

    "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/nkj987654321"

  • INSIGHTS_CONFIG_ID adalah nama yang diberikan ke konfigurasi insight Developer Connect saat dibuat.

  • LOCATION adalah region tempat Anda membuat konfigurasi insight Developer Connect.

  • PROJECT_ID adalah ID project Google Cloud tempat Anda membuat konfigurasi insight.

Berikut adalah contoh output JSON dari perintah deployment-events describe, yang menampilkan detail untuk peristiwa deployment, yang dihasilkan oleh insight Developer Connect:

{
  "artifactDeployments": [
    {
      "artifactAlias": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:1234567890",
      "artifactReference": "us-central1-docker.pkg.dev/my-project/my-registry/my-app@sha256:1234567890",
      "containerStatusSummary": "Running-N/A : 1",
      "deployTime": "2025-12-02T01:04:30Z",
      "id": "0a9b8c7d6e5f4g3h2i1",
      "packages": [
        {
          "name": "abc",
          "version": "1.3.4.20250131-1"
        },
        {
          "name": "defg",
          "version": "4.3.0"
        },
      ],
      "sourceCommitUris": [
        "https://github.com/myGitHub/my-GitHub-project/commit/5806255405d"
      ],
      "vulnerabilities": [
        "CVE-2000-1234",
        "CVE-2001-1234",
        "CVE-2002-1234",
        "CVE-2003-1234",
        "CVE-2004-1234",
      ]
    }
  ],
  "deployTime": "2025-12-02T01:04:30Z",
  "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/daf0987654321",
  "runtimeConfig": {
    "uri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/deployments/my-deployment"
  },
  "runtimeDeploymentUri": "//container.googleapis.com/projects/111111111/locations/us-central1/clusters/my-cluster/k8s/namespaces/default/apps/replicasets/my-deployment-6c74f4cdbb",
  "state": "STATE_ACTIVE"
}

Langkah berikutnya