REST Resource: projects.locations.investigations

Resource: Investigasi

Berisi konten investigasi Pemecahan Masalah Gemini Cloud Assist.

Representasi JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "revision": string,
  "revisionIndex": integer,
  "revisionPredecessor": string,
  "annotations": {
    object (InvestigationAnnotations)
  },
  "executionState": enum (InvestigationExecutionState),
  "error": {
    object (Status)
  },
  "operation": string,
  "title": string,
  "observations": {
    string: {
      object (Observation)
    },
    ...
  },
  "observerStatuses": {
    string: {
      object (ObserverStatus)
    },
    ...
  }
}
Kolom
name

string

ID. Nama penyelidikan, dalam bentuk: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}

createTime

string (Timestamp format)

Hanya output. Waktu saat investigasi dibuat.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Hanya output. Waktu saat penyelidikan terakhir diperbarui.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Opsional. Label buatan pengguna untuk penyelidikan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

revision

string

Hanya output. Nama resource revisi saat ini dari penyelidikan, dalam bentuk: projects/{projectNumber}/locations/{locationId}/investigations/{investigationId}/revisions/{revision_id}

revisionIndex

integer

Hanya output. Indeks revisi saat ini dari penyelidikan.

revisionPredecessor

string

Opsional. Nama revisi yang merupakan pendahulu revisi ini.

annotations

object (InvestigationAnnotations)

Opsional. Anotasi tambahan pada penyelidikan.

executionState

enum (InvestigationExecutionState)

Hanya output. Status eksekusi investigasi.

error

object (Status)

Hanya output. Error jika menjalankan investigasi gagal. Kolom ini hanya akan ditetapkan jika executionState adalah INVESTIGATION_EXECUTION_STATE_FAILED.

operation

string

Hanya output. Nama resource operasi Run yang terakhir dilakukan pada penyelidikan, dalam format: projects/{projectNumber}/locations/{locationId}/operations/{operation_id}

title

string

Opsional. Judul tampilan yang dapat dibaca manusia untuk investigasi.

observations

map (key: string, value: object (Observation))

Opsional. Pengamatan tentang status project yang membentuk isi penyelidikan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

observerStatuses

map (key: string, value: object (ObserverStatus))

Opsional. Status pengamat yang telah dipanggil untuk menjalankan penyelidikan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

InvestigationAnnotations

Anotasi tambahan pada Penyelidikan.

Representasi JSON
{
  "supportCase": string,
  "revisionLastRunInterval": {
    object (Interval)
  },
  "pagePath": string,
  "extrasMap": {
    string: string,
    ...
  }
}
Kolom
supportCase

string

Opsional. ID kasus dukungan yang terkait dengan penyelidikan.

revisionLastRunInterval

object (Interval)

Hanya output. Interval saat investigasi terakhir dijalankan.

pagePath

string

Opsional. Jalur halaman web tempat investigasi ini dibuat.

extrasMap

map (key: string, value: string)

Opsional. Anotasi tambahan yang ditentukan klien.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Interval

Mewakili interval waktu, yang dienkode sebagai awal Stempel waktu (inklusif) dan akhir Stempel waktu (eksklusif).

Awal harus kurang dari atau sama dengan akhir. Jika waktu mulai sama dengan waktu berakhir, intervalnya kosong (tidak cocok dengan waktu apa pun). Jika waktu mulai dan waktu berakhir tidak ditentukan, interval akan cocok dengan waktu apa pun.

Representasi JSON
{
  "startTime": string,
  "endTime": string
}
Kolom
startTime

string (Timestamp format)

Opsional. Awal interval inklusif.

Jika ditentukan, Stempel Waktu yang cocok dengan interval ini harus sama dengan atau setelah awal.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

endTime

string (Timestamp format)

Opsional. Akhir interval eksklusif.

Jika ditentukan, Stempel Waktu yang cocok dengan interval ini harus sebelum waktu berakhir.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

InvestigationExecutionState

Status eksekusi investigasi.

