Developer Connect の分析情報を使用する

このドキュメントでは、Developer Connect 分析情報が提供するインテリジェンスを活用する方法について説明します。

始める前に

Developer Connect 分析情報を使用するには、 Developer Connect 分析情報を設定するの手順に沿って操作する必要があります。 Developer Connect 分析情報に必要なロールと権限については、この記事で説明しています。

Gemini Cloud Assist で Developer Connect 分析情報を使用する

Gemini Cloud Assist を使用して、Developer Connect 分析情報によって生成された分析情報を確認できます。

Gemini Cloud Assist で調査が作成されると、設定に応じて、App Hub アプリケーションに関連するデプロイメントまたはプロジェクト内のデプロイメントが自動的に選択されます。診断を行う際、Gemini Cloud Assist はこれらのデプロイメントをコンテキストとして使用します。

Gemini Cloud Assist がデプロイ イベントを調査に関連付けると、「[DEPLOYMENT_NAME] のデプロイ」というタイトルのカードが表示されます。

カードの [関連イベント] をクリックすると、ログ エクスプローラで関連するログが開きます。

Gemini Cloud Assist は、特定のデプロイメントがエラーの原因であると判断すると、そのデプロイメントを仮説の 1 つとして含め、「アプリケーションの動作に影響する最近のデプロイメント」というタイトルと、修復に関する推奨事項を表示します。

Developer Connect 分析情報のログエントリを表示する

Developer Connect 分析情報を使用して作成された分析情報は Cloud Logging にログエントリとして保存されるため、Logging でデプロイ メタデータを表示できます。Developer Connect 分析情報によって作成されたログエントリを表示するには、次のようにログ名でフィルタして gcloud logging read コマンドを使用します。

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

このコマンドでは、PROJECT_ID は、Developer Connect 分析情報構成を作成した プロジェクトの ID に置き換えます 。

このコマンドは sdlc_deployment という名前のログを返しますが、Developer Connect 分析情報構成 ID （labels.insights_config_id=）などの他の値でフィルタして、特定の分析情報構成のログエントリを表示することもできます。

次に、Developer Connect 分析情報によって生成された JSON ログエントリのサンプルを示します。

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