Cloud Assist 조사 만들기

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

시작하기 전에

  1. 프로젝트에 다음 API가 사용 설정되어 있는지 확인합니다.

    • cloudaicompanion.googleapis.com
    • cloudasset.googleapis.com
    • cloudresourcemanager.googleapis.com
    • geminicloudassist.googleapis.com
    • (권장) logging.googleapis.com
    • (권장) monitoring.googelapis.com

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

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

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

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

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

  4. 애플리케이션에 대한 조사를 수행하려면 애플리케이션이 앱 지원 폴더 내에 포함되어 있어야 합니다.

조사 만들기

콘솔

  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 매개변수에서 값을 사용하여 조사 상태를 확인할 수 있습니다.

조사 검토

조사가 완료되면 조사를 시작한 진입점이나 프로젝트의 조사 기록에서 조사 세부정보를 확인할 수 있습니다.

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

  1. 문제

    이 섹션에는 문제 설명, 타임스탬프, 관련 리소스 목록 등 조사 결과를 생성하는 데 사용된 입력 정보가 포함되어 있습니다. 조사와 연결될 수 있는 리소스 목록에는 세 가지 유형이 있습니다.

    • 사용자 제공 리소스: 사용자가 제공하거나 초기 오류에서 가져온 리소스입니다.
    • 발견된 리소스: Gemini가 조사를 수행하는 동안 고려한 추가 리소스입니다.
    • 관련 리소스: Gemini가 근본 원인 가설과 관련이 있다고 간주하는 리소스입니다. 여기에는 항상 사용자가 제공한 리소스가 포함됩니다.

  2. 관찰

    이 섹션에는 조사에서 생성된 관찰 내용이 포함되어 있습니다. 관찰은 절차 런북, 로그, 서비스 중단 메시지, 알림 검토를 기반으로 합니다. 이러한 관찰 결과를 바탕으로 Gemini는 조사 중인 문제의 근본 원인에 관한 가설을 생성합니다.

  3. 가설

    이 섹션에는 조사를 통해 수집된 데이터와 관찰을 기반으로 한 하나 이상의 가설이 포함되어 있습니다. 가설에는 문제의 원인이 될 수 있는 개요와 문제를 수정하는 데 도움이 되거나 가설을 확인 또는 반박하기 위한 추가 문제 해결 단계를 제공하는 조치인 권장 수정사항이 포함됩니다.

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

다음 단계