Developer Connect-Statistiken verwenden

Vorschau

Diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

In diesem Dokument wird beschrieben, wie Sie die Informationen aus Developer Connect-Statistiken nutzen können.

Hinweise

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. Das hängt davon ab, wie Sie Gemini Cloud Assist einrichten. 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 Insights-Logeinträge ansehen

Da die mit Developer Connect-Statistiken erstellten Statistiken als Logeinträge in Cloud Logging gespeichert werden, können Sie 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"
    }
  }
}

Developer Connect Insights-Deployment-Ereignisse ansehen

Zusätzlich zum Anzeigen von Statistiken mit Logging können Sie Bereitstellungsereignisse über die Befehlszeile auflisten und Details zu diesen Bereitstellungsereignissen aufrufen.

Deployment-Ereignisse auflisten

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

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

Im Folgenden finden Sie ein Beispiel für die JSON-Ausgabe des Befehls deployment-events list, in der Bereitstellungsereignisse aus Developer Connect-Statistiken zu sehen sind:

[
  {
    "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

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-Konfiguration für Statistiken 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

• Weitere Informationen zu Gemini Cloud Assist-Prüfungen