MCP Tools Reference: monitoring.googleapis.com

Alat: get_alert_policy

Gunakan ini sebagai alat utama untuk mendapatkan informasi tentang kebijakan pemberitahuan tertentu. Kebijakan pemberitahuan menentukan kondisi saat Anda ingin mendapatkan pemberitahuan tentang masalah pada layanan Anda. Hal ini berguna untuk memahami detail konfigurasi notifikasi tertentu.

Contoh berikut menunjukkan cara menggunakan curl untuk memanggil alat MCP get_alert_policy.

Permintaan Curl 
                  
curl --location 'https://monitoring.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "get_alert_policy",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Skema Input

Protokol untuk permintaan GetAlertPolicy.

GetAlertPolicyRequest

Representasi JSON 
{
  "name": string
}
Kolom
name

string

Wajib. Kebijakan pemberitahuan yang akan diambil. Formatnya adalah:

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

Skema Output

Deskripsi kondisi yang menyebabkan beberapa aspek sistem Anda dianggap "tidak responsif" dan cara untuk memberi tahu orang atau layanan tentang kondisi ini. Untuk ringkasan kebijakan pemberitahuan, lihat Pengantar Pemberitahuan.

AlertPolicy

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "documentation": {
    object (Documentation)
  },
  "userLabels": {
    string: string,
    ...
  },
  "conditions": [
    {
      object (Condition)
    }
  ],
  "combiner": enum (ConditionCombinerType),
  "enabled": boolean,
  "validity": {
    object (Status)
  },
  "notificationChannels": [
    string
  ],
  "creationRecord": {
    object (MutationRecord)
  },
  "mutationRecord": {
    object (MutationRecord)
  },
  "alertStrategy": {
    object (AlertStrategy)
  },
  "severity": enum (Severity)
}
Kolom
name

string

ID. Wajib jika kebijakan ada. Nama resource untuk kebijakan ini. Formatnya adalah:

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[ALERT_POLICY_ID]

[ALERT_POLICY_ID] ditetapkan oleh Cloud Monitoring saat kebijakan dibuat. Saat memanggil metode alertPolicies.create, jangan sertakan kolom name dalam kebijakan pemberitahuan yang diteruskan sebagai bagian dari permintaan.
displayName

string

Nama atau frasa singkat yang digunakan untuk mengidentifikasi kebijakan di dasbor, notifikasi, dan insiden. Agar tidak membingungkan, jangan gunakan nama tampilan yang sama untuk beberapa kebijakan dalam project yang sama. Nama dibatasi hingga 512 karakter Unicode.

Konvensi untuk display_name PrometheusQueryLanguageCondition adalah "{rule group name}/{alert name}", dengan {rule group name} dan {alert name} harus diambil dari file konfigurasi Prometheus yang sesuai. Konvensi ini tidak diterapkan. Bagaimanapun, display_name bukanlah kunci unik AlertPolicy.
documentation

object (Documentation)

Dokumentasi yang disertakan dengan notifikasi dan insiden terkait kebijakan ini. Praktik terbaiknya adalah dokumentasi harus menyertakan informasi untuk membantu responden memahami, mengurangi, meningkatkan, dan memperbaiki masalah mendasar yang terdeteksi oleh kebijakan pemberitahuan. Channel notifikasi yang memiliki kapasitas terbatas mungkin tidak menampilkan dokumentasi ini.
userLabels

map (key: string, value: string)

Data key/value yang disediakan pengguna untuk digunakan dalam mengatur dan mengidentifikasi objek AlertPolicy.

Kolom dapat berisi hingga 64 entri. Setiap kunci dan nilai dibatasi hingga 63 karakter Unicode atau 128 byte, mana saja yang lebih kecil. Label dan nilai hanya boleh berisi huruf kecil, angka, garis bawah, dan tanda hubung. Kunci harus diawali dengan huruf.

Perhatikan bahwa Prometheus {alert name} adalah nama label Prometheus yang valid, sedangkan Prometheus {rule group} adalah string UTF-8 yang tidak dibatasi. Artinya, nilai tersebut tidak dapat disimpan apa adanya di label pengguna, karena mungkin berisi karakter yang tidak diizinkan dalam nilai label pengguna.

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

object (Condition)

Daftar kondisi untuk kebijakan. Kondisi digabungkan dengan AND atau OR sesuai dengan kolom combiner. Jika kondisi gabungan bernilai benar, maka insiden akan dibuat. Kebijakan dapat memiliki satu hingga enam kondisi. Jika ada, condition_time_series_query_language harus menjadi satu-satunya condition. Jika ada, condition_monitoring_query_language harus menjadi satu-satunya condition.
combiner

enum (ConditionCombinerType)

Cara menggabungkan hasil beberapa kondisi untuk menentukan apakah insiden harus dibuka. Jika condition_time_series_query_language ada, ini harus COMBINE_UNSPECIFIED.
enabled

boolean

Apakah kebijakan diaktifkan atau tidak. Saat penulisan, interpretasi default jika tidak disetel adalah bahwa kebijakan diaktifkan. Saat membaca, klien tidak boleh membuat asumsi apa pun tentang status jika belum diisi. Kolom harus selalu diisi pada operasi List dan Get, kecuali jika proyeksi kolom telah ditentukan yang menghapusnya.
validity

object (Status)

Deskripsi hanya baca tentang alasan kebijakan pemberitahuan tidak valid. Kolom ini hanya disetel jika kebijakan pemberitahuan tidak valid. Kebijakan pemberitahuan yang tidak valid tidak akan menghasilkan insiden.
notificationChannels[]

string

Mengidentifikasi saluran notifikasi yang akan dikirimi notifikasi saat insiden dibuka atau ditutup atau saat terjadi pelanggaran baru pada insiden yang sudah dibuka. Setiap elemen array ini sesuai dengan kolom name di setiap objek NotificationChannel yang ditampilkan dari metode ListNotificationChannels. Format entri di kolom ini adalah:

projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
creationRecord

object (MutationRecord)

Catatan hanya baca tentang pembuatan kebijakan pemberitahuan. Jika diberikan dalam panggilan untuk membuat atau memperbarui, kolom ini akan diabaikan.
mutationRecord

object (MutationRecord)

Catatan hanya baca tentang perubahan terbaru pada kebijakan pemberitahuan. Jika diberikan dalam panggilan untuk membuat atau memperbarui, kolom ini akan diabaikan.
alertStrategy

object (AlertStrategy)

Kontrol atas cara saluran notifikasi kebijakan pemberitahuan ini diberi tahu.
severity

enum (Severity)

Opsional. Tingkat keparahan kebijakan pemberitahuan menunjukkan seberapa penting insiden yang dihasilkan oleh kebijakan tersebut. Tingkat keparahan akan ditampilkan di halaman detail Insiden dan dalam notifikasi.

Dokumentasi

Representasi JSON 
{
  "content": string,
  "mimeType": string,
  "subject": string,
  "links": [
    {
      object (Link)
    }
  ]
}
Kolom
content

string

