In diesem Dokument wird beschrieben, wie Sie die von Developer Connect-Statistiken bereitgestellten Informationen nutzen können.
Hinweis
Bevor Sie Developer Connect-Statistiken verwenden können, müssen Sie die Schritte unter Developer Connect-Statistiken einrichten ausführen. Die für Developer Connect-Statistiken erforderlichen Rollen und Berechtigungen werden in diesem Artikel beschrieben.
Developer Connect-Statistiken in Gemini Cloud Assist verwenden
Wenn in Gemini Cloud Assist eine Untersuchung erstellt wird, werden je nach Einrichtung automatisch Deployments erfasst, die für Ihre App Hub Anwendung oder innerhalb eines Projekts relevant sind. Bei der Diagnose verwendet Gemini Cloud Assist diese Deployments als Kontext.
Wenn Gemini Cloud Assist ein Deployment-Ereignis mit Ihrer Untersuchung korreliert, wird eine Karte mit dem Titel „Deployment von [DEPLOYMENT_NAME]“ angezeigt.
Klicken Sie auf den Karten auf Korrelierte Ereignisse , um die entsprechenden Logs im Log-Explorer zu öffnen.
Wenn Gemini Cloud Assist der Meinung ist, dass ein bestimmtes Deployment einen Fehler verursacht, wird dieses Deployment als eine der Hypothesen mit dem Titel „Recent Deployment Impacting Application Behavior“ (Aktuelles Deployment, das sich auf das Verhalten der Anwendung auswirkt) zusammen mit Empfehlungen zur Behebung des Problems aufgeführt.
Logeinträge für Developer Connect-Statistiken ansehen
Da die mit Developer Connect-Statistiken erstellten Statistiken als Logeinträge in Cloud Logging gespeichert werden, können Sie die Deployment-Metadaten in Logging ansehen. Verwenden Sie den Befehl gcloud logging read und filtern Sie nach dem Lognamen, um Logeinträge aufzurufen, die von Developer Connect-Statistiken erstellt wurden:
gcloud logging read logName=projects/PROJECT_ID/logs/developerconnect.googleapis.com/sdlc_deployment` \
--project=PROJECT_ID
Ersetzen Sie in diesem Befehl PROJECT_ID durch die ID des Projekts, in dem Sie die Konfiguration für Developer Connect-Statistiken erstellt haben.
Dieser Befehl gibt Logs mit dem Namen sdlc_deployment zurück. Sie können aber auch nach anderen Werten filtern, z. B. nach der Konfigurations-ID für Developer Connect-Statistiken (labels.insights_config_id=), um Logeinträge für eine bestimmte Statistikkonfiguration aufzurufen.
Im Folgenden sehen Sie ein Beispiel für einen JSON-Logeintrag, der von Developer Connect-Statistiken erstellt wurde:
{
"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"
}
}
}
Deployment-Ereignisse für Developer Connect-Statistiken ansehen
Sie können Statistiken nicht nur mit Logging ansehen, sondern auch Deployment-Ereignisse und ihre Details über die Google Cloud Console oder die Google Cloud CLI aufrufen.
Deployment-Ereignisse auflisten
Google Cloud Console
(Nur für Ordner, für die App Hub aktiviert ist)
So listen Sie Deployment-Ereignisse für eine bestimmte Statistikkonfiguration über die Google Cloud Console auf:
Wählen Sie in der Google Cloud Console im Hauptmenü Cloud Hub aus.
Die Hauptseite von Cloud Hub wird angezeigt.
Wählen Sie Deployments aus.
Die bereitgestellten Anwendungen werden in der Tabelle Aktualisierungen der Bereitstellung von Anwendungscode aufgeführt.
Sie können eine beliebige aufgeführte Anwendung auswählen, um ihre Details aufzurufen.
gcloud
Führen Sie den folgenden Befehl aus, um Deployment-Ereignisse für eine bestimmte Statistikkonfiguration aufzulisten:
gcloud alpha developer-connect insights-configs deployment-events list \
--insights-config=INSIGHTS_CONFIG_ID \
--location=LOCATION \
--project=PROJECT_ID
Ersetzen Sie Folgendes:
INSIGHTS_CONFIG_ID ist der Name, der der Konfiguration für Developer Connect-Statistiken bei der Erstellung gegeben wurde.
LOCATION ist die Region, in der Sie die Konfiguration für Developer Connect-Statistiken erstellt haben.
PROJECT_ID ist die ID des Google Cloud Projekts, in dem Sie die Statistikkonfiguration erstellt haben.
Im Folgenden sehen Sie ein Beispiel für die JSON-Ausgabe des Befehls deployment-events list, in der Deployment-Ereignisse angezeigt werden, die von Developer Connect-Statistiken erstellt wurden:
[
{
"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"
}
]
Details zu Deployment-Ereignissen ansehen
Google Cloud Console
(Nur für Ordner, für die App Hub aktiviert ist)
So rufen Sie die Deployment-Details für eine bereitgestellte Anwendung in der Google Cloud Console auf:
Listen Sie die Deployment-Ereignisse für das ausgewählte Projekt auf.
Klicken Sie auf den Namen der Anwendung, deren Details Sie aufrufen möchten.
Die Details werden in der Google Cloud Console angezeigt.
gcloud
Führen Sie den folgenden Befehl aus, um Details zu Deployment-Ereignissen für eine bestimmte Statistikkonfiguration aufzurufen, einschließlich Informationen zu Sicherheitslücken:
gcloud alpha developer-connect insights-configs deployment-events describe DEPLOYMENT_EVENT_ID \
--insights-config=INSIGHTS_CONFIG_ID \
--location=LOCATION \
--project=PROJECT_ID
Ersetzen Sie Folgendes:
DEPLOYMENT_EVENT_ID ist eine eindeutige Kennung für das Deployment Ereignis.
Sie können diese ID aus der Liste der Ereignisse abrufen, die vom
gcloud alpha developer-connect insights-configs deployment-events listBefehl zurückgegeben werden. Die ID befindet sich am Ende des Pfads im Elementname:für das Ereignis. Im folgenden JSON für ein Deployment-Ereignis ist die Ereignis-ID beispielsweisenkj987654321:"name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/nkj987654321"INSIGHTS_CONFIG_ID ist der Name, der der Konfiguration für Developer Connect-Statistiken bei der Erstellung gegeben wurde.
LOCATION ist die Region, in der Sie die Konfiguration für Developer Connect-Statistiken erstellt haben.
PROJECT_ID ist die ID des Google Cloud Projekts, in dem Sie die Statistikkonfiguration erstellt haben.
Im Folgenden sehen Sie ein Beispiel für die JSON-Ausgabe des Befehls deployment-events describe, in der Details für das Deployment-Ereignis angezeigt werden, das von Developer Connect-Statistiken erstellt wurde:
{
"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"
}
Nächste Schritte
- Weitere Informationen zu Gemini Cloud Assist-Untersuchungen