Membuat investigasi Cloud Assist

Halaman ini menunjukkan cara membuat dan meninjau investigasi Gemini Cloud Assist.

Sebelum memulai

  1. Pastikan project Anda telah mengaktifkan API berikut:

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

    Lihat Mengaktifkan dan menonaktifkan layanan untuk mengetahui petunjuk tentang cara mengaktifkan API.

  2. Untuk mendapatkan izin yang diperlukan guna membuat penyelidikan, minta administrator Anda untuk memberi Anda peran IAM Investigation Creator (roles/geminicloudassist.investigationCreator) di project.

    Peran bawaan ini berisi izin yang diperlukan untuk membuat penyelidikan dalam project Anda. Saat membuat investigasi, Anda akan diberi peran IAM Pemilik Investigasi (roles/geminicloudassist.investigationOwner) pada investigasi tersebut, yang memungkinkan Anda meninjau hasil investigasi.

  3. Memiliki akses ke produk yang sedang diselidiki.

    Saat Anda melakukan penyelidikan, Gemini Cloud Assist menggunakan kredensial Anda untuk mengakses API dan informasi. Artinya, akses investigasi dibatasi hanya untuk akses yang Anda miliki.

  4. Jika Anda berencana melakukan penyelidikan pada aplikasi, aplikasi tersebut harus berada dalam folder yang mendukung aplikasi.

Membuat penyelidikan

Konsol

  1. Untuk membuat penyelidikan baru, klik tombol Selidiki yang terkait dengan titik entri Anda. Titik entri umum untuk membuat investigasi adalah halaman Investigasi Cloud Assist.

    Buka Investigasi Cloud Assist

  2. (Opsional) Masukkan Nama untuk penyelidikan Anda.

    Nama yang Anda pilih akan mengidentifikasi penyelidikan ini di histori penyelidikan Anda. Nama untuk investigasi dibuat secara otomatis jika Anda melewati langkah ini.

  3. Jelaskan masalah yang Anda alami.

    Anda dapat menyalin dan menempelkan pesan error persis seperti yang Anda terima, Anda dapat menggunakan bahasa alami untuk menjelaskan masalah yang Anda alami, atau Anda dapat menyertakan keduanya.

  4. Pilih Waktu mulai saat masalah yang sedang Anda selidiki dimulai.

  5. (Opsional) Pilih Waktu berakhir saat masalah yang sedang Anda selidiki berakhir.

  6. Jika penyelidikan aplikasi didukung oleh titik entri Anda, gunakan kolom Aplikasi untuk memilih aplikasi yang akan diselidiki.

    • Untuk titik entri yang tidak mendukung penyelidikan aplikasi, project Anda saat ini dicantumkan sebagai Project target dan tidak dapat diubah.
  7. (Opsional) Klik + Tambahkan aset untuk memilih aset yang terpengaruh oleh masalah yang Anda alami.

    Anda dapat menambahkan referensi menggunakan alat pilih referensi atau dengan memasukkannya secara manual. Saat memasukkan resource secara manual, Anda harus melihat dokumentasi referensi resource untuk memastikan Anda menggunakan format yang benar.

    Anda tidak dapat melanjutkan penyelidikan jika menyertakan salah satu dari hal berikut:

    • Resource yang ada dalam project atau aplikasi yang berada di luar cakupan investigasi.
    • Resource yang tidak didukung.
    • Resource yang tidak dikenali.
  8. Klik Buat untuk memulai penyelidikan.

Penyelidikan dapat memakan waktu hingga beberapa menit. Anda dapat memeriksa status penyelidikan dengan mengklik tombol Notifikasi ().