Enum
INVESTIGATION_EXECUTION_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
INVESTIGATION_EXECUTION_STATE_RUNNING Penyelidikan sedang dilakukan.
INVESTIGATION_EXECUTION_STATE_MODIFIED Penyelidikan belum dilakukan sejak terakhir kali diperbarui.
INVESTIGATION_EXECUTION_STATE_FAILED Eksekusi investigasi telah selesai, tetapi eksekusi gagal.
INVESTIGATION_EXECUTION_STATE_COMPLETED Semua tugas eksekusi telah selesai dan investigasi telah dihentikan.

Pengamatan

Observasi merepresentasikan satu fakta tentang status sistem yang sedang diselidiki, beserta peringkat relevansinya.

Representasi JSON
{
  "id": string,
  "timeIntervals": [
    {
      object (Interval)
    }
  ],
  "title": string,
  "observationType": enum (ObservationType),
  "observerType": enum (ObserverType),
  "text": string,
  "data": {
    object
  },
  "dataUrls": {
    string: string,
    ...
  },
  "knowledgeUrls": {
    string: string,
    ...
  },
  "baseObservations": [
    string
  ],
  "relevantResources": [
    string
  ],
  "recommendation": string,
  "systemRelevanceScore": number,
  "relevanceOverride": enum (UserRelevance),
  "observationCompletionState": enum (ObservationCompletionState),
  "observedNormalOperation": boolean
}
Kolom
id

string

Hanya output. Mengidentifikasi pengamatan ini secara unik. Nilai ini selalu sama dengan kunci peta pengamatan ini dalam investigasi induk.

timeIntervals[]

object (Interval)

Opsional. Waktu pengamatan ini terjadi.

title

string

Opsional. Judul tampilan yang dapat dibaca manusia untuk pengamatan.

observationType

enum (ObservationType)

Wajib. Jenis pengamatan.

observerType

enum (ObserverType)

Wajib. Jenis pengamat yang menghasilkan pengamatan ini.

text

string

Opsional. Teks bahasa alami atau markdown yang menjelaskan pengamatan.

data

object (Struct format)

Opsional. Representasi terstruktur dari pengamatan. Hal ini tidak diperlukan atau dijamin sesuai dengan skema tertentu.

dataUrls

map (key: string, value: string)

Opsional. URL yang mengarah ke bukti untuk mendukung pengamatan ini. Memetakan dari deskripsi yang dapat dibaca manusia ke URL.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

knowledgeUrls

map (key: string, value: string)

Opsional. URL yang mengarah ke pengetahuan referensi yang terkait dengan pengamatan ini. Memetakan dari deskripsi yang dapat dibaca manusia ke URL.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

baseObservations[]

string

Opsional. ID pengamatan lain yang menjadi dasar pengamatan ini. Misalnya, pengamatan hipotesis akan mencatat pengamatan yang mendukung hipotesis tersebut.

relevantResources[]

string

Opsional. Resource Google Cloud yang relevan dengan pengamatan. Ini harus berupa URI resource yang sepenuhnya memenuhi syarat, misalnya: "//compute.googleapis.com/projects/my-project/zones/us-central1-a/instances/my-instance"

recommendation

string

Opsional. Teks bahasa alami atau markdown yang menjelaskan tindakan yang direkomendasikan untuk memperbaiki akar penyebab atau menyelidiki lebih lanjut masalah tersebut.

systemRelevanceScore

number

Opsional. Seberapa relevan pengamatan ini menurut pengamat. Hal ini digunakan untuk memberi peringkat pengamatan dalam membuat hipotesis. Sistem menghasilkan pengamatan dalam rentang [-1, 1], dengan -1 berarti sama sekali tidak relevan, 0 berarti netral, dan 1 berarti keyakinan penuh terhadap relevansinya.

relevanceOverride

enum (UserRelevance)

Opsional. Penilaian relevansi pengguna.

observationCompletionState

enum (ObservationCompletionState)

Opsional. Menunjukkan apakah pengamatan telah sepenuhnya terbentuk dan dapat digunakan untuk menarik kesimpulan.

observedNormalOperation

boolean