Isi dokumentasi, ditafsirkan sesuai dengan mime_type. Konten tidak boleh melebihi 8.192 karakter Unicode dan tidak boleh melebihi 10.240 byte saat dienkode dalam format UTF-8, mana saja yang lebih kecil. Teks ini dapat dibuat template menggunakan variabel.
mimeType

string

Format kolom content. Saat ini, hanya nilai "text/markdown" yang didukung. Lihat Markdown untuk mengetahui informasi selengkapnya.
subject

string

Opsional. Baris subjek notifikasi. Baris subjek tidak boleh melebihi 10.240 byte. Dalam notifikasi yang dibuat oleh kebijakan ini, konten baris subjek setelah perluasan variabel akan dipangkas hingga 255 byte atau lebih pendek pada batas karakter UTF-8 terbaru. Batas 255 byte direkomendasikan oleh rangkaian pesan ini. Batas ini diberlakukan oleh beberapa produk tiket pihak ketiga dan umumnya kolom tekstual dalam database ditentukan sebagai VARCHAR(255).

Isi baris subjek dapat dibuat menggunakan template dengan variabel. Jika kolom ini tidak ada atau kosong, baris subjek default akan dibuat.
links[]

object (Link)

Opsional. Link ke konten seperti playbook, repositori, dan resource lainnya. Kolom ini dapat berisi hingga 3 entri.
Representasi JSON 
{
  "displayName": string,
  "url": string
}
Kolom
displayName

string

Nama tampilan singkat untuk link. Nama tampilan tidak boleh kosong atau melebihi 63 karakter. Contoh: "playbook".
url

string

URL halaman web. URL dapat dibuat menjadi template dengan menggunakan variabel di jalur atau parameter kueri. Panjang total URL tidak boleh melebihi 2083 karakter sebelum dan setelah perluasan variabel. Contoh: "https://my_domain.com/playbook?name=${resource.name}"

UserLabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

Kondisi

Representasi JSON 
{
  "name": string,
  "displayName": string,

  // Union field condition can be only one of the following:
  "conditionThreshold": {
    object (MetricThreshold)
  },
  "conditionAbsent": {
    object (MetricAbsence)
  },
  "conditionMatchedLog": {
    object (LogMatch)
  },
  "conditionMonitoringQueryLanguage": {
    object (MonitoringQueryLanguageCondition)
  },
  "conditionPrometheusQueryLanguage": {
    object (PrometheusQueryLanguageCondition)
  },
  "conditionSql": {
    object (SqlCondition)
  }
  // End of list of possible types for union field condition.
}
Kolom
name

string

Wajib jika kondisi ada. Nama resource unik untuk kondisi ini. Formatnya adalah:

projects/[PROJECT_ID_OR_NUMBER]/alertPolicies/[POLICY_ID]/conditions/[CONDITION_ID]

[CONDITION_ID] ditetapkan oleh Cloud Monitoring saat kondisi dibuat sebagai bagian dari kebijakan pemberitahuan baru atau yang diperbarui.

Saat memanggil metode alertPolicies.create, jangan sertakan kolom name dalam kondisi kebijakan pemberitahuan yang diminta. Cloud Monitoring membuat ID kondisi dan menyertakannya dalam kebijakan baru.

Saat memanggil metode alertPolicies.update untuk memperbarui kebijakan, termasuk kondisi name akan menyebabkan kondisi yang ada diperbarui. Kondisi tanpa nama ditambahkan ke kebijakan yang diperbarui. Kondisi yang ada akan dihapus jika tidak diperbarui.

Praktik terbaiknya adalah mempertahankan [CONDITION_ID] jika Anda hanya melakukan perubahan kecil, seperti pada nilai minimum kondisi, durasi, atau nilai pemicu. Jika tidak, perlakukan perubahan sebagai kondisi baru dan biarkan kondisi yang ada dihapus.
displayName

string

Nama atau frasa singkat yang digunakan untuk mengidentifikasi kondisi dalam dasbor, notifikasi, dan insiden. Untuk menghindari kebingungan, jangan gunakan nama tampilan yang sama untuk beberapa kondisi dalam kebijakan yang sama.
Kolom union condition. Hanya satu jenis kondisi berikut yang akan ditentukan. condition hanya ada berupa salah satu diantara berikut:
conditionThreshold

object (MetricThreshold)

Kondisi yang membandingkan deret waktu dengan nilai minimum.
conditionAbsent

object (MetricAbsence)

Kondisi yang memeriksa apakah deret waktu terus menerima titik data baru.
conditionMatchedLog

object (LogMatch)

Kondisi yang memeriksa pesan log yang cocok dengan batasan tertentu. Jika disetel, tidak ada kondisi lain yang dapat muncul.
conditionMonitoringQueryLanguage

object (MonitoringQueryLanguageCondition)

Kondisi yang menggunakan Monitoring Query Language untuk menentukan pemberitahuan.
conditionPrometheusQueryLanguage

object (PrometheusQueryLanguageCondition)

Kondisi yang menggunakan bahasa kueri Prometheus untuk menentukan pemberitahuan.
conditionSql

object (SqlCondition)

Kondisi yang secara berkala mengevaluasi hasil kueri SQL.

MetricThreshold

Representasi JSON 
{
  "filter": string,
  "aggregations": [
    {
      object (Aggregation)
    }
  ],
  "denominatorFilter": string,
  "denominatorAggregations": [
    {
      object (Aggregation)
    }
  ],
  "forecastOptions": {
    object (ForecastOptions)
  },
  "comparison": enum (ComparisonType),
  "thresholdValue": number,
  "duration": string,
  "trigger": {
    object (Trigger)
  },
  "evaluationMissingData": enum (EvaluationMissingData)
}
Kolom
filter

string

Wajib. Filter yang mengidentifikasi deret waktu mana yang harus dibandingkan dengan nilai minimum.

Filter ini mirip dengan filter yang ditentukan dalam permintaan ListTimeSeries (panggilan ini berguna untuk memverifikasi deret waktu yang akan diambil / diproses). Filter harus menentukan jenis metrik dan jenis resource. Secara opsional, dapat menentukan label resource dan label metrik. Kolom ini tidak boleh melebihi 2.048 karakter Unicode.
aggregations[]

object (Aggregation)

Menentukan perataan titik data dalam deret waktu individual serta cara menggabungkan deret waktu yang diambil (seperti saat menggabungkan beberapa aliran pada setiap resource menjadi satu aliran untuk setiap resource atau saat menggabungkan aliran di semua anggota grup resource). Beberapa agregasi diterapkan sesuai urutan yang ditentukan.

Kolom ini mirip dengan kolom dalam permintaan ListTimeSeries. Sebaiknya gunakan metode ListTimeSeries saat men-debug kolom ini.
denominatorFilter

string

Filter yang mengidentifikasi deret waktu yang harus digunakan sebagai penyebut rasio yang akan dibandingkan dengan nilai minimum. Jika denominator_filter ditentukan, deret waktu yang ditentukan oleh kolom filter akan digunakan sebagai pembilang.