API

  1. Buat file JSON yang berisi informasi berikut:

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

    Ganti kode berikut:

    • INVESTIGATION_NAME: Masukkan nama untuk penyelidikan. Contohnya, Missing Cloud Storage bucket.

    • PROJECT_NAME: Masukkan nama project tempat penyelidikan dibuat. Contoh, my-project.

    • ISSUE_START_TIME: Masukkan tanggal dan waktu saat masalah yang sedang Anda selidiki dimulai. Contoh, 2025-07-08T17:23:00Z.

    • ISSUE_DESCRIPTION: Masukkan deskripsi masalah yang Anda alami. Anda dapat menyertakan pesan error persis yang Anda terima, Anda dapat menggunakan bahasa natural untuk menjelaskan masalah yang Anda alami, atau Anda dapat menyertakan keduanya.

    • AFFECTED_RESOURCE: Masukkan nama resource yang terlibat dalam masalah yang Anda alami. Contoh, //storage.googleapis.com/my-bucket. Untuk memastikan Anda menggunakan format yang benar untuk resource, Anda harus melihat dokumentasi referensi resource.

    Untuk representasi lengkap resource penyelidikan, lihat spesifikasi resource.

  2. Dapatkan token akses:

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

  3. Gunakan metode investigations.create untuk membuat investigasi:

    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"
    

    Ganti kode berikut:

    • JSON_FILE_NAME: Masukkan jalur ke file JSON yang Anda buat sebelumnya. Contoh, Desktop/my-investigation.json.

    • PROJECT_NAME: Masukkan nama project yang sama dengan yang Anda sertakan dalam pengamatan user.project.

  4. Dalam respons, salin nilai di parameter revision.

  5. Gunakan metode investigations.revisions.run untuk menjalankan investigasi:

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

    Ganti REVISION_RESOURCE dengan nilai yang Anda salin dari parameter revision.

Penyelidikan dapat memakan waktu hingga beberapa menit. Anda dapat memeriksa status penyelidikan dengan menyalin nilai parameter name yang ditampilkan dalam respons investigations.revisions.run dan menggunakan nilai tersebut dalam parameter name dari permintaan operations.get.

Meninjau Investigasi

Setelah penyelidikan selesai, Anda dapat melihat detail penyelidikan dari titik entri tempat Anda memulai penyelidikan atau dari histori penyelidikan project Anda.

Investigasi berisi bagian berikut:

  1. Masalah

    Bagian ini berisi informasi input yang digunakan untuk menghasilkan hasil penyelidikan, seperti deskripsi masalah, stempel waktu, dan daftar resource yang relevan. Ada tiga jenis daftar resource yang mungkin terkait dengan penyelidikan:

    • Resource yang disediakan pengguna: Resource yang disediakan oleh pengguna atau diambil dari error awal.
    • Referensi yang ditemukan: Referensi tambahan yang dipertimbangkan oleh Gemini saat melakukan penyelidikan.
    • Referensi yang relevan: Referensi yang dianggap relevan oleh Gemini dengan hipotesis penyebab utama, yang selalu mencakup referensi yang diberikan pengguna.
  2. Pengamatan

    Bagian ini berisi pengamatan yang dihasilkan oleh penyelidikan. Pengamatan didasarkan pada peninjauan runbook prosedural, log, pesan gangguan, dan pemberitahuan. Dari pengamatan ini, Gemini membuat hipotesis mengenai penyebab utama masalah yang sedang Anda selidiki.

  3. Hipotesis

    Bagian ini berisi satu atau beberapa hipotesis berdasarkan data yang dikumpulkan penyelidikan dan pengamatan yang dilakukan. Hipotesis berisi Ringkasan tentang kemungkinan penyebab masalah dan Perbaikan yang direkomendasikan yang merupakan tindakan yang membantu Anda memperbaiki masalah atau memberikan langkah-langkah pemecahan masalah tambahan untuk mengonfirmasi atau menyangkal hipotesis.

Anda dapat merevisi input penyelidikan menggunakan tombol Edit, yang memungkinkan Anda menjalankan ulang penyelidikan dengan informasi yang diperbarui. Jika investigasi memiliki beberapa proses yang terkait dengannya, Anda dapat meninjau hasil proses investigasi sebelumnya menggunakan pemilih drop-down Revisi.

Langkah berikutnya