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에서 특정 배포로 인해 오류가 발생한다고 판단되면 해당 배포를 '애플리케이션 동작에 영향을 미치는 최근 배포'라는 제목의 가설 중 하나로 포함하고 해결을 위한 권장사항을 함께 제공합니다.

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",
      "timestamp": "2025-03-21T21:16:33Z"
    }
  },
  "resource": {
    "type": "k8s_cluster",
    "labels": {
      "location": "us-central1",
      "project_id": "REDACTED",