Filter harus menentukan jenis metrik dan secara opsional dapat berisi batasan pada jenis resource, label resource, dan label metrik. Kolom ini tidak boleh melebihi 2.048 karakter Unicode.
denominatorAggregations[]

object (Aggregation)

Menentukan perataan titik data dalam deret waktu individual yang dipilih oleh denominatorFilter serta cara menggabungkan deret waktu yang diambil (seperti saat menggabungkan beberapa aliran di setiap resource menjadi satu aliran untuk setiap resource atau saat menggabungkan aliran di semua anggota grup resource).

Saat menghitung rasio, kolom aggregations dan denominator_aggregations harus menggunakan periode perataan yang sama dan menghasilkan deret waktu yang memiliki periodisitas dan label yang sama.
forecastOptions

object (ForecastOptions)

Jika kolom ini ada, kondisi MetricThreshold memperkirakan apakah deret waktu diprediksi akan melanggar nilai minimum dalam forecast_horizon. Jika kolom ini tidak ditetapkan, MetricThreshold akan menguji nilai deret waktu saat ini terhadap nilai minimum.
comparison

enum (ComparisonType)

Perbandingan yang akan diterapkan antara deret waktu (ditunjukkan oleh filter dan aggregation) dan nilai minimum (ditunjukkan oleh threshold_value). Perbandingan diterapkan pada setiap deret waktu, dengan deret waktu di sisi kiri dan nilai minimum di sisi kanan.

Saat ini, hanya COMPARISON_LT dan COMPARISON_GT yang didukung.
thresholdValue

number

Nilai yang akan dibandingkan dengan deret waktu.
duration

string (Duration format)

Wajib. Durasi waktu deret waktu harus melanggar nilai minimum agar dianggap gagal. Saat ini, hanya nilai yang merupakan kelipatan menit--misalnya, 0, 60, 120, atau 300 detik--yang didukung. Jika nilai yang tidak valid diberikan, error akan ditampilkan. Saat memilih durasi, sebaiknya perhatikan frekuensi data deret waktu pokok (yang juga dapat dipengaruhi oleh perataan yang ditentukan di kolom aggregations); durasi yang baik cukup panjang sehingga satu pencilan tidak menghasilkan notifikasi palsu, tetapi cukup singkat sehingga status tidak sehat dapat dideteksi dan diberi notifikasi dengan cepat.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
trigger

object (Trigger)

Jumlah/persen deret waktu yang perbandingannya harus berlaku agar kondisi dipicu. Jika tidak ditentukan, kondisi akan dipicu jika perbandingan benar untuk deret waktu yang telah diidentifikasi oleh filter dan aggregations, atau oleh rasio, jika denominator_filter dan denominator_aggregations ditentukan.
evaluationMissingData

enum (EvaluationMissingData)

Kontrol kondisi yang menentukan cara kondisi batas metrik dievaluasi saat data berhenti tiba. Untuk menggunakan kontrol ini, nilai kolom duration harus lebih besar dari atau sama dengan 60 detik.

Agregasi

Representasi JSON 
{
  "alignmentPeriod": string,
  "perSeriesAligner": enum (Aligner),
  "crossSeriesReducer": enum (Reducer),
  "groupByFields": [
    string
  ]
}
Kolom
alignmentPeriod

string (Duration format)

alignment_period menentukan interval waktu, dalam detik, yang digunakan untuk membagi data di semua time series menjadi blok waktu yang konsisten. Hal ini akan dilakukan sebelum perata per seri dapat diterapkan ke data.

Nilainya harus minimal 60 detik. Jika alat perata per seri selain ALIGN_NONE ditentukan, kolom ini wajib diisi atau error akan ditampilkan. Jika tidak ada penyelarasan per deret yang ditentukan, atau penyelarasan ALIGN_NONE ditentukan, kolom ini akan diabaikan.

Nilai maksimum alignment_period adalah 104 minggu (2 tahun) untuk diagram, dan 90.000 detik (25 jam) untuk kebijakan pemberitahuan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
perSeriesAligner

enum (Aligner)

Aligner menjelaskan cara menyelaraskan titik data dalam satu deret waktu secara temporal. Kecuali ALIGN_NONE, semua penyelarasan menyebabkan semua titik data dalam alignment_period dikelompokkan secara matematis, sehingga menghasilkan satu titik data untuk setiap alignment_period dengan stempel waktu akhir di akhir periode.

Tidak semua operasi penyelarasan dapat diterapkan ke semua deret waktu. Pilihan yang valid bergantung pada metric_kind dan value_type deret waktu asli. Penyelarasan dapat mengubah metric_kind atau value_type deret waktu.

Data deret waktu harus disejajarkan untuk melakukan pengurangan deret waktu lintas. Jika cross_series_reducer ditentukan, maka per_series_aligner harus ditentukan dan tidak sama dengan ALIGN_NONE dan alignment_period harus ditentukan; jika tidak, error akan ditampilkan.
crossSeriesReducer

enum (Reducer)

Operasi pengurangan yang akan digunakan untuk menggabungkan deret waktu menjadi satu deret waktu, dengan nilai setiap titik data dalam deret yang dihasilkan adalah fungsi dari semua nilai yang sudah diselaraskan dalam deret waktu input.

Tidak semua operasi peredam dapat diterapkan ke semua deret waktu. Pilihan yang valid bergantung pada metric_kind dan value_type deret waktu asli. Pengurangan dapat menghasilkan deret waktu dengan metric_kind atau value_type yang berbeda dari deret waktu input.

Data deret waktu harus diselaraskan terlebih dahulu (lihat per_series_aligner) untuk melakukan pengurangan deret waktu lintas. Jika cross_series_reducer ditentukan, maka per_series_aligner harus ditentukan, dan tidak boleh ALIGN_NONE. alignment_period juga harus ditentukan; jika tidak, error akan ditampilkan.
groupByFields[]

string

Kumpulan kolom yang akan dipertahankan saat cross_series_reducer ditentukan. group_by_fields menentukan cara deret waktu dipartisi ke dalam subset sebelum menerapkan operasi agregasi. Setiap subkumpulan berisi deret waktu yang memiliki nilai yang sama untuk setiap kolom pengelompokan. Setiap deret waktu individu adalah anggota dari tepat satu subset. cross_series_reducer diterapkan ke setiap subset deret waktu. Pengurangan tidak dapat dilakukan di berbagai jenis resource, sehingga kolom ini secara implisit berisi resource.type. Kolom yang tidak ditentukan dalam group_by_fields akan diagregasi. Jika group_by_fields tidak ditentukan dan semua deret waktu memiliki jenis resource yang sama, deret waktu akan digabungkan menjadi satu deret waktu output. Jika cross_series_reducer tidak ditentukan, kolom ini akan diabaikan.

Durasi

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Detik bertanda dari rentang waktu. Harus dari -315.576.000.000 hingga +315.576.000.000 inklusif. Catatan: batas ini dihitung dari: 60 dtk/mnt * 60 mnt/jam * 24 jam/hari * 365,25 hari/tahun * 10.000 tahun
nanos

integer