Opsional. Jika salah (false) atau tidak ditentukan, pengamatan ini memberikan informasi tentang masalah atau penyebab utamanya. Jika benar (true), pengamatan ini menunjukkan bahwa sistem diamati beroperasi secara normal. Hasil negatif tersebut dapat menjadi temuan diagnostik yang berguna, dan kolom ini tidak memiliki korelasi dengan skor relevansi.

ObservationType

Ini mewakili jenis data yang membentuk pengamatan. Hal ini terlepas dari asal-usulnya: log mungkin diberikan secara eksplisit oleh pengguna, atau diekstrak melalui AI, atau ditemukan oleh runbook.

Enum
OBSERVATION_TYPE_UNSPECIFIED Nilai default.
OBSERVATION_TYPE_CLOUD_LOG Teks pengamatan ini adalah entri log.
OBSERVATION_TYPE_CLOUD_METRIC Konten pengamatan ini adalah metrik atau grup metrik.
OBSERVATION_TYPE_CAIS_CONFIG Konfigurasi
OBSERVATION_TYPE_CAIS_CONFIG_DIFF Perubahan konfigurasi
OBSERVATION_TYPE_CLOUD_ALERT Pemberitahuan
OBSERVATION_TYPE_CICD_EVENT Peristiwa dari sistem continuous integration, misalnya kegagalan prober.
OBSERVATION_TYPE_TEXT_DESCRIPTION Input teks bebas, seperti input pengguna awal. Dapat berupa markdown.
OBSERVATION_TYPE_HYPOTHESIS Ini untuk kesimpulan [sementara] yang ditarik oleh sistem. Hal ini dapat menjadi input untuk revisi berikutnya. Dalam hal ini, rekomendasi akan digunakan, tetapi tidak dengan perbaikan.
OBSERVATION_TYPE_STRUCTURED_INPUT Input terstruktur, misalnya parameter runbook yang dimasukkan ke dalam formulir
OBSERVATION_TYPE_COMPOSITE Digunakan untuk observasi yang mencakup lebih dari satu jenis bukti, seperti output runbook.
OBSERVATION_TYPE_OTHER Output runbook dapat berupa 'lainnya' jika tidak ada jenis lain yang berlaku.
OBSERVATION_TYPE_LOG_THEME Tema yang ditemukan dalam log.
OBSERVATION_TYPE_CONFIG_ANALYSIS Output sinyal yang mencakup konfigurasi yang dianalisis oleh LLM.
OBSERVATION_TYPE_OUTAGE Output sinyal yang mencakup gangguan dari PSH.
OBSERVATION_TYPE_KNOWLEDGE Teks yang memberikan pengetahuan tentang masalah pengguna tertentu. Misalnya, petunjuk/link eksternal katalog error, RAG, dll.

ObserverType

Hal ini menunjukkan cara data masuk ke Investigasi.

Enum
OBSERVER_TYPE_UNSPECIFIED Nilai default. Tidak digunakan.
OBSERVER_TYPE_DIAGNOSTICS Diagnostik memiliki gagasan eksplisit tentang akar penyebab, misalnya melalui runbook.
OBSERVER_TYPE_SIGNALS Sinyal digunakan untuk pemrosesan yang tidak memiliki penyebab utama yang jelas.
OBSERVER_TYPE_DETERMINISTIC_CODE Ini untuk kode yang hanya bergantung pada lokasi. Khususnya, pencarian katalog error.
OBSERVER_TYPE_AI Hal ini berlaku untuk inferensi AI yang hanya bergantung pada pengamatan yang tercantum sebagai premis.
OBSERVER_TYPE_USER Pengamatan input pengguna, termasuk jawaban atas klarifikasi. Semua pengamatan yang ditentukan pengguna akan dipaksa ke jenis ini.
OBSERVER_TYPE_ALERT Pengamatan dari pemberitahuan.

UserRelevance

Hal ini menunjukkan penilaian relevansi yang dinyatakan pengguna terhadap pengamatan.

