Simple Log Service：Fungsi bawaan dalam templat peringatan

Secara default, jika konversi gagal, fungsi akan mengembalikan nilai 0.0. Anda juga dapat menentukan nilai pengembalian kustom jika terjadi kegagalan konversi dengan menggunakan parameter default.

• Hasil yang dikembalikan oleh {{ float("123") }} adalah 123.0.
• Hasil yang dikembalikan oleh {{ float("foo") }} adalah 0.0.
• Hasil yang dikembalikan oleh {{ float("foo", default=1.23) }} adalah 1.23.

Secara default, jika konversi gagal, fungsi akan mengembalikan nilai 0. Anda juga dapat menentukan nilai pengembalian kustom jika terjadi kegagalan konversi dengan menggunakan parameter default.

• Hasil yang dikembalikan oleh {{ int(1.23) }} adalah 1.
• Hasil yang dikembalikan oleh {{ int("1.23") }} adalah 1.
• Hasil yang dikembalikan oleh {{ int("foo") }} adalah 0.
• Hasil yang dikembalikan oleh {{ int("foo", default=5) }} adalah 5.

• Hasil yang dikembalikan oleh {{ length("foo") }} adalah 3.
• Hasil yang dikembalikan oleh {{ length([1, 2]) }} adalah 2.
• Hasil yang dikembalikan oleh {{ length({"foo": "bar"}) }} adalah 1.

1 menunjukkan bahwa satu tempat desimal dipertahankan.

• Hasil yang dikembalikan oleh {{ round(1.23) }} adalah 1.
• Hasil yang dikembalikan oleh {{ round(1.56) }} adalah 2.
• Hasil yang dikembalikan oleh {{ round(1.56, 1) }} adalah 1.6.

Nilai 1.23 adalah string.

• Variabel n menentukan jumlah karakter yang ingin Anda pertahankan dalam string.
• Variabel end menentukan substring yang ingin Anda tambahkan ke string setelah string dipotong.

• Hasil yang dikembalikan oleh {{ truncate("foo bar", 5) }} adalah foo b.
• Hasil yang dikembalikan oleh {{ truncate("foo bar", 5, end="...") }} adalah foo b...

• Hasil yang dikembalikan oleh {{ quote(123) }} adalah "123".
• Hasil yang dikembalikan oleh {{ quote("foo") }} adalah "foo".

Anda dapat menggunakan parameter n untuk menentukan jumlah spasi yang ingin Anda gunakan untuk mengindentasi setiap baris string.

• Untuk {{ "foobar\n" }}{{ indent("foo\nbar") }}, hasil yang dikembalikan adalah:

  foobar
      foo
      bar

• Untuk {{ "foobar\n" }}{{ indent("foo\nbar", 2) }}, hasil yang dikembalikan adalah:

  foobar
    foo
    bar

• Anda dapat menggunakan parameter sep untuk menentukan pemisah yang ingin Anda gunakan untuk memisahkan string.
• Anda dapat menggunakan parameter maxsplit untuk menentukan jumlah maksimum kali string dapat dipisahkan.

  Jika Anda tidak mengonfigurasi parameter maxsplit atau jika Anda mengatur parameter maxsplit ke -1, jumlah kali string dapat dipisahkan tidak dibatasi.

• Hasil yang dikembalikan oleh {{ split('a b c ') }} adalah ['a', 'b', 'c'].
• Hasil yang dikembalikan oleh {{ split('a-b-c', sep='-') }} adalah ['a', 'b', 'c'].
• Hasil yang dikembalikan oleh {{ split('a-b-c', sep='-', maxsplit=1) }} adalah ['a', 'b-c'].
• Hasil yang dikembalikan oleh {{ split('a<>b<>c', sep='<>') }} adalah ['a', 'b', 'c'].

• Hasil yang dikembalikan oleh {{ list(("foo", "bar")) }} adalah ['foo', 'bar'].
• Hasil yang dikembalikan oleh {{ list("foo") }} adalah ['f', 'o', 'o'].

Jika Anda ingin mengurutkan elemen-elemen dari daftar dalam urutan terbalik, tentukan reverse=true.

• Hasil yang dikembalikan oleh {{ sort([3, 1, 2]) }} adalah [1, 2, 3].
• Hasil yang dikembalikan oleh {{ sort([3, 1, 2], reverse=true) }} adalah [3, 2, 1].

• Contoh pada bidang alert.labels:

  {
      "host": "host-1",
      "app": "nginx"
  }

• Konfigurasi fungsi dalam templat peringatan:

  {%- for key, val in dictsort(alert.labels) %}
  {{ key }}: {{ val }}
  {%- endfor %}

• Hasil:

  app: nginx
  host: host-1

Anda dapat menggunakan parameter d untuk menentukan karakter yang digunakan untuk menggabungkan elemen-elemen dari daftar.

• Hasil yang dikembalikan oleh {{ join([1, 2, 3]) }} adalah 123.
• Hasil yang dikembalikan oleh {{ join([1, 2, 3], ',') }} adalah 1,2,3.

• Hasil yang dikembalikan oleh {{ to_json("foo") }} adalah "foo".
• Hasil yang dikembalikan oleh {{ to_json(1.23) }} adalah 1.23.
• Hasil yang dikembalikan oleh {{ to_json(True) }} adalah true.
• Hasil yang dikembalikan oleh {{ to_json(alert.labels) }} adalah {"host": "host-1", "app": "nginx"}.

• Hasil yang dikembalikan oleh {{ parse_json('{"foo": "bar"}').foo }} adalah bar.
• Hasil yang dikembalikan oleh {{ parse_json('[1, 2, 3]')[1] }} adalah 2.

Anda dapat menggunakan parameter fmt untuk menentukan format ekspresi datetime.