Pecahan detik bertanda pada resolusi nanodetik rentang waktu. Durasi kurang dari satu detik ditampilkan dengan kolom seconds 0 dan kolom nanos positif atau negatif. Untuk durasi satu detik atau lebih, nilai non-nol untuk kolom nanos harus memiliki tanda yang sama dengan kolom seconds. Harus dari -999.999.999 hingga +999.999.999 inklusif.

ForecastOptions

Representasi JSON 
{
  "forecastHorizon": string
}
Kolom
forecastHorizon

string (Duration format)

Wajib. Durasi waktu ke masa depan untuk memperkirakan apakah deret waktu akan melanggar nilai minimum. Jika nilai yang diprediksi terbukti melanggar nilai minimum, dan pelanggaran tersebut diamati di semua perkiraan yang dibuat untuk duration yang dikonfigurasi, maka deret waktu dianggap gagal. Horizon perkiraan dapat berkisar dari 1 jam hingga 60 jam.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

Pemicu

Representasi JSON 
{

  // Union field type can be only one of the following:
  "count": integer,
  "percent": number
  // End of list of possible types for union field type.
}
Kolom
Kolom union type. Jenis pemicu. type hanya ada berupa salah satu diantara berikut:
count

integer

Jumlah absolut deret waktu yang harus gagal dalam predikat agar kondisi dipicu.
percent

number

Persentase deret waktu yang harus gagal dalam predikat agar kondisi dipicu.

MetricAbsence

Representasi JSON 
{
  "filter": string,
  "aggregations": [
    {
      object (Aggregation)
    }
  ],
  "duration": string,
  "trigger": {
    object (Trigger)
  }
}
Kolom
filter

string

Wajib. Filter yang mengidentifikasi deret waktu mana yang harus dibandingkan dengan nilai minimum.

Filter ini mirip dengan filter yang ditentukan dalam permintaan ListTimeSeries (panggilan ini berguna untuk memverifikasi deret waktu yang akan diambil / diproses). Filter harus menentukan jenis metrik dan jenis resource. Secara opsional, dapat menentukan label resource dan label metrik. Kolom ini tidak boleh melebihi 2.048 karakter Unicode.
aggregations[]

object (Aggregation)

Menentukan perataan titik data dalam deret waktu individual serta cara menggabungkan deret waktu yang diambil (seperti saat menggabungkan beberapa aliran pada setiap resource menjadi satu aliran untuk setiap resource atau saat menggabungkan aliran di semua anggota grup resource). Beberapa agregasi diterapkan sesuai urutan yang ditentukan.

Kolom ini mirip dengan kolom dalam permintaan ListTimeSeries. Sebaiknya gunakan metode ListTimeSeries saat men-debug kolom ini.
duration

string (Duration format)

Wajib. Jumlah waktu yang diperlukan agar deret waktu dianggap gagal melaporkan data baru. Nilai minimum kolom ini adalah 120 detik. Nilai yang lebih besar yang merupakan kelipatan satu menit, misalnya, 240 atau 300 detik, didukung. Jika nilai yang tidak valid diberikan, error akan ditampilkan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
trigger

object (Trigger)

Jumlah/persen deret waktu yang perbandingannya harus berlaku agar kondisi dipicu. Jika tidak ditentukan, kondisi akan dipicu jika perbandingan benar untuk deret waktu yang telah diidentifikasi oleh filter dan aggregations.

LogMatch

Representasi JSON 
{
  "filter": string,
  "labelExtractors": {
    string: string,
    ...
  }
}
Kolom
filter

string

Wajib. Filter berbasis log. Lihat Kueri Log Lanjutan untuk mengetahui cara membuat filter ini.
labelExtractors

map (key: string, value: string)

Opsional. Pemetaan dari kunci label ke ekspresi ekstraktor, yang digunakan untuk mengekstrak nilai untuk kunci label ini. Setiap entri dalam peta ini adalah spesifikasi tentang cara data harus diekstrak dari entri log yang cocok dengan filter. Setiap kombinasi nilai yang diekstrak diperlakukan sebagai aturan terpisah untuk tujuan memicu notifikasi. Kunci label dan nilai yang sesuai dapat digunakan dalam notifikasi yang dihasilkan oleh kondisi ini.

Lihat dokumentasi tentang metrik berbasis log valueExtractors untuk mengetahui sintaksis dan contohnya.

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

LabelExtractorsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

MonitoringQueryLanguageCondition

Representasi JSON 
{
  "query": string,
  "duration": string,
  "trigger": {
    object (Trigger)
  },
  "evaluationMissingData": enum (EvaluationMissingData)
}
Kolom
query

string

Kueri Monitoring Query Language yang menghasilkan aliran boolean.
duration

string (Duration format)

Opsional. Durasi waktu deret waktu harus melanggar nilai minimum agar dianggap gagal. Saat ini, hanya nilai yang merupakan kelipatan menit--misalnya, 0, 60, 120, atau 300 detik--yang didukung. Jika nilai yang tidak valid diberikan, error akan ditampilkan. Saat memilih durasi, sebaiknya perhatikan frekuensi data deret waktu pokok (yang juga dapat dipengaruhi oleh perataan yang ditentukan di kolom aggregations); durasi yang baik cukup panjang sehingga satu pencilan tidak menghasilkan notifikasi palsu, tetapi cukup singkat sehingga status tidak sehat dapat dideteksi dan diberi notifikasi dengan cepat. Nilai defaultnya adalah nol.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
trigger

object (Trigger)

Jumlah/persen deret waktu yang perbandingannya harus berlaku agar kondisi dipicu. Jika tidak ditentukan, kondisi akan dipicu jika perbandingan benar untuk deret waktu yang telah diidentifikasi oleh filter dan aggregations, atau oleh rasio, jika denominator_filter dan denominator_aggregations ditentukan.
evaluationMissingData

enum (EvaluationMissingData)

Kontrol kondisi yang menentukan cara kondisi batas metrik dievaluasi saat data berhenti tiba.

PrometheusQueryLanguageCondition

Representasi JSON 
{
  "query": string,
  "duration": string,
  "evaluationInterval": string,
  "labels": {
    string: string,
    ...
  },
  "ruleGroup": string,
  "alertRule": string,
  "disableMetricValidation": boolean
}
Kolom
query

string

Wajib. Ekspresi PromQL yang akan dievaluasi. Setiap siklus evaluasi, ekspresi ini dievaluasi pada waktu saat ini, dan semua deret waktu yang dihasilkan akan menjadi pemberitahuan tertunda/aktif. Kolom ini tidak boleh kosong.
duration

string (Duration format)

Opsional. Pemberitahuan dianggap diaktifkan setelah ekspresi PromQL-nya dievaluasi sebagai "benar" selama ini. Pemberitahuan yang ekspresi PromQL-nya tidak dievaluasi sebagai "true" dalam waktu yang cukup lama dianggap tertunda. Harus berupa durasi non-negatif atau tidak ada. Kolom ini bersifat opsional. Nilai defaultnya adalah nol.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
evaluationInterval

