Gemini Cloud Assist 조사 만들기

Google Cloud

이 페이지에서는 Gemini Cloud Assist 조사를 만들고 검토하는 방법을 보여줍니다.

시작하기 전에

  1. Gemini Cloud Assist를 설정했는지 확인합니다.

  2. (선택사항) 권장 API를 사용 설정했는지 확인합니다.

    • logging.googleapis.com
    • monitoring.googelapis.com
    • cloudresourcemanager.googleapis.com

    API를 사용 설정하는 방법은 서비스 사용 설정 및 중지 를 참조하세요.

  3. 조사를 만드는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 조사 작성자(roles/geminicloudassist.investigationCreator) IAM 역할을 부여해 달라고 요청하세요.

    이 사전 정의된 역할에는 프로젝트 내에서 조사를 만드는 데 필요한 권한이 포함되어 있습니다. 조사를 만들면 해당 조사에 대한 조사 소유자(roles/geminicloudassist.investigationOwner) IAM 역할이 부여되어 조사 결과를 검토할 수 있습니다.

  4. 조사 중인 제품에 액세스할 수 있어야 합니다.

    조사를 수행할 때 Gemini Cloud Assist는 사용자 인증 정보를 사용하여 API와 정보에 액세스합니다. 즉, 조사 액세스 권한이 사용자의 액세스 권한으로 제한됩니다.

  5. 애플리케이션에 대한 조사를 수행하려는 경우 애플리케이션 은 애플리케이션 관리를 위해 구성된 폴더 내에 포함되어야 합니다. Gemini Cloud Assist는 호스트 프로젝트 또는 단일 프로젝트 경계에 생성된 애플리케이션을 지원하지 않습니다.

조사 만들기

콘솔

  1. 새 조사를 만들려면 진입점과 연결된 조사 버튼을 클릭합니다. 조사를 생성하는 일반적인 진입점은 Cloud Assist 조사 페이지입니다.

    Cloud Assist 조사로 이동

  2. 조사 구성 드롭다운을 펼칩니다.

  3. (선택사항) 조사에 대한 조사 이름 을 입력합니다.

    선택한 이름은 조사 기록에서 이 조사를 식별합니다. 조사 기록 이 단계를 건너뛰면 조사 이름이 자동으로 생성됩니다.

  4. 시간 범위 선택 드롭다운을 사용하여 조사할 시간 범위를 선택합니다.

    정확한 시작 시간을 사용하면 관련이 없어 보이는 이벤트 간에 시간 기반 상관관계를 설정할 수 있으며, 시작 시간에 가까운 이벤트에 더 많은 가중치를 부여할 수 있습니다. 시간 범위를 잘 모르는 경우 시간 범위를 다르게 하여 여러 조사를 동시에 실행할 수 있습니다.

  5. 겪고 있는 문제 설명 을 입력합니다.

    표시된 정확한 오류 메시지를 복사하여 붙여넣거나, 자연어를 사용하여 발생한 문제를 설명하거나, 둘 다 포함할 수 있습니다.

  6. 진입점에서 애플리케이션 조사를 지원하는 경우 진입점을(를) 사용하여 애플리케이션 필드를 사용하여 조사할 애플리케이션을 선택합니다.

  7. (선택사항) + 리소스 추가를 클릭하여 발생한 문제의 영향을 받는 리소스를 선택합니다.

    리소스 선택 도구를 사용하거나 직접 입력하여 리소스를 추가할 수 있습니다. 리소스를 수동으로 입력할 때는 리소스의 참고 문서를 참고하여 올바른 형식을 사용해야 합니다.

    다음 항목을 포함하는 경우 조사를 진행할 수 없습니다.

    • 조사 범위에 속하지 않는 프로젝트 또는 애플리케이션에 있는 리소스
    • 지원되지 않는 리소스
    • 인식되지 않는 리소스

  8. 만들기 를 클릭하여 조사를 시작합니다.

조사의 세부정보 페이지가 열리고 결과가 제공되는 대로 페이지에 표시됩니다. 조사가 완료되는 데 몇 분 정도 걸릴 수 있습니다. 조사의 세부정보 페이지를 나가면 알림 버튼 ()을 클릭하여 조사 상태를 확인할 수 있습니다.

