Utiliser les insights Developer Connect

Ce document explique comment tirer parti de l'intelligence fournie 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 façon dont vous l'avez configurée. Lorsqu'il établit 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 enquête, 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 concernés dans l'explorateur de journaux.

Lorsque Gemini Cloud Assist estime qu'un déploiement spécifique est à l'origine d'une erreur, il l'inclut dans les hypothèses, avec le titre "Déploiement récent ayant un impact sur le comportement de l'application", ainsi que des recommandations pour la résolution du problème.

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 sous forme d'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 les résultats par d'autres valeurs. Par exemple, vous pouvez utiliser l'ID de configuration de vos 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 générée 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 des insights à l'aide de Logging, vous pouvez lister les événements de déploiement à partir de la ligne de commande et afficher les détails de ces événements.

Lister les événements de déploiement

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 des 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 correspond à l'ID du projet Google Cloud dans lequel vous avez créé la configuration des insights.

Voici un exemple de sortie JSON de la commande deployment-events list, qui affiche les événements de déploiement générés 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

Pour afficher les détails des événements de déploiement pour 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