REST Resource: projects.locations.investigations

Resource: Investigasi

Pesan yang menjelaskan ID Berikutnya objek Investigasi: 24

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)
    },
    ...
  },
  "clarificationsNeeded": {
    string: {
      object (ClarificationNeeded)
    },
    ...
  }
}
Kolom
name

string

ID. Nama resource
createTime

string (Timestamp format)

Hanya output. [Khusus Output] Stempel waktu pembuatan

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. [Khusus Output] Stempel waktu pembaruan

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 sebagai pasangan nilai kunci

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

string

Hanya output. [Khusus output] Revisi saat ini dari investigasi
revisionIndex

integer

Hanya output. [Khusus output] Indeks revisi saat ini dari penyelidikan. Berbasis 1.
revisionPredecessor

string

Opsional. Nama revisi yang merupakan pendahulu revisi ini. Misalnya, UI akan menyetel ini ke revisi yang ada saat revisi baru dibuat karena pengeditan.
annotations

object (InvestigationAnnotations)

Opsional. Anotasi pada penyelidikan. Tidak seperti label, nilai ini dapat memiliki makna semantik dalam menjalankan penyelidikan, dan tidak akan dibaca oleh sistem lain seperti penagihan.
executionState

enum (InvestigationExecutionState)

Hanya output. [Khusus output] Status eksekusi penyelidikan ini.
error

object (Status)

Hanya output. [Khusus output] Jika status eksekusi penyelidikan adalah FAILED, kolom ini akan berisi pesan error.
operation

string

Hanya output. Operasi Jalankan yang terakhir dilakukan pada investigasi.
title

string

Wajib. Judul tampilan yang dapat dibaca manusia untuk investigasi.
observations

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

Opsional. Peta dari ID observasi ke observasi. Ini adalah peta sehingga kita dapat mengganti pengamatan lama dengan bersih menggunakan versi dari revisi terbaru. Lihat Pengamatan untuk mendapatkan panduan dalam memilih ID.

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

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

Opsional. Versi jamak dari di atas. Kode akan bertransisi ke kode ini seiring waktu.

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

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

Opsional. Pertanyaan yang perlu diajukan sistem kepada pengguna. Hasilnya akan dikirim kembali oleh UI sebagai Pengamatan baru. ID untuk pengamatan tersebut akan menjadi kunci entri di peta clarificationsNeeded.

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

InvestigationAnnotations

Anotasi tambahan yang ditentukan pengguna pada Investigasi. Ada beberapa yang telah ditentukan sebelumnya, dan peta untuk aplikasi baru yang akan ditambahkan sendiri.

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

boolean

Hanya output. Tindak lanjut diperlukan untuk melanjutkan penyelidikan. Umumnya disetel ke benar oleh pemecah masalah dan salah jika pertanyaan telah dijawab.
extrasMap

map (key: string, value: string)

Opsional. Anotasi tambahan yang diperlukan oleh aplikasi. Informasi ini tidak akan disamarkan dan TIDAK BOLEH berisi CCC/PII apa pun.

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

object (Interval)

Opsional. Waktu mulai/berakhir saat revisi terakhir dijalankan.

Interval

Mewakili interval waktu, 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 awal dan akhir 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 akhir.

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 Investigasi belum dilakukan sejak gejala terakhir 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

Pengamatan adalah unit dasar pertukaran antara pengguna dan sistem, atau antara berbagai komponen sistem. Elemen ini adalah elemen yang memiliki relevansi. Oleh karena itu, pengamatan harus relatif kecil; jika Anda ingin pengguna bereaksi terhadap "bagian" dari pengamatan, pengamatan tersebut harus dipecah menjadi pengamatan yang lebih kecil. Runbook tertentu yang dijalankan, input parameter pengguna tertentu, entri log menarik tertentu semuanya mungkin merupakan pengamatan terpisah. Artinya, mungkin ada puluhan atau ratusan dalam penyelidikan. ID Berikutnya: 26

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

Wajib. Mengidentifikasi pengamatan ini secara unik. Harus bergantung pada 'konten inti' pengamatan, tetapi tidak bergantung pada relevansinya. Tidak boleh bergantung pada apa pun yang dapat berubah secara tidak terduga dari revisi ke revisi untuk dijalankan. Ini juga merupakan kunci peta dalam Investigasi induk. Nama tersebut harus hierarkis dengan '.' sebagai pemisah yang dimulai dengan nama pengamat. Jadi, misalnya, diagnostics.runbook.ABC, atau signals.logs, atau user.input.2. Harus dapat digunakan sebagai komponen URL. (Tidak peka huruf besar/kecil [a-z0-9-._]+) Ini tidak akan dirender untuk pengguna, tetapi akan terlihat dalam model data. String ini akan digunakan oleh engineer Google untuk melokalkan bug, sehingga harus dapat dibaca sebagian.
timeIntervals[]