API

  1. 다음 정보를 포함하는 JSON 파일을 만듭니다.

    {
"title": "INVESTIGATION_NAME",
"observations": {
  "user.project": {
    "id": "user.project",
    "observationType": "OBSERVATION_TYPE_STRUCTURED_INPUT",
    "observerType": "OBSERVER_TYPE_USER",
    "text": "PROJECT_NAME"
  },
  "user.input.text": {
    "id": "user.input.text",
    "observationType": "OBSERVATION_TYPE_TEXT_DESCRIPTION",
    "observerType": "OBSERVER_TYPE_USER",
    "timeIntervals": [
      {
        "startTime": "ISSUE_START_TIME"
      }
    ],
    "text": "ISSUE_DESCRIPTION",
    "relevantResources": [
      "AFFECTED_RESOURCE"
    ],
  },
}

    다음을 바꿉니다.

    • INVESTIGATION_NAME: 조사 이름을 입력합니다. 예를 들면 Missing Cloud Storage bucket입니다.

    • PROJECT_NAME: 조사가 생성되는 프로젝트의 이름을 입력합니다. 예를 들면 my-project입니다.

    • ISSUE_START_TIME: 조사 중인 문제가 시작된 날짜와 시간을 입력합니다. 예를 들면 2025-07-08T17:23:00Z입니다.

    • ISSUE_DESCRIPTION: 겪고 있는 문제에 대한 설명을 입력합니다. 표시된 정확한 오류 메시지를 포함하거나, 자연어를 사용하여 발생한 문제를 설명하거나, 둘 다 포함할 수 있습니다.

    • AFFECTED_RESOURCE: 겪고 있는 문제와 관련된 리소스의 이름을 입력합니다. 예를 들면 //storage.googleapis.com/my-bucket입니다. 리소스에 올바른 형식을 사용하려면 리소스의 참조 문서를 참고해야 합니다.

    조사 리소스의 전체 표현은 리소스 사양을 참조하세요.

  2. 액세스 토큰을 가져옵니다.

    TOKEN=$(gcloud auth print-access-token)

  3. investigations.create 메서드를 사용하여 조사를 만듭니다.

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/PROJECT_NAME/locations/global/investigations"

    다음을 바꿉니다.

    • JSON_FILE_NAME: 이전에 만든 JSON 파일의 경로를 입력합니다. 예를 들면 Desktop/my-investigation.json입니다.

    • PROJECT_NAME: user.project 관측에 포함한 것과 동일한 프로젝트 이름을 입력합니다.

  4. 응답에서 revision 파라미터의 값을 복사합니다.

  5. investigations.revisions.run 메서드를 사용하여 조사를 실행합니다.

    curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  "https://geminicloudassist.googleapis.com/v1alpha/projects/REVISION_RESOURCE:run"

    REVISION_RESOURCE를 revision 파라미터에서 복사한 값으로 바꿉니다.

조사가 완료되는 데 몇 분 정도 걸릴 수 있습니다. investigations.revisions.run 응답에서 반환된 name 파라미터의 값을 복사하고 operations.get 요청의 name 파라미터에서 값을 사용하여 조사 상태를 확인할 수 있습니다.

조사 검토

콘솔에서 조사를 진행할 때 조사를 시작한 진입점이나 프로젝트의 조사 기록에서 조사 세부정보를 볼 수 있습니다. Google Cloud

조사에는 다음 섹션이 포함됩니다.

  1. 조사 요약

    이 섹션에는 문제의 개요, Gemini가 조사를 위해 취한 전략, 조사의 주요 발견 사항이 포함되어 있습니다.

  2. 가설

    이 섹션에는 조사를 통해 수집된 데이터와 관찰을 기반으로 한 하나 이상의 가설 카드가 포함되어 있습니다. 관련 카드에서 보기 버튼을 클릭하여 각 가설의 세부정보를 확인할 수 있습니다.

    • 가설의 세부정보에는 문제의 원인을 설명하는 무엇 섹션과 문제를 해결하는 데 도움이 되거나 가설을 확인 또는 반박하기 위한 추가 문제 해결 단계를 제공하는 작업을 설명하는 다음 단계 섹션이 포함되어 있습니다.

      • 가설에서 식별된 문제에 대해 해결 방법이 지원되는 경우 해결 단계에 계획 생성 버튼이 포함됩니다. 계획 생성 을 클릭하면 gcloud 명령어 또는 Kubernetes 매니페스트와 같은 구체적인 작업을 포함하는 단계별 해결 계획이 생성됩니다. 계획을 검토한 후 실행 을 클릭하여 계획에 설명된 작업을 실행할 수 있습니다.

  3. 발견 사항

    이 섹션에는 조사에서 생성된 관찰 내용이 포함되어 있으며 조사와 관련된 리소스 Google Cloud 가 나열되어 있습니다. 관찰은 절차 런북, 로그, 서비스 중단 메시지, 알림 검토를 기반으로 합니다.

    발견 사항 섹션에는 Gemini가 가설을 생성하는 데 사용한 정보가 표시되며 조사를 개선하는 데 도움이 될 수 있습니다.

조사 입력 내용 을 수정 버튼을 사용하여 수정할 수 있으며, 이를 통해 업데이트된 정보로 조사를 다시 실행할 수 있습니다. 조사에 여러 실행이 연결된 경우 버전 드롭다운 선택기를 사용하여 이전 조사 실행 결과를 검토할 수 있습니다.

서포트 패키지가 있는 경우 조사 세부정보 페이지에 있는 지원 요청 버튼을 클릭하여 지원 케이스를 제출할 수 있습니다. 이렇게 하면 케이스 세부정보를 자동으로 채우고 조사 결과를 지원 엔지니어와 공유할 수 있습니다.

다음 단계