string (Duration format)

Opsional. Seberapa sering aturan ini harus dievaluasi. Harus berupa kelipatan 30 detik yang positif atau tidak ada. Kolom ini bersifat opsional. Nilai defaultnya adalah 30 detik. Jika PrometheusQueryLanguageCondition ini dibuat dari aturan pemberitahuan Prometheus, nilai ini harus diambil dari grup aturan yang melampirkan.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
labels

map (key: string, value: string)

Opsional. Label yang akan ditambahkan atau diganti dalam hasil kueri PromQL. Nama label harus valid. Nilai label dapat dibuat menggunakan template dengan variabel. Satu-satunya nama variabel yang tersedia adalah nama label dalam hasil PromQL, termasuk "__name__" dan "value". "labels" mungkin kosong.

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

string

Opsional. Nama grup aturan pemberitahuan ini dalam file konfigurasi Prometheus yang sesuai.

Beberapa alat eksternal mungkin memerlukan pengisian kolom ini dengan benar untuk merujuk ke file konfigurasi Prometheus asli. Nama grup aturan dan nama pemberitahuan diperlukan untuk memperbarui AlertPolicies yang relevan jika definisi grup aturan berubah di masa mendatang.

Kolom ini bersifat opsional. Jika kolom ini tidak kosong, maka harus berisi string UTF-8 yang valid. Kolom ini tidak boleh melebihi 2.048 karakter Unicode.
alertRule

string

Opsional. Nama aturan pemberitahuan untuk pemberitahuan ini dalam file konfigurasi Prometheus yang sesuai.

Beberapa alat eksternal mungkin memerlukan pengisian kolom ini dengan benar untuk merujuk ke file konfigurasi Prometheus asli. Nama grup aturan dan nama pemberitahuan diperlukan untuk memperbarui AlertPolicies yang relevan jika definisi grup aturan berubah di masa mendatang.

Kolom ini bersifat opsional. Jika kolom ini tidak kosong, maka harus berupa nama label Prometheus yang valid. Kolom ini tidak boleh melebihi 2.048 karakter Unicode.
disableMetricValidation

boolean

Opsional. Apakah akan menonaktifkan validasi keberadaan metrik untuk kondisi ini.

Hal ini memungkinkan kebijakan pemberitahuan ditentukan pada metrik yang belum ada, sehingga meningkatkan alur kerja pelanggan tingkat lanjut seperti mengonfigurasi kebijakan pemberitahuan menggunakan Terraform.

Pengguna dengan peran monitoring.alertPolicyViewer dapat melihat nama metrik yang tidak ada dalam kondisi kebijakan pemberitahuan.

LabelsEntry

Representasi JSON 
{
  "key": string,
  "value": string
}
Kolom
key

string
value

string

SqlCondition

Representasi JSON 
{
  "query": string,

  // Union field schedule can be only one of the following:
  "minutes": {
    object (Minutes)
  },
  "hourly": {
    object (Hourly)
  },
  "daily": {
    object (Daily)
  }
  // End of list of possible types for union field schedule.

  // Union field evaluate can be only one of the following:
  "rowCountTest": {
    object (RowCountTest)
  },
  "booleanTest": {
    object (BooleanTest)
  }
  // End of list of possible types for union field evaluate.
}
Kolom
query

string

Wajib. Kueri SQL Log Analytics yang akan dijalankan, sebagai string. Kueri harus sesuai dengan bentuk yang diperlukan. Secara khusus, kueri tidak boleh mencoba memfilter input menurut waktu. Filter akan otomatis diterapkan untuk memfilter input sehingga kueri menerima semua baris yang diterima sejak terakhir kali kueri dijalankan.

Misalnya, kueri berikut mengekstrak semua entri log yang berisi permintaan HTTP:

SELECT
  timestamp, log_name, severity, http_request, resource, labels
FROM
  my-project.global._Default._AllLogs
WHERE
  http_request IS NOT NULL
Kolom union schedule. Jadwal menunjukkan seberapa sering kueri harus dijalankan. schedule hanya ada berupa salah satu diantara berikut:
minutes

object (Minutes)

Jadwalkan kueri untuk dijalankan setiap beberapa menit.
hourly

object (Hourly)

Jadwalkan kueri untuk dieksekusi setiap beberapa jam.
daily

object (Daily)

Jadwalkan kueri untuk dijalankan setiap beberapa hari.
Kolom union evaluate. Pengujian yang akan dijalankan terhadap kumpulan hasil SQL. evaluate hanya ada berupa salah satu diantara berikut:
rowCountTest

object (RowCountTest)

Uji jumlah baris terhadap nilai minimum.
booleanTest

object (BooleanTest)

Uji nilai boolean di kolom yang ditunjukkan.

Menit

Representasi JSON 
{
  "periodicity": integer
}
Kolom
periodicity

integer

Wajib. Jumlah menit antar-proses. Interval harus lebih besar dari atau sama dengan 5 menit dan kurang dari atau sama dengan 1.440 menit.

Per jam

Representasi JSON 
{
  "periodicity": integer,

  // Union field _minute_offset can be only one of the following:
  "minuteOffset": integer
  // End of list of possible types for union field _minute_offset.
}
Kolom
periodicity

integer

Wajib. Jumlah jam di antara proses. Harus lebih besar dari atau sama dengan 1 jam dan kurang dari atau sama dengan 48 jam.

Kolom union _minute_offset.

_minute_offset hanya dapat berupa salah satu dari hal berikut:
minuteOffset

integer

Opsional. Jumlah menit setelah satu jam (dalam UTC) untuk menjalankan kueri. Harus lebih besar dari atau sama dengan 0 menit dan kurang dari atau sama dengan 59 menit. Jika tidak ditentukan, offset arbitrer akan digunakan.

Harian

Representasi JSON 
{
  "periodicity": integer,
  "executionTime": {
    object (TimeOfDay)
  }
}
Kolom
periodicity

integer

Wajib. Jumlah hari antara proses. Harus lebih besar dari atau sama dengan 1 hari dan kurang dari atau sama dengan 31 hari.
executionTime

object (TimeOfDay)

Opsional. Waktu dalam sehari (dalam UTC) saat kueri harus dijalankan. Jika tidak ditentukan, server akan memilih waktu yang acak dalam sehari dan menjalankan kueri pada waktu yang sama setiap hari.

TimeOfDay

Representasi JSON 
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Kolom
hours

integer

Jam dalam format 24 jam. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 23. API dapat memilih untuk mengizinkan nilai "24:00:00" untuk skenario seperti waktu tutup bisnis.
minutes

integer

Menit dalam satu jam. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 59.
seconds

integer

Detik dalam satu menit. Harus lebih besar dari atau sama dengan 0 dan biasanya harus kurang dari atau sama dengan 59. API dapat mengizinkan nilai 60 jika memungkinkan lompatan-detik.
nanos

integer

Pecahan detik, dalam nanodetik. Harus lebih besar dari atau sama dengan 0 dan kurang dari atau sama dengan 999.999.999.

RowCountTest