• Hasil yang dikembalikan oleh {{ parse_date(1629820800) }} adalah 2021-08-25 00:00:00.
• Hasil yang dikembalikan oleh {{ parse_date("2021|08|25|00|00|00", fmt="%Y|%m|%d|%H|%M|%S") }} adalah 2021-08-25 00:00:00.

Anda dapat menggunakan parameter fmt untuk menentukan format ekspresi datetime.

Jika nilai input bukan objek tanggal, fungsi akan mengonversi nilai input menjadi objek tanggal sebelum memformat nilai input. Untuk informasi lebih lanjut tentang direktif yang digunakan untuk memformat string tanggal dan waktu, lihat Direktif pemformatan tanggal dan waktu. Untuk informasi lebih lanjut tentang zona waktu, lihat Zona waktu.

• Hasil yang dikembalikan oleh {{ format_date(1629820800) }} adalah 2021-08-25 00:00:00.
• Hasil yang dikembalikan oleh {{ format_date(1629820800, fmt="%Y/%m/%d %H:%M:%S") }} adalah 2021/08/25 00:00:00.
• Hasil yang dikembalikan oleh {{ format_date(1629820800, tz="UTC", fmt="%Y/%m/%d %H:%M:%S") }} adalah 2021/08/24 16:00:00.

Jika nilai input bukan objek tanggal, fungsi akan mengonversi nilai input menjadi objek tanggal sebelum memformat nilai input.

• Hasil yang dikembalikan oleh {{ timestamp("2021-08-25 00:00:00") }} adalah 1629820800.
• Hasil yang dikembalikan oleh {{ timestamp(parse_date("2021-08-25 00:00:00")) }} adalah 1629820800.

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Hasil yang dikembalikan oleh {{ 10 | format_duration }} adalah 10s.
• Hasil yang dikembalikan oleh {{ 60 | format_duration }} adalah 1m.
• Hasil yang dikembalikan oleh {{ 3600 | format_duration }} adalah 1h.
• Hasil yang dikembalikan oleh {{ 86400 | format_duration }} adalah 1d.
• Hasil yang dikembalikan oleh {{ 100000 | format_duration }} adalah 1d3h46m40s.
• Hasil yang dikembalikan oleh {{ 100000 | format_duration(sep=",") }} adalah 1d,3h,46m,40s.

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Tipe peringatan adalah sls_pub.
• Konfigurasi fungsi dalam templat peringatan:

  {{ format_type(alert.type) }}

• Hasil:
  • Jika nilai parameter locale adalah en-US, tipe peringatan dalam notifikasi peringatan adalah Pub Alert.

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Wilayah peringatan adalah cn-hangzhou.
• Konfigurasi fungsi dalam templat peringatan:

  {{ format_region(alert.region) }}

• Hasil:
  • Jika nilai parameter locale adalah en-US, wilayah peringatan dalam notifikasi peringatan adalah China (Hangzhou).

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Tingkat keparahan peringatan adalah 6
• Konfigurasi fungsi dalam templat peringatan:

  {{ format_severity(alert.severity) }}

• Hasil:
  • Jika nilai parameter locale adalah en-US, tingkat keparahan peringatan dalam notifikasi peringatan adalah Medium dalam warna kuning.

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Status peringatan adalah Firing.
• Konfigurasi fungsi dalam templat peringatan:

  {{ format_status(alert.status) }}

• Hasil:
  • Jika nilai parameter locale adalah en-US, status peringatan dalam notifikasi peringatan adalah Firing dalam warna merah.

• Label peringatan berikut ditambahkan:

  {
      "app": "nginx",
      "host": "host-1"
  }

• Konfigurasi fungsi dalam templat peringatan:

  {{ to_list(alert.labels) }}

• Hasil:
  • Jika notifikasi peringatan dalam format Markdown, fungsi mengembalikan hasil berikut:

    Fungsi dapat secara otomatis menghindari karakter dalam hasil berdasarkan konfigurasi metode notifikasi.

    - app: nginx
    - host: host-1

  • Jika notifikasi peringatan dalam format HTML, fungsi mengembalikan hasil berikut:

    <ul>
      <li>app: nginx</li>
      <li>host: host-1</li>
    </ul>

  • Jika notifikasi peringatan dalam format teks, fungsi mengembalikan hasil berikut:

    [app: nginx][host: host-1]

Anda dapat menggunakan parameter locale untuk menentukan bahasa deskripsi teks. Untuk informasi lebih lanjut tentang nilai valid dari parameter locale, lihat bagian "Nilai valid dari parameter locale dalam fungsi peringatan" dari topik ini.

• Anotasi berikut ditambahkan:

  {
      "title": "NGINX access error",
      "desc": "80% penurunan tahunan pada PVs",
      "cnt": "120"
  }

• Konfigurasi fungsi dalam templat peringatan:

  {{ annotations_to_list(alert.annotations) }}

• Hasil:
  Jika notifikasi peringatan dalam format Markdown, fungsi mengembalikan hasil berikut:

  -Title: NGINX access error
  -Description: 80% penurunan tahunan pada PVs
  - cnt: 120

• Jika notifikasi peringatan dalam format Markdown, tanda kurung sudut penutup > ditambahkan ke awal setiap baris.
• Jika notifikasi peringatan dalam format HTML, tag <blockquote> digunakan untuk mengapit konten notifikasi peringatan.

• Konfigurasi fungsi dalam templat peringatan:

  {{ blockquote("foo\nbar") }}

• Hasil:
  • Jika notifikasi peringatan dalam format Markdown, fungsi mengembalikan hasil berikut:

    > foo
    > bar

  • Jika notifikasi peringatan dalam format HTML, fungsi mengembalikan hasil berikut:

    <blockquote>
    foo
    bar
    </blockquote>