object (Interval)

Opsional. Waktu pengamatan ini terjadi. Pengamatan harus memiliki setidaknya satu rentang waktu agar pengamatan dapat ditampilkan di linimasa dan agar kami dapat menemukan peristiwa terkait. Untuk acara yang berulang tetapi tidak berkelanjutan, sebaiknya memiliki lebih dari satu rentang. UI dapat menggabungkan keduanya.
title

string

Opsional. Label yang ditampilkan di UI. ID ini tidak harus unik dalam penyelidikan. Namun, harus spesifik dan kurang dari 80 karakter sehingga pengguna dapat dengan mudah memindai banyak pengamatan. "Pod Nettools yang dikonfigurasi dengan SEMUA kemampuan dihentikan" jauh lebih baik daripada "Konfigurasi pod yang menarik".
observationType

enum (ObservationType)

Wajib. Jenis pengamatan (misalnya, log, metrik, dll.)
observerType

enum (ObserverType)

Wajib. Asal data, misalnya pengguna, kode sistem, LLM, dll.
text

string

Opsional. Teks [markdown] bahasa alami yang terkait dengan observasi. Ini adalah konten inti, bukan deskripsi metadata.
data

object (Struct format)

Opsional. Representasi terstruktur dari pengamatan, sebagaimana dipilih oleh pengamat. Opsional. Jika ada, pengamat JUGA HARUS memberikan deskripsi teks pengamatan untuk memfasilitasi pemrosesan oleh LLM dan rendering di UI.
dataUrls

map (key: string, value: string)

Opsional. Peta dari nama yang dapat dibaca manusia ke URL untuk bukti pendukung. Kunci peta akan dirender sebagai teks link URL. Isi ini setiap kali pengamatan bergantung pada sesuatu di luar sistem. Misalnya, kueri logging/metrik/dll. yang dapat membuat ulang pengamatan.

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

map (key: string, value: string)

Opsional. Peta dari nama yang dapat dibaca manusia ke URL untuk dokumentasi.

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 kesimpulan akan mencatat pengamatan yang digunakan untuk membuatnya. Parameter yang diekstrak akan mencatat dari mana parameter tersebut diekstrak. Grafik premis dan kesimpulan akan asiklik dalam revisi.
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 [markdown] bahasa alami yang menjelaskan tindakan yang direkomendasikan untuk memperbaiki / mengatasi akar penyebab. Ini adalah formulir bebas dan tidak diproses oleh mesin saat ini. Rekomendasi dapat berupa: - Deskripsi perbaikan tingkat tinggi - Langkah-langkah perbaikan taktis dan spesifik dengan perintah yang dapat dieksekusi - Langkah-langkah pemecahan masalah taktis dan spesifik untuk mengetahui tempat penyelidikan selanjutnya dengan perintah yang dapat dieksekusi
systemRelevanceScore

number

Opsional. Seberapa relevan pengamatan ini dengan penyelidikan, sebagaimana disimpulkan oleh sistem. Opsional. Harus dalam rentang [-1, 1]. Untuk OBSERVATION_TYPE_HYPOTHESIS, menunjukkan keyakinan terhadap penjelasan. Hanya hipotesis penyebab utama yang diberi peringkat satu sama lain. Untuk ObservationType lainnya, nilai ini mewakili skor relevansi, dan diberi peringkat satu sama lain. Nilai 0 bersifat netral.
relevanceOverride

enum (UserRelevance)

Opsional. Penilaian relevansi pengguna.
observationCompletionState

enum (ObservationCompletionState)

Opsional. ObservationCompletionState menunjukkan apakah pengamatan yang dipancarkan terbentuk sepenuhnya dan harus ditampilkan kepada pengguna. Tujuannya adalah untuk memungkinkan penyembunyian pengamatan yang berada dalam status perantara.
observedNormalOperation

boolean

Opsional. Apakah pengamatan ini memberi kita informasi tentang masalah / penyebab utama (salah) atau menunjukkan operasi normal (benar). Hal ini secara konseptual berbeda dari relevansi dan digunakan secara berbeda. Pengamatan yang tidak relevan harus disembunyikan dari LLM dan juga pengguna. Pengamatan masalah yang relevan harus ditampilkan sebagai pengamatan dan harus memotivasi hipotesis. Temuan normalitas yang relevan dapat / mungkin tidak ditampilkan di UI, tetapi harus digunakan oleh LLM untuk memfilter hipotesis yang dibantah oleh temuan tersebut.

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 Jangan gunakan. Tentukan jenis pengamatan. Tambahkan enum baru jika Anda membutuhkannya.
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 Jangan gunakan. Tentukan asal pengamatan. Tambahkan enum baru jika Anda membutuhkannya.
OBSERVER_TYPE_DIAGNOSTICS Kami memisahkannya karena alasan atribusi internal. Diagnostik memiliki gagasan eksplisit tentang akar penyebab, misalnya melalui runbook.
OBSERVER_TYPE_SIGNALS Sinyal digunakan untuk pemrosesan yang tidak memiliki akar masalah 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 dibuat di sepanjang proses yang hanya bergantung pada pengamatan yang tercantum sebagai premis.
OBSERVER_TYPE_USER Pengamatan input pengguna, termasuk jawaban atas klarifikasi.
OBSERVER_TYPE_ALERT Pengamatan dari pemberitahuan eksternal ke GCA.