Representasi JSON 
{
  "comparison": enum (ComparisonType),
  "threshold": string
}
Kolom
comparison

enum (ComparisonType)

Wajib. Perbandingan yang akan diterapkan antara jumlah baris yang ditampilkan oleh kueri dan nilai minimum.
threshold

string (int64 format)

Wajib. Nilai yang akan dibandingkan dengan jumlah baris.

BooleanTest

Representasi JSON 
{
  "column": string
}
Kolom
column

string

Wajib. Nama kolom yang berisi nilai boolean. Jika nilai dalam baris adalah NULL, baris tersebut akan diabaikan.

BoolValue

Representasi JSON 
{
  "value": boolean
}
Kolom
value

boolean

Nilai bool.

Status

Representasi JSON 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Kolom
code

integer

Kode status, harus berupa nilai enum dari google.rpc.Code.
message

string

Pesan error yang ditampilkan ke developer dan seharusnya dalam bahasa Inggris. Setiap pesan error yang ditampilkan kepada pengguna harus dilokalkan dan dikirim di kolom google.rpc.Status.details, atau dilokalkan oleh klien.
details[]

object

Daftar pesan yang membawa detail error. Ada seperangkat jenis pesan umum untuk digunakan API.

Objek yang berisi kolom tipe arbitrer. Kolom tambahan "@type" berisi URI yang mengidentifikasi jenis. Contoh: { "id": 1234, "@type": "types.example.com/standard/id" }.

Semua

Representasi JSON 
{
  "typeUrl": string,
  "value": string
}
Kolom
typeUrl

string

Mengidentifikasi jenis pesan Protobuf berserial dengan referensi URI yang terdiri dari awalan yang diakhiri dengan garis miring dan nama jenis yang sepenuhnya memenuhi syarat.

Contoh: type.googleapis.com/google.protobuf.StringValue

String ini harus berisi setidaknya satu karakter /, dan konten setelah / terakhir harus berupa nama yang sepenuhnya memenuhi syarat dari jenis dalam bentuk kanonis, tanpa titik di depannya. Jangan tulis skema pada referensi URI ini agar klien tidak mencoba menghubungi mereka.

Awalan bersifat arbitrer dan implementasi Protobuf diharapkan cukup menghapus semua yang ada hingga dan termasuk / terakhir untuk mengidentifikasi jenisnya. type.googleapis.com/ adalah awalan default umum yang diperlukan oleh beberapa penerapan lama. Awalan ini tidak menunjukkan asal jenis, dan URI yang memuatnya tidak diharapkan merespons permintaan apa pun.

Semua string URL jenis harus berupa referensi URI yang valid dengan batasan tambahan (untuk format teks) bahwa konten referensi hanya boleh terdiri dari karakter alfanumerik, escape yang dienkode persen, dan karakter dalam set berikut (tidak termasuk tanda petik terbalik luar): /-.~_!$&()*+,;=. Meskipun kami mengizinkan encoding persen, implementasi tidak boleh meng-unescape-nya untuk mencegah kebingungan dengan parser yang ada. Misalnya, type.googleapis.com%2FFoo harus ditolak.

Dalam desain asli Any, kemungkinan meluncurkan layanan penyelesaian jenis di URL jenis ini dipertimbangkan, tetapi Protobuf tidak pernah mengimplementasikannya dan menganggap menghubungi URL ini bermasalah dan berpotensi menimbulkan masalah keamanan. Jangan mencoba menghubungi URL jenis kontak.
value

string (bytes format)

Berisi serialisasi Protobuf dari jenis yang dijelaskan oleh type_url.

String berenkode base64.

MutationRecord

Representasi JSON 
{
  "mutateTime": string,
  "mutatedBy": string
}
Kolom
mutateTime

string (Timestamp format)

Waktu saat perubahan terjadi.

Menggunakan RFC 3339 yang outputnya 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".
mutatedBy

string

Alamat email pengguna yang melakukan perubahan.

Stempel waktu

Representasi JSON 
{
  "seconds": string,
  "nanos": integer
}
Kolom
seconds

string (int64 format)

Mewakili detik waktu UTC sejak epoch Unix 1970-01-01T00:00:00Z. Harus antara -62135596800 dan 253402300799 inklusif (yang sesuai dengan 0001-01-01T00:00:00Z hingga 9999-12-31T23:59:59Z).
nanos

integer

Pecahan detik non-negatif pada resolusi nanodetik. Kolom ini adalah bagian nanodetik dari durasi, bukan alternatif untuk detik. Nilai detik negatif dengan pecahan harus tetap memiliki nilai nanos non-negatif yang dihitung maju dalam waktu. Harus antara 0 dan 999.999.999 inklusif.

AlertStrategy

Representasi JSON 
{
  "notificationRateLimit": {
    object (NotificationRateLimit)
  },
  "notificationPrompts": [
    enum (NotificationPrompt)
  ],
  "autoClose": string,
  "notificationChannelStrategy": [
    {
      object (NotificationChannelStrategy)
    }
  ]
}
Kolom
notificationRateLimit

object (NotificationRateLimit)

Diperlukan untuk kebijakan pemberitahuan berbasis log, yaitu kebijakan dengan kondisi LogMatch.

Batas ini tidak diterapkan untuk kebijakan pemberitahuan yang tidak memiliki kondisi LogMatch.
notificationPrompts[]

enum (NotificationPrompt)

Untuk kebijakan pemberitahuan berbasis log, perintah notifikasi selalu [DIBUKA]. Untuk kebijakan pemberitahuan non-berbasis log, perintah notifikasi dapat berupa [DIBUKA] atau [DIBUKA, DITUTUP].
autoClose

string (Duration format)

Jika kebijakan pemberitahuan yang aktif tidak memiliki data selama ini, semua insiden yang terbuka akan ditutup

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".
notificationChannelStrategy[]

object (NotificationChannelStrategy)

Mengontrol cara notifikasi akan dikirim, berdasarkan per channel.

NotificationRateLimit

Representasi JSON 
{
  "period": string
}
Kolom
period

string (Duration format)

Tidak lebih dari satu notifikasi per period.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

NotificationChannelStrategy

Representasi JSON 
{
  "notificationChannelNames": [
    string
  ],
  "renotifyInterval": string
}
Kolom
notificationChannelNames[]

string

Nama resource REST lengkap untuk saluran notifikasi yang menerapkan setelan ini. Setiap nilai ini sesuai dengan kolom nama di salah satu objek NotificationChannel yang dirujuk di kolom notification_channels dari AlertPolicy ini. Formatnya adalah:

projects/[PROJECT_ID_OR_NUMBER]/notificationChannels/[CHANNEL_ID]
renotifyInterval

string (Duration format)

Frekuensi pengiriman notifikasi pengingat untuk insiden yang belum diselesaikan. Nilainya harus antara 30 menit dan 24 jam.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

Perata