Enum
USER_RELEVANCE_UNSPECIFIED Pengguna belum menandai pengamatan ini sebagai relevan atau tidak relevan.
USER_RELEVANCE_PROMOTED Pengguna menandai observasi ini sebagai relevan.
USER_RELEVANCE_REJECTED Pengguna menandai pengamatan ini sebagai tidak relevan.

ObservationCompletionState

Menentukan apakah pengamatan telah terbentuk sepenuhnya dan selesai.

Enum
OBSERVATION_COMPLETION_STATE_UNSPECIFIED Nilai default. Akan dianggap SELESAI.
OBSERVATION_COMPLETION_STATE_COMPLETE Pengamatan ini sudah lengkap.
OBSERVATION_COMPLETION_STATE_INCOMPLETE Observasi ini tidak memiliki beberapa informasi, atau perlu diproses lebih lanjut oleh pengamat lain. Jenis pengamatan ini dapat dihapus dalam proses investigasi mendatang.

ObserverStatus

ObserverStatus mewakili status pengamat pada titik tertentu selama eksekusi penyelidikan.

Representasi JSON
{
  "observer": string,
  "observerExecutionState": enum (ObserverExecution),
  "observerDisplayName": string,
  "updateTime": string,
  "startTime": string,
  "updateComment": string,
  "observerErrors": [
    {
      object (Status)
    }
  ]
}
Kolom
observer

string

Hanya output. Mengidentifikasi pengamat ini secara unik. Nilai ini selalu sama dengan kunci peta pengamat ini dalam investigasi induk.

observerExecutionState

enum (ObserverExecution)

Opsional. Status eksekusi pengamat saat ini.

observerDisplayName

string

Wajib. Nama tampilan yang dapat dibaca manusia untuk pengamat.

updateTime

string (Timestamp format)

Opsional. Waktu saat pengamat terakhir kali memperbarui penyelidikan. Jika observerExecutionState adalah COMPLETE atau FAILED, ini adalah waktu saat pengamat menyelesaikan pengamatannya.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

startTime

string (Timestamp format)

Opsional. Waktu saat pengamat memulai pengamatannya.

Menggunakan RFC 3339, dengan output yang dihasilkan akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".

updateComment

string

Opsional. Pembaruan status dari pengamat.

observerErrors[]

object (Status)

Opsional. Error yang mencegah pengamat membuat pengamatan tertentu.

ObserverExecution

Status pengamat.

Enum
OBSERVER_EXECUTION_UNSPECIFIED Status pengamat tidak ditentukan.
OBSERVER_EXECUTION_NOT_STARTED Penyelidikan belum dimulai.
OBSERVER_EXECUTION_RUNNING Investigasi sedang berjalan dan pengamat ini dapat dijalankan atau sedang berjalan.
OBSERVER_EXECUTION_COMPLETE Observer telah selesai tanpa error internal.
OBSERVER_EXECUTION_FAILED Pengamat mencoba berlari, tetapi gagal karena terjadi error. Hal ini khusus untuk komponen dan dapat dirender di UI jika pengamatan ditampilkan, sebagai prioritas yang sangat rendah.
OBSERVER_EXECUTION_BLOCKED Pengamat diblokir sambil menunggu input.
OBSERVER_EXECUTION_INVESTIGATION_BLOCKED Pengamat melaporkan error yang memblokir atau sangat memengaruhi penyelidikan, misalnya CAIS atau logging dinonaktifkan. Harus ditampilkan dengan jelas di UI.
OBSERVER_EXECUTION_INVESTIGATION_DEGRADED Pengamat melaporkan error yang menurunkan kualitas penyelidikan, mungkin mengharuskan pengguna untuk meningkatkan atau menjalankan ulang penyelidikan setelah mengurangi penyebabnya.

Metode

create

Membuat Investigasi baru dalam project tertentu.

delete

Menghapus satu Investigasi.

get

Mendapatkan detail satu Investigasi.

getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource.

list

Mencantumkan Investigasi dalam project dan lokasi tertentu.

patch

Memperbarui parameter satu Investigasi.

setIamPolicy

Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

Menampilkan izin yang dimiliki pemanggil pada resource tertentu.