UserRelevance

Hal ini menunjukkan penilaian relevansi yang dinyatakan pengguna terhadap pengamatan. UI-nya akan berupa ikon suka atau tidak suka.

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. Sebagai efek samping, hal ini menentukan apakah pengamatan ditampilkan kepada pengguna.

Enum
OBSERVATION_COMPLETION_STATE_UNSPECIFIED Jangan gunakan.
OBSERVATION_COMPLETION_STATE_COMPLETE Pengamatan ini sudah lengkap dan harus ditampilkan kepada pengguna.
OBSERVATION_COMPLETION_STATE_INCOMPLETE Pengamatan ini tidak memiliki beberapa informasi, atau perlu diproses lebih lanjut oleh pengamat lain. Jenis Observasi ini tidak boleh dipertahankan ke dalam revisi penyelidikan mendatang.

ObserverStatus

ObserverStatus mewakili status pengamat pada titik tertentu selama eksekusi penyelidikan. CATATAN: Secara default, tidak ada yang disamarkan dalam pesan ini. Komponen TIDAK boleh menempatkan PII / CCC di sini, kecuali jika disamarkan. ID Berikutnya: 13

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

string

Wajib. ID pengamat yang statusnya ini. ID pengamat harus dapat dibaca oleh manusia dan bersifat hierarkis, misalnya "signals.logs.firewall_rules" atau "diagnostics.error_catalog".
observerExecutionState

enum (ObserverExecution)

Opsional. Status eksekusi pengamat saat ini.
observerDisplayName

string

Wajib. Nama yang akan ditampilkan kepada pengguna saat menjelaskan pengamat ini. Perhatikan bahwa UI dapat mengganti ini dengan padanan kata yang dilokalkan, sehingga tidak boleh dibuat secara dinamis. Diperlukan agar pengguna dapat melihat observer (misalnya, runbook) yang sedang dibicarakan oleh sistem.
updateTime

string (Timestamp format)

Opsional. Waktu saat status diperbarui. Opsional karena pengamat bertanggung jawab untuk menyetelnya. Menjadi endTime saat pengamat selesai.

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. Opsional karena pengamat bertanggung jawab untuk menyetelnya. Setelah pengamat selesai, perbedaan antara ini dan updateTime adalah waktu proses pengamat.

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. Mungkin dicatat untuk tujuan proses debug. Ini dapat ditampilkan kepada pengguna. Pembaruan yang baik adalah "parameter cocok, diantrekan untuk dieksekusi" atau "file log yang diperiksa 2/5".
observerErrors[]

object (Status)

Opsional. Error dalam sistem Investigasi yang mencegah pengamat membuat pengamatan tertentu. String error di sini akan ditampilkan kepada pengguna. Diulang karena observer mungkin tidak memiliki beberapa izin.

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.

AbsentObservation

ID pengamatan yang diperlukan. Biasanya berupa parameter, tetapi dapat diperluas ke kasus lain.

Representasi JSON 
{

  // Union field t can be only one of the following:
  "param": string,
  "generalMissingObservation": {
    object (GeneralAbsentObservation)
  },
  "pendingObservation": string
  // End of list of possible types for union field t.
}
Kolom
Kolom union t. Ada lebih dari satu jenis parameter yang tidak ada. t hanya ada berupa salah satu diantara berikut:
param

string

Opsional. Parameter runbook.
generalMissingObservation

object (GeneralAbsentObservation)

Opsional. Observasi yang tidak ada yang dapat diberikan pengguna yang bukan merupakan parameter runbook.
pendingObservation

string

Opsional. Pengamatan yang belum dibuat yang harus dibuat oleh pengamat dengan menjalankan. Hal ini dapat memicu sistem untuk menjalankan runbook.

GeneralAbsentObservation

Pengamatan yang tidak ada yang bukan merupakan parameter runbook.

Representasi JSON 
{
  "id": string,
  "title": string,
  "validationRegex": string
}
Kolom
id

string

Opsional. ID pengamatan yang tidak ada.
title

