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 investigasi dibuat di Gemini Cloud Assist, sistem akan otomatis mengambil deployment yang relevan dengan aplikasi Pusat Aplikasi 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 investigasi Anda, sistem akan menampilkan kartu berjudul "Deployment [DEPLOYMENT_NAME]".
Klik Correlated Events di kartu untuk membuka log yang relevan di Logs Explorer.
Jika Gemini Cloud Assist yakin bahwa deployment tertentu menyebabkan error, deployment tersebut akan disertakan sebagai salah satu hipotesis, dengan judul "Recent Deployment Impacting Application Behavior", 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 berdasarkan 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 berdasarkan nilai lain, misalnya, ID konfigurasi insight Developer Connect (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 melihat peristiwa deployment dan detailnya menggunakan Google Cloud console atau Google Cloud CLI.
Mencantumkan peristiwa deployment
Google Cloud Konsol
(Hanya untuk folder yang mengaktifkan App Hub.)
Untuk mencantumkan peristiwa deployment untuk konfigurasi insight tertentu, menggunakan Google Cloud konsol, lakukan langkah-langkah berikut:
Di Google Cloud konsol, pilih Cloud Hub dari menu utama.
Halaman utama Cloud Hub akan ditampilkan.
Pilih Deployments.
Aplikasi yang di-deploy tercantum dalam tabel Application code deployment updates.
Anda dapat memilih aplikasi yang tercantum untuk melihat detailnya.
gcloud
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 Google Cloud project 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
Google Cloud Konsol
(Hanya untuk folder yang mengaktifkan App Hub.)
Untuk melihat detail deployment aplikasi yang di-deploy, di Google Cloud konsol, lakukan hal berikut:
Cantumkan peristiwa deployment untuk project yang Anda pilih.
Klik nama aplikasi yang detailnya ingin Anda lihat.
Detailnya akan ditampilkan di Google Cloud konsol.
gcloud
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 ini berada di akhir jalur dalam elemenname:untuk peristiwa tersebut. Misalnya, dalam JSON peristiwa deployment berikut, ID peristiwa adalahnkj987654321:"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 Google Cloud project 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
- Pelajari lebih lanjut tentang investigasi Gemini Cloud Assist