Usa las estadísticas de Developer Connect

Vista previa

Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En este documento, se describe cómo aprovechar la inteligencia que proporcionan las estadísticas de Developer Connect.

Antes de comenzar

Antes de poder usar las estadísticas de Developer Connect, debes seguir los pasos que se indican en Cómo configurar las estadísticas de Developer Connect. En ese artículo, se describen los roles y permisos necesarios para las estadísticas de Developer Connect.

Usa las estadísticas de Developer Connect en Gemini Cloud Assist

Puedes usar Gemini Cloud Assist para ver las estadísticas que genera Developer Connect.

Cuando se crea una investigación en Gemini Cloud Assist, el sistema selecciona automáticamente las implementaciones pertinentes para tu aplicación de App Hub o dentro de un proyecto, según la forma en que lo configures. Cuando realiza diagnósticos, Gemini Cloud Assist usa estas implementaciones como contexto.

Cuando Gemini Cloud Assist correlaciona un evento de implementación con tu investigación, el sistema muestra una tarjeta titulada "Deployment de [DEPLOYMENT_NAME]".

Haz clic en Eventos correlacionados en las tarjetas para abrir los registros pertinentes en el Explorador de registros.

Cuando Gemini Cloud Assist cree que una implementación específica está causando un error, la incluirá como una de las hipótesis, con el título "Implementación reciente que afecta el comportamiento de la aplicación", junto con recomendaciones para la corrección.

Cómo ver las entradas de registro de Developer Connect Insights

Dado que las estadísticas creadas con las estadísticas de Developer Connect se almacenan como entradas de registro en Cloud Logging, puedes ver los metadatos de implementación en Logging. Para ver las entradas de registro creadas por las estadísticas de Developer Connect, usa el comando gcloud logging read y filtra por nombre de registro de la siguiente manera:

gcloud logging read logName=projects/PROJECT_ID/logs/developerconnect.googleapis.com/sdlc_deployment` \
--project=PROJECT_ID

En este comando, reemplaza PROJECT_ID por el ID del proyecto en el que creaste tu configuración de estadísticas de Developer Connect.

Este comando devuelve registros con el nombre sdlc_deployment, pero también puedes filtrar por otros valores, por ejemplo, el ID de configuración de estadísticas de Developer Connect (labels.insights_config_id=) para mostrar entradas de registro de una configuración de estadísticas específica.

A continuación, se muestra un ejemplo de una entrada de registro JSON generada por las estadísticas de 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"
    }
  }
}

Cómo ver los eventos de implementación de estadísticas de Developer Connect

Además de ver estadísticas con Logging, puedes ver los eventos de implementación y sus detalles con la consola de Google Cloud o Google Cloud CLI.

Nota: La visualización de eventos de implementación con la consola de Google Cloud solo está disponible para las carpetas habilitadas para App Hub.

Enumera los eventos de implementación

Consola de Google Cloud

(Solo para carpetas habilitadas para App Hub)

Para enumerar los eventos de implementación de una configuración de estadísticas determinada con la consola deGoogle Cloud , sigue estos pasos:

1. En la consola de Google Cloud , selecciona Cloud Hub en el menú principal.

   Se mostrará la página principal de Cloud Hub.

2. Selecciona Implementaciones.

   Las aplicaciones implementadas se muestran en la tabla Actualizaciones de la implementación del código de la aplicación.

   Puedes seleccionar cualquier aplicación de la lista para ver sus detalles.

gcloud

Para enumerar los eventos de implementación de una configuración de estadísticas determinada, ejecuta el siguiente comando:

gcloud alpha developer-connect insights-configs deployment-events list \
       --insights-config=INSIGHTS_CONFIG_ID \
       --location=LOCATION \
       --project=PROJECT_ID

Reemplaza lo siguiente:

• INSIGHTS_CONFIG_ID es el nombre que se le asignó a la configuración de estadísticas de Developer Connect cuando se creó.

• LOCATION es la región en la que creaste tu configuración de estadísticas de Developer Connect.

• PROJECT_ID es el ID del proyecto de Google Cloud en el que creaste la configuración de estadísticas.

A continuación, se muestra un ejemplo de resultado JSON del comando deployment-events list, en el que se muestran los eventos de implementación que producen las estadísticas de 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"
  }
]

Ver detalles del evento de implementación

Consola de Google Cloud

(Solo para carpetas habilitadas para App Hub)

Para ver los detalles de implementación de una aplicación implementada, en la consola deGoogle Cloud , haz lo siguiente:

1. Enumera los eventos de implementación para el proyecto seleccionado.

2. Haz clic en el nombre de la aplicación cuyos detalles quieres ver.

Los detalles se muestran en la consola de Google Cloud .

gcloud

Para ver los detalles de los eventos de implementación de una configuración de estadísticas determinada, incluidas las vulnerabilidades, ejecuta el siguiente comando:

gcloud alpha developer-connect insights-configs deployment-events describe DEPLOYMENT_EVENT_ID \
       --insights-config=INSIGHTS_CONFIG_ID \
       --location=LOCATION \
       --project=PROJECT_ID

Reemplaza lo siguiente:

• DEPLOYMENT_EVENT_ID es un identificador único para el evento de implementación.

  Puedes obtener este ID de la lista de eventos que devuelve el comando gcloud alpha developer-connect insights-configs deployment-events list. El ID se encuentra al final de la ruta de acceso en el elemento name: del evento. Por ejemplo, en el siguiente JSON de evento de implementación, el ID del evento es nkj987654321:

  "name": "projects/111111111/locations/us-central1/insightsConfigs/my-ic/deploymentEvents/nkj987654321"
  

• INSIGHTS_CONFIG_ID es el nombre que se le asignó a la configuración de estadísticas de Developer Connect cuando se creó.

• LOCATION es la región en la que creaste tu configuración de estadísticas de Developer Connect.

• PROJECT_ID es el ID del proyecto de Google Cloud en el que creaste la configuración de estadísticas.

A continuación, se muestra un ejemplo de resultado JSON del comando deployment-events describe, en el que se muestran detalles del evento de implementación, producido por las estadísticas de 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"
}

¿Qué sigue?

• Obtén más información sobre las investigaciones de Gemini Cloud Assist