string

Opsional. Judul yang akan ditampilkan di UI
validationRegex

string

Opsional. Ekspresi reguler yang harus cocok dengan jawaban. Harus sesuai dengan sintaksis pola string ekspresi reguler JavaScript. Lihat https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp/RegExp#syntax

ObserverLogEntry

Entri log dari pengamat.

Representasi JSON 
{
  "logTime": string,
  "logMessage": string,
  "logSeverity": enum (LogSeverity),
  "data": {
    object
  },
  "sensitiveData": {
    object
  }
}
Kolom
logTime

string (Timestamp format)

Wajib. Waktu saat log 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".
logMessage

string

Wajib. Pesan yang dapat dibaca manusia.
logSeverity

enum (LogSeverity)

Wajib. Tingkat keparahan pesan log.
data

object (Struct format)

Opsional. Data tambahan, seperti error RPC. Peringatan: seperti ObserverStatus lainnya, konten kolom ini dapat dibaca untuk tujuan proses debug Observer. Untuk data sensitif, gunakan sensitiveData.
sensitiveData

object (Struct format)

Opsional. Data tambahan apa pun yang mungkin berisi informasi sensitif tentang proyek yang sedang diselidiki. Kolom ini akan disamarkan saat ObserverStatus dibaca untuk tujuan penelusuran bug.

LogSeverity

Tingkat keparahan peristiwa yang dijelaskan dalam entri log, yang dinyatakan sebagai salah satu tingkat keparahan standar yang tercantum di bawah. Sebagai referensi Anda, tingkat diberi nilai numerik yang tercantum. Efek penggunaan nilai numerik selain yang tercantum tidak ditentukan.

Anda dapat memfilter entri log menurut tingkat keparahan. Misalnya, ekspresi filter berikut akan cocok dengan entri log dengan tingkat keparahan INFO, NOTICE, dan WARNING:

severity > DEBUG AND severity <= WARNING

Jika Anda menulis entri log, Anda harus memetakan encoding tingkat keparahan lainnya ke salah satu tingkat standar ini. Misalnya, Anda dapat memetakan semua level FINE, FINER, dan FINEST Java ke LogSeverity.DEBUG. Anda dapat mempertahankan tingkat keparahan asli dalam payload entri log jika diinginkan.

Enum
DEFAULT (0) Entri log tidak memiliki tingkat keparahan yang ditetapkan.
DEBUG (100) Informasi debug atau pelacakan.
INFO (200) Informasi rutin, seperti status atau performa yang sedang berlangsung.
NOTICE (300) Peristiwa normal tetapi signifikan, seperti mulai, berhenti, atau perubahan konfigurasi.
WARNING (400) Peristiwa peringatan dapat menyebabkan masalah.
ERROR Peristiwa error (500) kemungkinan akan menyebabkan masalah.
CRITICAL (600) Peristiwa kritis menyebabkan masalah atau gangguan yang lebih parah.
ALERT (700) Seseorang harus segera mengambil tindakan.
EMERGENCY (800) Satu atau beberapa sistem tidak dapat digunakan.

ClarificationNeeded

Klarifikasi yang diperlukan oleh sistem.

Representasi JSON 
{
  "runbookParameter": {
    object (RunbookParameter)
  },
  "generalMissingObservation": {
    object (GeneralAbsentObservation)
  },
  "parentObserverNames": [
    string
  ]
}
Kolom
runbookParameter

object (RunbookParameter)

Opsional. Hasil klarifikasi adalah pengamatan. Parameter runbook yang harus diberikan pengguna.
generalMissingObservation

object (GeneralAbsentObservation)

Opsional. Observasi yang tidak ada yang bukan merupakan parameter runbook.
parentObserverNames[]

string

Opsional. Nama tampilan pengamat yang meminta klarifikasi ini. UI akan dikelompokkan berdasarkan nama ini.

RunbookParameter

Metadata parameter untuk runbook yang diperbarui oleh tugas Diagnostik.

Representasi JSON 
{
  "id": string,
  "displayName": string,
  "description": string,
  "exampleValues": [
    string
  ],
  "value": string,
  "associatedAssetTypes": [
    string
  ]
}
Kolom
id

string

Opsional. Nama parameter.
displayName

string

Opsional. Nama parameter yang akan ditampilkan kepada pengguna.
description

string

Opsional. Deskripsi parameter.
exampleValues[]

string

Opsional. Contoh nilai parameter.
value

string

Opsional. Nilai parameter jika tersedia.
associatedAssetTypes[]

string

Opsional. Jika ada, daftar jenis resource yang mungkin menjadi parameter ini. Misalnya, "compute.googleapis.com/Instance".

Metode

create

 Membuat Investigasi baru di project dan lokasi 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.