Referensi field SLO CRD - Alibaba Cloud Service Mesh - Alibaba Cloud Documentation Center

Service Mesh (ASM) memungkinkan Anda mendefinisikan Service Level Objectives (SLO) dan aturan peringatan secara deklaratif melalui Custom Resource Definition (CRD) ServiceLevelObjective.

Referensi field di bawah ini diorganisasikan berdasarkan hierarki: metadata > spec > slos[] > sli / alerting.

Contoh YAML

Manifes berikut mendefinisikan SLO ketersediaan untuk layanan httpbin di namespace default. Targetnya adalah 99,9% dan SLO berlaku selama periode 30 hari, dengan peringatan tingkat halaman (page alert) dan tingkat tiket (ticket alert).

Tabel berikut merangkum field-field utama. Untuk deskripsi lengkap semua field, lihat referensi field CRD.

Field	Deskripsi
`namespace`	Namespace dari sumber daya kustom. Harus sesuai dengan namespace layanan target.
`service`	Nama layanan target.
`period`	Periode waktu saat SLO berlaku. Nilai yang valid: `30d`, `28d`, `14d`, `7d`.
`objective`	Target persentase dalam bentuk string. Rentang nilai yang valid: (0, 100].
`plugin`	Menentukan jenis SLI dan opsi-opsinya. Atur `id` ke `availability` atau `latency`, lalu konfigurasikan opsi yang sesuai. Lihat Field plugin.

Referensi field CRD

Field `metadata`

Field	Tipe	Wajib	Deskripsi	Contoh
`name`	String	Ya	Nama sumber daya kustom. Format: `asm-slo-{namespace}-{service}`.	`asm-slo-default-httpbin`
`namespace`	String	Ya	Namespace sumber daya kustom. Harus sesuai dengan namespace layanan target.	`default`
`labels`	Object	Tidak	Diisi otomatis oleh backend. Jangan atur secara manual. Sistem menambahkan dua label: `asm-target-namespace` (namespace layanan) dan `asm-target-service` (nama layanan, sama dengan `spec.service`).	`labels:` `asm-target-namespace: default` `asm-target-service: httpbin`

Field `spec`

Field	Tipe	Wajib	Deskripsi	Contoh
`service`	String	Ya	Nama layanan target.	`httpbin`
`period`	String	Ya	Periode waktu saat SLO berlaku. Nilai yang valid: `30d` (30 hari), `28d`, `14d`, `7d`.	`30d`
`labels`	Object	Tidak	Label global. Diteruskan ke field `labels` setiap aturan pencatatan yang dihasilkan oleh SLO dalam CRD ini.	`labels:` `global: "some-label"`
`slos`	Array	Ya	Satu atau beberapa definisi SLO. Setidaknya satu entri wajib disediakan.	-

Field `slos[]`

Setiap entri dalam array slos mendefinisikan satu SLO beserta targetnya, konfigurasi SLI, dan aturan peringatannya.

Field	Tipe	Wajib	Deskripsi	Contoh
`name`	String	Ya	Nama SLO.	`asm-slo`
`objective`	String	Ya	Target persentase dalam bentuk string yang dapat diuraikan menjadi bilangan titik mengambang. Rentang nilai yang valid: (0, 100].	`"99.9"`
`labels`	Object	Tidak	Label tingkat SLO. Diteruskan ke field `labels` setiap aturan pencatatan yang dihasilkan oleh SLO ini.	`labels:` `recordlabel: aaa`
`sli`	Object	Ya	Konfigurasi service level indicator (SLI). Lihat field `sli`.	-
`alerting`	Object	Ya	Konfigurasi aturan peringatan. Lihat field `alerting`.	-

Field `sli`

Objek sli hanya berisi satu field: plugin.

Field	Tipe	Wajib	Deskripsi	Contoh
`plugin`	Object	Ya	Konfigurasi plugin yang menentukan cara pengukuran SLI. Lihat Field plugin.	-

Bidang plugin

Plugin menentukan jenis pengukuran SLI. Atur id untuk memilih plugin, lalu konfigurasikan options yang sesuai.

Field	Tipe	Wajib	Deskripsi	Contoh
`id`	String	Ya	Jenis plugin. Nilai yang valid: `availability` (ketersediaan layanan), `latency` (latensi layanan).	`latency`
`options`	Map	Bersyarat	Opsi plugin. Wajib diisi jika plugin yang dipilih memiliki field wajib. Misalnya, `latency` memerlukan `bucket`. Lihat tabel opsi di bawah ini.	`options:` `bucket: "300"`

Opsi untuk `availability`

Ketika id diatur ke availability, opsi berikut tersedia:

Field	Tipe	Wajib	Deskripsi	Contoh
`filter`	String	Tidak	Filter label PromQL. Prometheus hanya menghitung metrik untuk permintaan yang sesuai dengan filter ini.	`request_protocol="http"`

Opsi untuk `latency`

Ketika id diatur ke latency, opsi berikut tersedia:

Field	Type	Wajib	Deskripsi	Contoh
`bucket`	String	Ya	Target latensi, dalam bentuk string yang dapat diuraikan menjadi bilangan bulat.	`"300"`
`filter`	String	Tidak	Filter label PromQL. Prometheus hanya menghitung metrik untuk permintaan yang sesuai dengan filter ini.	`request_protocol="http"`
`exclude_errors`	Boolean	Tidak	Apakah permintaan error harus dikecualikan dari perhitungan latensi. Nilai default: `false`. Saat `true`, permintaan dengan kode respons 5XX dikecualikan. Saat `false`, semua permintaan dimasukkan.	`false`

Field `alerting`

Field	Tipe	Wajib	Deskripsi	Contoh
`name`	String	Ya	Nama aturan peringatan.	`asm-alert`
`labels`	Map	Tidak	Label yang dilampirkan pada aturan peringatan.	`labels:` `alertlabel: bbb`
`annotations`	Map	Tidak	Anotasi yang dilampirkan pada aturan peringatan.	`annotations:` `alertanno: ccc`
`pageAlert`	Object	Tidak	Konfigurasi peringatan tingkat halaman dengan tingkat keparahan tinggi. Lihat field `pageAlert`.	-
`ticketAlert`	Object	Tidak	Konfigurasi peringatan tingkat tiket dengan tingkat keparahan rendah. Lihat field `ticketAlert`.	-

Field `pageAlert`

Field	Tipe	Wajib	Deskripsi	Contoh
`disable`	Boolean	Tidak	Apakah peringatan ini diaktifkan. Nilai default: `true` (diaktifkan). Atur ke `false` untuk menonaktifkan.	`false`
`labels`	Map	Tidak	Label yang dilampirkan pada peringatan ini.	`labels:` `pagelabel: ddd`
`annotations`	Map	Tidak	Anotasi yang dilampirkan pada peringatan ini.	`annotations:` `pageanno: eee`

Field `ticketAlert`

Field	Type	Wajib	Deskripsi	Contoh
`disable`	Boolean	Tidak	Apakah peringatan ini diaktifkan. Nilai default: `true` (diaktifkan). Atur ke `false` untuk menonaktifkan.	`false`
`labels`	Map	Tidak	Label yang dilampirkan pada peringatan ini.	`labels:` `pagelabel: ddd`
`annotations`	Map	Tidak	Anotasi yang dilampirkan pada peringatan ini.	`annotations:` `pageanno: eee`

Contoh YAML

Referensi field CRD

Field metadata

Field spec

Field slos[]

Field sli

Bidang plugin

Opsi untuk availability

Opsi untuk latency

Field alerting

Field pageAlert

Field ticketAlert