Membuat investigasi Gemini Cloud Assist

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

Sebelum memulai

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.
Untuk mendapatkan izin yang diperlukan guna membuat penyelidikan, minta administrator 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.
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.
Jika Anda berencana melakukan penyelidikan pada aplikasi, aplikasi tersebut harus berada dalam folder yang dikonfigurasi untuk pengelolaan aplikasi. Gemini Cloud Assist tidak mendukung aplikasi yang dibuat di project host atau batas satu project.

Membuat penyelidikan

Konsol

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
Luaskan drop-down Konfigurasi investigasi.
(Opsional) Masukkan Nama investigasi untuk investigasi Anda.

Nama yang Anda pilih akan mengidentifikasi penyelidikan ini di histori penyelidikan Anda. Nama untuk investigasi akan dibuat secara otomatis jika Anda melewati langkah ini.
Gunakan drop-down Pilih rentang waktu untuk memilih rentang waktu yang ingin Anda selidiki.

Waktu mulai yang akurat memungkinkan korelasi berbasis waktu dibuat di seluruh peristiwa yang tampaknya tidak terkait dan menambah bobot pada peristiwa yang terjadi mendekati waktu mulai. Jika tidak yakin dengan rentang waktu, Anda dapat menjalankan beberapa penyelidikan secara bersamaan dengan rentang waktu yang berbeda.
Jelaskan masalah yang Anda alami.

Anda dapat menyalin dan menempelkan pesan error persis yang Anda terima, menggunakan bahasa alami untuk menjelaskan masalah yang Anda alami, atau menyertakan keduanya.
Jika penyelidikan aplikasi didukung oleh titik entri Anda, gunakan kolom Aplikasi untuk memilih aplikasi yang akan diselidiki.
(Opsional) Klik + Tambahkan aset untuk memilih aset yang terpengaruh oleh masalah yang Anda alami.

Anda dapat menambahkan resource menggunakan alat pilih resource 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.
Klik Buat untuk memulai penyelidikan.

Halaman Detail untuk investigasi akan terbuka, dan hasil akan muncul di halaman saat tersedia. Penyelidikan dapat memakan waktu hingga beberapa menit. Jika Anda keluar dari halaman detail investigasi, Anda dapat memeriksa status investigasi dengan mengklik tombol Notifikasi ().

API

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, menggunakan bahasa natural untuk menjelaskan masalah yang Anda alami, atau 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.
Dapatkan token akses:
```
TOKEN=$(gcloud auth print-access-token)
```
Gunakan metode investigations.create untuk membuat penyelidikan:
```
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.
Dalam respons, salin nilai di parameter revision.
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

Saat menangani penyelidikan di konsol Google Cloud , Anda dapat melihat detail penyelidikan dari titik entri tempat Anda memulai penyelidikan atau dari histori penyelidikan project Anda.

Investigasi berisi bagian berikut:

Rangkuman investigasi

Bagian ini berisi ringkasan tingkat tinggi masalah, strategi yang dilakukan Gemini untuk menyelidiki, dan temuan utama penyelidikan.
Hipotesis

Bagian ini berisi satu atau beberapa kartu hipotesis berdasarkan data yang dikumpulkan penyelidikan dan pengamatan yang dilakukan. Anda dapat menemukan detail untuk setiap hipotesis dengan mengklik tombol Lihat di kartu yang relevan.
- Detail hipotesis berisi bagian Apa yang menjelaskan kemungkinan masalah dan bagian Langkah berikutnya yang menjelaskan tindakan yang membantu Anda memperbaiki masalah atau memberikan langkah-langkah pemecahan masalah tambahan untuk mengonfirmasi atau menyangkal hipotesis.
  - Jika perbaikan didukung untuk masalah yang diidentifikasi dalam hipotesis, tombol Buat rencana akan disertakan dalam langkah-langkah perbaikan. Mengklik Buat Rencana akan membuat rencana perbaikan langkah demi langkah, yang mencakup tindakan konkret seperti perintah gcloud atau manifes Kubernetes. Setelah meninjau rencana, Anda dapat mengklik Jalankan untuk melakukan tindakan yang dijelaskan dalam rencana.
Temuan

Bagian ini berisi pengamatan yang dihasilkan oleh penyelidikan dan mencantumkan resource Google Cloud yang terlibat dalam penyelidikan. Pengamatan didasarkan pada peninjauan runbook prosedural, log, pesan gangguan, dan pemberitahuan.

Bagian temuan menunjukkan informasi yang digunakan Gemini untuk membuat hipotesis dan dapat membantu Anda menyempurnakan penyelidikan.

Anda dapat merevisi input penyelidikan menggunakan tombol Edit, yang memungkinkan Anda menjalankan kembali 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.

Jika memiliki paket dukungan, Anda dapat mengklik tombol Minta dukungan yang ada di halaman detail penyelidikan untuk mengajukan kasus dukungan. Saat melakukannya, Anda dapat mengisi detail kasus secara otomatis dan membagikan hasil penyelidikan kepada engineer dukungan.

Langkah berikutnya

Pelajari lebih lanjut penyelidikan.
Melihat dan mengelola penyelidikan yang ada.