Aligner menentukan operasi yang akan diterapkan ke titik data dalam setiap periode perataan dalam deret waktu. Kecuali ALIGN_NONE, yang menentukan bahwa tidak ada operasi yang diterapkan, setiap operasi penyelarasan menggantikan kumpulan nilai data di setiap periode penyelarasan dengan satu nilai: hasil penerapan operasi ke nilai data. Deret waktu yang diselaraskan memiliki satu nilai data di akhir setiap alignment_period.

Operasi penyelarasan juga dapat mengubah jenis data nilai. Misalnya, jika Anda menerapkan operasi penghitungan ke nilai boolean, data value_type dalam deret waktu asli adalah BOOLEAN, tetapi value_type dalam hasil yang diselaraskan adalah INT64.

Enum
ALIGN_NONE Tidak ada keselarasan. Data mentah ditampilkan. Tidak valid jika pengurangan lintas seri diminta. value_type hasil sama dengan value_type input.
ALIGN_DELTA

Sejajarkan dan konversikan ke DELTA. Outputnya adalah delta = y1 - y0.

Penyejajaran ini valid untuk metrik CUMULATIVE dan DELTA. Jika periode perataan yang dipilih menghasilkan periode tanpa data, nilai yang diratakan untuk periode tersebut dibuat dengan interpolasi. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_RATE

Sejajarkan dan konversi ke nilai. Hasilnya dihitung sebagai rate = (y1 - y0)/(t1 - t0), atau "perubahan dari waktu ke waktu". Anggaplah penyejajaran ini memberikan kemiringan garis yang melewati nilai di awal dan di akhir alignment_period.

Penyelarasan ini berlaku untuk metrik CUMULATIVE dan DELTA dengan nilai numerik. Jika periode perataan yang dipilih menghasilkan periode tanpa data, nilai yang diratakan untuk periode tersebut dibuat dengan interpolasi. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.

Jika yang Anda maksud dengan "rasio" adalah "perubahan persentase", lihat penyelarasan ALIGN_PERCENT_CHANGE.
ALIGN_INTERPOLATE Menyelaraskan dengan melakukan interpolasi antara titik-titik yang berdekatan di sekitar batas periode penyelarasan. Penyelarasan ini valid untuk GAUGE metrik dengan nilai numerik. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_NEXT_OLDER Selaraskan dengan memindahkan titik data terbaru sebelum akhir periode penyelarasan ke batas di akhir periode penyelarasan. Penyelarasan ini valid untuk GAUGE metrik. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_MIN Menyelaraskan deret waktu dengan menampilkan nilai minimum di setiap periode penyelarasan. Penyelarasan ini berlaku untuk metrik GAUGE dan DELTA dengan nilai numerik. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_MAX Menyelaraskan deret waktu dengan menampilkan nilai maksimum di setiap periode penyelarasan. Penyelarasan ini berlaku untuk metrik GAUGE dan DELTA dengan nilai numerik. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_MEAN Selaraskan deret waktu dengan menampilkan nilai rata-rata di setiap periode penyelarasan. Penyelarasan ini berlaku untuk metrik GAUGE dan DELTA dengan nilai numerik. value_type dari hasil yang diselaraskan adalah DOUBLE.
ALIGN_COUNT Selaraskan deret waktu dengan menampilkan jumlah nilai di setiap periode penyelarasan. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai numerik atau Boolean. value_type dari hasil yang diselaraskan adalah INT64.
ALIGN_SUM Selaraskan deret waktu dengan menampilkan jumlah nilai di setiap periode penyelarasan. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai numerik dan distribusi. value_type hasil yang diselaraskan sama dengan value_type input.
ALIGN_STDDEV Selaraskan deret waktu dengan menampilkan simpangan baku nilai di setiap periode penyelarasan. Penyelarasan ini berlaku untuk metrik GAUGE dan DELTA dengan nilai numerik. value_type outputnya adalah DOUBLE.
ALIGN_COUNT_TRUE Selaraskan deret waktu dengan menampilkan jumlah nilai True di setiap periode penyelarasan. Penyelarasan ini valid untuk GAUGE metrik dengan nilai Boolean. value_type outputnya adalah INT64.
ALIGN_COUNT_FALSE Selaraskan deret waktu dengan menampilkan jumlah nilai False di setiap periode penyelarasan. Penyelarasan ini valid untuk GAUGE metrik dengan nilai Boolean. value_type outputnya adalah INT64.
ALIGN_FRACTION_TRUE Selaraskan deret waktu dengan menampilkan rasio jumlah nilai True terhadap jumlah total nilai di setiap periode penyelarasan. Penyelarasan ini valid untuk GAUGE metrik dengan nilai Boolean. Nilai output berada dalam rentang [0,0, 1,0] dan memiliki value_type DOUBLE.
ALIGN_PERCENTILE_99 Sejajarkan deret waktu menggunakan agregasi persentil. Titik data yang dihasilkan dalam setiap periode perataan adalah persentil ke-99 dari semua titik data dalam periode tersebut. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai distribusi. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.
ALIGN_PERCENTILE_95 Sejajarkan deret waktu menggunakan agregasi persentil. Titik data yang dihasilkan dalam setiap periode perataan adalah persentil ke-95 dari semua titik data dalam periode tersebut. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai distribusi. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.
ALIGN_PERCENTILE_50 Sejajarkan deret waktu menggunakan agregasi persentil. Titik data yang dihasilkan dalam setiap periode perataan adalah persentil ke-50 dari semua titik data dalam periode tersebut. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai distribusi. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.
ALIGN_PERCENTILE_05 Sejajarkan deret waktu menggunakan agregasi persentil. Titik data yang dihasilkan dalam setiap periode perataan adalah persentil ke-5 dari semua titik data dalam periode tersebut. Penyelarasan ini valid untuk metrik GAUGE dan DELTA dengan nilai distribusi. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.
ALIGN_PERCENT_CHANGE

Sejajarkan dan konversikan ke perubahan persentase. Penyelarasan ini berlaku untuk metrik GAUGE dan DELTA dengan nilai numerik. Penyejajaran ini menampilkan ((current - previous)/previous) * 100, dengan nilai previous ditentukan berdasarkan alignment_period.

Jika nilai current dan previous adalah 0, maka nilai yang ditampilkan adalah 0. Jika hanya previous yang 0, nilai yang ditampilkan adalah tak terhingga.

Rata-rata bergerak 10 menit dihitung pada setiap titik periode penyelarasan sebelum penghitungan di atas untuk memperlancar metrik dan mencegah positif palsu dari lonjakan yang sangat singkat. Rata-rata bergerak hanya berlaku untuk data yang nilainya >= 0. Nilai < 0 diperlakukan sebagai titik data yang hilang, dan diabaikan. Meskipun metrik DELTA diterima oleh perataan ini, Anda harus berhati-hati agar nilai metrik selalu positif. Outputnya adalah metrik GAUGE dengan value_type DOUBLE.

Pengurang

Operasi Reducer menjelaskan cara menggabungkan titik data dari beberapa deret waktu menjadi satu deret waktu, dengan nilai setiap titik data dalam deret yang dihasilkan adalah fungsi dari semua nilai yang sudah diselaraskan dalam deret waktu input.

