Utiliser les insights Developer Connect

Aperçu

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Ce document explique comment tirer parti des informations fournies par les insights Developer Connect.

Avant de commencer

Avant de pouvoir utiliser les insights Developer Connect, vous devez suivre les étapes décrites dans Configurer les insights Developer Connect. Les rôles et autorisations nécessaires pour les insights Developer Connect sont décrits dans cet article.

Utiliser les insights Developer Connect dans Gemini Cloud Assist

Vous pouvez utiliser Gemini Cloud Assist pour afficher les insights générés par les insights Developer Connect.

Lorsqu'une investigation est créée dans Gemini Cloud Assist, le système sélectionne automatiquement les déploiements pertinents pour votre application App Hub ou dans un projet, selon la manière dont vous l'avez configuré. Lorsqu'il effectue des diagnostics, Gemini Cloud Assist utilise ces déploiements comme contexte.

Lorsque Gemini Cloud Assist met en corrélation un événement de déploiement avec votre investigation, le système affiche une fiche intitulée "Déploiement de [DEPLOYMENT_NAME]".

Cliquez sur Événements corrélés sur les fiches pour ouvrir les journaux pertinents dans l'explorateur de journaux.

Lorsque Gemini Cloud Assist pense qu'un déploiement spécifique est à l'origine d'une erreur, il inclut ce déploiement comme l'une des hypothèses, avec le titre "Déploiement récent ayant un impact sur le comportement de l'application", ainsi que des recommandations de correction.

Afficher les entrées de journal des insights Developer Connect

Étant donné que les insights créés à l'aide des insights Developer Connect sont stockés en tant qu'entrées de journal dans Cloud Logging, vous pouvez afficher les métadonnées de déploiement dans Logging. Pour afficher les entrées de journal créées par les insights Developer Connect, utilisez la commande gcloud logging read, en filtrant par nom de journal, comme suit :

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

Dans cette commande, remplacez PROJECT_ID par l'ID du projet dans lequel vous avez créé votre configuration d'insights Developer Connect.

Cette commande renvoie des journaux portant le nom sdlc_deployment, mais vous pouvez également filtrer par d'autres valeurs, par exemple, l'ID de votre configuration d'insights Developer Connect (labels.insights_config_id=) pour afficher les entrées de journal d'une configuration d'insights spécifique.

Voici un exemple d'entrée de journal JSON produite par les insights 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"
    }
  }
}

Afficher les événements de déploiement des insights Developer Connect

En plus d'afficher les insights à l'aide de Logging, vous pouvez afficher les événements de déploiement et leurs détails à l'aide de la Google Cloud console ou de la Google Cloud CLI.

Remarque : L'affichage des événements de déploiement à l'aide de la console n'est disponible que pour les dossiers compatibles avec App Hub.

Google Cloud

Lister les événements de déploiement

Google Cloud Console

(Uniquement pour les dossiers compatibles avec App Hub)

Pour lister les événements de déploiement d'une configuration d'insights donnée à l'aide de la Google Cloud console, procédez comme suit :

1. Dans la Google Cloud console, sélectionnez Cloud Hub dans le menu principal.

   La page principale de Cloud Hub s'affiche.

2. Sélectionnez Déploiements.

   Les applications déployées sont listées dans le tableau Mises à jour du déploiement du code d'application.

   Vous pouvez sélectionner n'importe quelle application listée pour afficher ses détails.

gcloud

Pour lister les événements de déploiement d'une configuration d'insights donnée, exécutez la commande suivante :

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

Remplacez les éléments suivants :

• INSIGHTS_CONFIG_ID est le nom attribué à la configuration d'insights Developer Connect lors de sa création.

• LOCATION est la région dans laquelle vous avez créé votre configuration d'insights Developer Connect.

• PROJECT_ID est l'ID du Google Cloud projet dans lequel vous avez créé la configuration d'insights.

Voici un exemple de sortie JSON de la commande deployment-events list, affichant les événements de déploiement produits par les insights 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"
  }
]

Afficher les détails d'un événement de déploiement

Google Cloud Console

(Uniquement pour les dossiers compatibles avec App Hub)

Pour afficher les détails de déploiement d'une application déployée dans la Google Cloud console, procédez comme suit :

1. Listez les événements de déploiement du projet sélectionné.

2. Cliquez sur le nom de l'application dont vous souhaitez afficher les détails.

Les détails s'affichent dans la Google Cloud console.

gcloud

Pour afficher les détails d'un événement de déploiement d'une configuration d'insights donnée, y compris les failles, exécutez la commande suivante :

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

Remplacez les éléments suivants :

• DEPLOYMENT_EVENT_ID est un identifiant unique de l'événement de déploiement.

  Vous pouvez obtenir cet ID à partir de la liste des événements renvoyés par la gcloud alpha developer-connect insights-configs deployment-events list commande. L'ID se trouve à la fin du chemin d'accès dans l'élément name: de l'événement. Par exemple, dans le JSON d'événement de déploiement suivant, l'ID d'événement est nkj987654321 :

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

• INSIGHTS_CONFIG_ID est le nom attribué à la configuration d'insights Developer Connect lors de sa création.

• LOCATION est la région dans laquelle vous avez créé votre configuration d'insights Developer Connect.

• PROJECT_ID est l'ID du Google Cloud projet dans lequel vous avez créé la configuration d'insights.

Voici un exemple de sortie JSON de la commande deployment-events describe, affichant les détails de l'événement de déploiement produit par les insights 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"
}

Étape suivante

• En savoir plus sur les investigations Gemini Cloud Assist