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
Mit Gemini Cloud Assist können Sie die von Developer Connect-Statistiken generierten Statistiken aufrufen.
Wenn in Gemini Cloud Assist eine Untersuchung erstellt wird, wählt das System automatisch Bereitstellungen aus, die für Ihre App Hub Anwendung oder innerhalb eines Projekts relevant sind, je nachdem, wie Sie es eingerichtet haben. Bei der Diagnose verwendet Gemini Cloud Assist diese Bereitstellungen als Kontext.
Wenn Gemini Cloud Assist ein Bereitstellungsereignis mit Ihrer Untersuchung korreliert, wird eine Karte mit dem Titel „Bereitstellung von [DEPLOYMENT_NAME]“ angezeigt.
Klicken Sie auf den Karten auf Korrelierte Ereignisse , um die relevanten Logs im Log-Explorer zu öffnen.
Wenn Gemini Cloud Assist der Meinung ist, dass eine bestimmte Bereitstellung einen Fehler verursacht, wird diese Bereitstellung als eine der Hypothesen mit dem Titel „Recent Deployment Impacting Application Behavior“ (Auswirkungen der letzten Bereitstellung auf das Anwendungsverhalten) zusammen mit Empfehlungen zur Behebung des Fehlers angezeigt.
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 Bereitstellungsmetadaten 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 anzuzeigen.
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"
}
}
}
Bereitstellungsereignisse für Developer Connect-Statistiken ansehen
Neben dem Aufrufen von Statistiken mit Logging können Sie Bereitstellungsereignisse und ihre Details auch über die Google Cloud Console oder die Google Cloud CLI ansehen.
Bereitstellungsereignisse auflisten
Google Cloud Console
(Nur für Ordner, für die App Hub aktiviert ist)
So listen Sie Bereitstellungsereignisse 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 Bereitstellungen aus.
Bereitgestellte 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 Bereitstellungsereignisse 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 eine JSON-Ausgabe des Befehls deployment-events list, in der Bereitstellungsereignisse 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 Bereitstellungsereignissen ansehen
Google Cloud Console
(Nur für Ordner, für die App Hub aktiviert ist)
So rufen Sie die Bereitstellungsdetails für eine bereitgestellte Anwendung in der Google Cloud Console auf:
Listen Sie die Bereitstellungsereignisse auf für das ausgewählte Projekt.
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 Bereitstellungsereignissen für eine bestimmte Statistikkonfiguration aufzurufen, einschließlich 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 Bereitstellungs 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 Bereitstellungsereignis 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 eine JSON-Ausgabe des Befehls deployment-events describe, in der Details zum Bereitstellungsereignis 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