Enum
REDUCE_NONE Tidak ada pengurangan deret waktu lintas. Output Aligner ditampilkan.
REDUCE_MEAN Mengurangi dengan menghitung nilai rata-rata di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dengan nilai numerik atau distribusi. value_type outputnya adalah DOUBLE.
REDUCE_MIN Mengurangi dengan menghitung nilai minimum di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini berlaku untuk metrik DELTA dan GAUGE dengan nilai numerik. value_type output sama dengan value_type input.
REDUCE_MAX Mengurangi dengan menghitung nilai maksimum di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini berlaku untuk metrik DELTA dan GAUGE dengan nilai numerik. value_type output sama dengan value_type input.
REDUCE_SUM Mengurangi dengan menghitung jumlah di seluruh deret waktu untuk setiap periode perataan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dengan nilai numerik dan distribusi. value_type output sama dengan value_type input.
REDUCE_STDDEV Mengurangi dengan menghitung simpangan baku di seluruh deret waktu untuk setiap periode perataan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dengan nilai numerik atau distribusi. value_type outputnya adalah DOUBLE.
REDUCE_COUNT Mengurangi dengan menghitung jumlah titik data di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dari value_type numerik, Boolean, distribusi, dan string. value_type outputnya adalah INT64.
REDUCE_COUNT_TRUE Mengurangi dengan menghitung jumlah titik data bernilai True di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dari Boolean value_type. value_type outputnya adalah INT64.
REDUCE_COUNT_FALSE Mengurangi dengan menghitung jumlah titik data bernilai False di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dari Boolean value_type. value_type outputnya adalah INT64.
REDUCE_FRACTION_TRUE Mengurangi dengan menghitung rasio jumlah titik data bernilai True terhadap jumlah total titik data untuk setiap periode penyelarasan. Pengurangan ini valid untuk metrik DELTA dan GAUGE dari Boolean value_type. Nilai output berada dalam rentang [0,0, 1,0] dan memiliki value_type DOUBLE.
REDUCE_PERCENTILE_99 Mengurangi dengan menghitung persentil ke-99 titik data di seluruh deret waktu untuk setiap periode perataan. Pengurangan ini berlaku untuk metrik GAUGE dan DELTA dari jenis numerik dan distribusi. Nilai outputnya adalah DOUBLE.
REDUCE_PERCENTILE_95 Mengurangi dengan menghitung persentil ke-95 titik data di seluruh deret waktu untuk setiap periode penyelarasan. Pengurangan ini berlaku untuk metrik GAUGE dan DELTA dari jenis numerik dan distribusi. Nilai outputnya adalah DOUBLE.
REDUCE_PERCENTILE_50 Mengurangi dengan menghitung persentil ke-50 titik data di seluruh deret waktu untuk setiap periode perataan. Pengurangan ini berlaku untuk metrik GAUGE dan DELTA dari jenis numerik dan distribusi. Nilai outputnya adalah DOUBLE.
REDUCE_PERCENTILE_05 Mengurangi dengan menghitung persentil ke-5 titik data di seluruh deret waktu untuk setiap periode perataan. Pengurangan ini berlaku untuk metrik GAUGE dan DELTA dari jenis numerik dan distribusi. Nilai outputnya adalah DOUBLE.

ComparisonType

Menentukan hubungan pengurutan pada dua argumen, yang disebut left dan right.

Enum
COMPARISON_UNSPECIFIED Tidak ada hubungan pengurutan yang ditentukan.
COMPARISON_GT Benar jika argumen kiri lebih besar daripada argumen kanan.
COMPARISON_GE Benar jika argumen kiri lebih besar dari atau sama dengan argumen kanan.
COMPARISON_LT Benar jika argumen kiri lebih kecil daripada argumen kanan.
COMPARISON_LE Benar jika argumen kiri kurang dari atau sama dengan argumen kanan.
COMPARISON_EQ Benar (True) jika argumen kiri sama dengan argumen kanan.
COMPARISON_NE Benar jika argumen kiri tidak sama dengan argumen kanan.

EvaluationMissingData

Kontrol kondisi yang menentukan cara kondisi batas metrik dievaluasi saat data berhenti tiba. Kontrol ini tidak memengaruhi kebijakan tidak adanya metrik.

Enum
EVALUATION_MISSING_DATA_UNSPECIFIED Opsi data yang tidak ada untuk evaluasi yang tidak ditentukan. Setara dengan EVALUATION_MISSING_DATA_NO_OP.
EVALUATION_MISSING_DATA_INACTIVE Jika tidak ada data untuk mengevaluasi kondisi, maka evaluasi kondisi sebagai salah (false).
EVALUATION_MISSING_DATA_ACTIVE Jika tidak ada data untuk mengevaluasi kondisi, evaluasi kondisi sebagai benar.
EVALUATION_MISSING_DATA_NO_OP Jangan mengevaluasi kondisi ke nilai apa pun jika tidak ada data.

ConditionCombinerType

Operator untuk menggabungkan kondisi.

Enum
COMBINE_UNSPECIFIED Penggabung yang tidak ditentukan.
AND Gabungkan kondisi menggunakan operator logis AND. Insiden dibuat hanya jika semua kondisi terpenuhi secara bersamaan. Penggabung ini terpenuhi jika semua kondisi terpenuhi, meskipun terpenuhi di resource yang sama sekali berbeda.
OR Gabungkan kondisi menggunakan operator logis OR. Insiden dibuat jika salah satu kondisi yang tercantum terpenuhi.
AND_WITH_MATCHING_RESOURCE Gabungkan kondisi menggunakan operator logis AND, tetapi tidak seperti opsi AND biasa, insiden hanya dibuat jika semua kondisi terpenuhi secara bersamaan di setidaknya satu resource.

NotificationPrompt

Kontrol kapan notifikasi akan dikirim.

Enum
NOTIFICATION_PROMPT_UNSPECIFIED Tidak ada strategi yang ditentukan. Diperlakukan sebagai error.
OPENED Memberi tahu saat insiden dibuka.
CLOSED Memberi tahu saat insiden ditutup.

Keparahan

Enumerasi kemungkinan tingkat keparahan untuk kebijakan pemberitahuan.

Enum
SEVERITY_UNSPECIFIED Tingkat keparahan tidak ditentukan. Ini adalah nilai defaultnya.
CRITICAL Ini adalah tingkat keparahan tertinggi. Gunakan opsi ini jika masalah dapat menyebabkan kerusakan atau gangguan yang signifikan.
ERROR Ini adalah tingkat keparahan sedang. Gunakan ini jika masalah dapat menyebabkan kerusakan ringan atau waktu istirahat.
WARNING Ini adalah tingkat keparahan terendah. Gunakan opsi ini jika masalah tidak menyebabkan kerusakan atau periode nonaktif, tetapi berpotensi menimbulkan masalah pada masa mendatang.

Anotasi Alat

Petunjuk Destruktif: ❌ | Petunjuk Idempoten: ✅ | Petunjuk Hanya Baca: ✅ | Petunjuk Dunia Terbuka: ❌