Developer Connect-Statistiken verwenden

In diesem Dokument wird beschrieben, wie Sie die Informationen aus Developer Connect-Statistiken 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

Sie können Gemini Cloud Assist verwenden, um die von Developer Connect-Statistiken generierten Statistiken aufzurufen.

Wenn in Gemini Cloud Assist eine Untersuchung erstellt wird, werden automatisch Bereitstellungen erfasst, die für Ihre App Hub-Anwendung oder innerhalb eines Projekts relevant sind, je nachdem, wie Sie die Untersuchung eingerichtet haben. Bei der Diagnose verwendet Gemini Cloud Assist diese Bereitstellungen als Kontext.

Wenn Gemini Cloud Assist ein Bereitstellungsereignis mit Ihrer Untersuchung in Verbindung bringt, wird eine Karte mit dem Titel „Bereitstellung von [DEPLOYMENT_NAME]“ angezeigt.

Klicken Sie auf den Karten auf Correlated Events (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“ (Letztes Deployment wirkt sich auf das Anwendungsverhalten aus) zusammen mit Empfehlungen zur Behebung des Problems aufgeführt.

Developer Connect-Statistik-Logeinträge ansehen

Da die mit Developer Connect-Statistiken erstellten Statistiken als Logeinträge in Cloud Logging gespeichert werden, können Sie die Bereitstellungsmetadaten in Logging ansehen. Wenn Sie von Developer Connect-Statistiken erstellte Logeinträge aufrufen möchten, verwenden Sie den Befehl gcloud logging read und filtern Sie nach dem Log-Namen:

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 Ihre Developer Connect-Konfiguration für Statistiken erstellt haben.

Mit diesem Befehl werden Logs mit dem Namen sdlc_deployment zurückgegeben. Sie können aber auch nach anderen Werten filtern, z. B. nach der ID Ihrer Developer Connect-Konfiguration für Statistiken (labels.insights_config_id=), um Logeinträge für eine bestimmte Konfiguration für Statistiken 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"
    }
  }
}

Bereitstellungsereignisse in Developer Connect-Statistiken ansehen

Sie können nicht nur mit Logging Statistiken aufrufen, sondern auch Bereitstellungsereignisse und ihre Details über die Google Cloud -Konsole oder die Google Cloud CLI aufrufen.

Bereitstellungsereignisse auflisten

Google Cloud Console

(Nur für für App Hub aktivierte Ordner)

So listen Sie Bereitstellungsereignisse für eine bestimmte Insights-Konfiguration mit derGoogle Cloud Console auf:

  1. Wählen Sie in der Google Cloud Console im Hauptmenü Cloud Hub aus.

    Die Cloud Hub-Hauptseite wird angezeigt.

  2. Wählen Sie Bereitstellungen aus.

    Bereitgestellte Anwendungen sind in der Tabelle Aktualisierungen der Bereitstellung von Anwendungscode aufgeführt.

    Sie können eine beliebige aufgeführte Anwendung auswählen, um die zugehörigen Details aufzurufen.

gcloud

Führen Sie den folgenden Befehl aus, um Bereitstellungsereignisse für eine bestimmte Konfiguration für Statistiken 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 Developer Connect Insights-Konfiguration bei der Erstellung gegeben wurde.

  • LOCATION ist die Region, in der Sie die Developer Connect Insights-Konfiguration erstellt haben.

  • PROJECT_ID ist die ID des Google Cloud -Projekts, in dem Sie die Konfiguration für Statistiken erstellt haben.

Im Folgenden sehen Sie ein Beispiel für die JSON-Ausgabe des Befehls deployment-events list, in der Bereitstellungsereignisse angezeigt werden, die von Developer Connect-Statistiken generiert 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 zum Bereitstellungsereignis ansehen

Google Cloud Console

(Nur für für App Hub aktivierte Ordner)

So rufen Sie die Bereitstellungsdetails für eine bereitgestellte Anwendung in derGoogle Cloud -Konsole auf:

  1. Bereitstellungsereignisse für das ausgewählte Projekt auflisten

  2. Klicken Sie auf den Namen der Anwendung, deren Details Sie aufrufen möchten.

Die Details werden in der Google Cloud -Konsole angezeigt.

gcloud

Führen Sie den folgenden Befehl aus, um Details zu Bereitstellungsereignissen für eine bestimmte Insights-Konfiguration 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 Bereitstellungsereignis.

    Sie können diese ID aus der Liste der Ereignisse abrufen, die vom Befehl gcloud alpha developer-connect insights-configs deployment-events list zurückgegeben werden. Die ID befindet sich am Ende des Pfads im name:-Element für das Ereignis. In der folgenden JSON für ein Bereitstellungsereignis ist die Ereignis-ID beispielsweise nkj987654321:

    "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/nkj987654321"
    
  • INSIGHTS_CONFIG_ID ist der Name, der der Developer Connect Insights-Konfiguration bei der Erstellung gegeben wurde.

  • LOCATION ist die Region, in der Sie die Developer Connect Insights-Konfiguration erstellt haben.

  • PROJECT_ID ist die ID des Google Cloud -Projekts, in dem Sie die Konfiguration für Statistiken erstellt haben.

Im Folgenden sehen Sie ein Beispiel für die JSON-Ausgabe des Befehls deployment-events describe mit Details zum Bereitstellungsereignis, das von Developer Connect-Statistiken generiert 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