Mengirim log ke Cloud Logging

Alur kerja otomatis menghasilkan log eksekusi untuk eksekusi alur kerja di Cloud Logging.

Anda juga dapat mengaktifkan logging panggilan. Atau, Anda dapat membuat log kustom yang menggunakan fungsi sys.log di sumber Anda. Logging panggilan dan log kustom dapat Anda gunakan untuk mengontrol kapan log dikirim ke Logging selama eksekusi alur kerja, dan dapat sangat membantu saat men-debug alur kerja Anda.

Untuk mengetahui detailnya, termasuk file proto logging engine_call dan executions_system, lihat repositori GitHub ini.

Log eksekusi

Setiap eksekusi alur kerja secara otomatis memicu setidaknya dua log eksekusi: satu di awal eksekusi dan satu di akhir.

Untuk informasi selengkapnya tentang log platform Workflows yang tersedia di Logging, lihat Log platform Google Cloud.

Pencatatan panggilan

Anda dapat menetapkan flag sehingga setiap langkah panggilan selama eksekusi alur kerja akan dicatat dalam log, dan nama langkah, nama fungsi, argumen fungsi, dan respons panggilan akan ditampilkan. Atau, Anda dapat mencatat setiap pengecualian yang tertangkap, atau yang menghentikan panggilan.

Hanya langkah panggilan eksplisit yang dicatat ke dalam log; misalnya, panggilan ke sub-alur kerja atau fungsi library. Panggilan dari dalam ekspresi, atau dalam fungsi library standar (misalnya, http.post di sys.log), dan di dalam konektor tidak dicatat ke dalam log.

Header permintaan Authorization HTTP disamarkan dari log untuk panggilan HTTP.

Saat menerapkan logging panggilan ke definisi alur kerja atau ke eksekusi alur kerja, Anda dapat menentukan tingkat logging yang diperlukan. Level log eksekusi lebih diutamakan daripada level log alur kerja apa pun, kecuali jika level log eksekusi tidak ditentukan (default); dalam hal ini, level log alur kerja akan berlaku.

Perhatikan bahwa batas ukuran entri log yang ditetapkan oleh Cloud Logging juga berlaku untuk logging panggilan.

Log kustom

Untuk membuat entri log di Logging selama eksekusi alur kerja, tentukan langkah dalam alur kerja yang melakukan panggilan ke fungsi sys.log library standar:

YAML

  - step1:
      assign:
          - varA: "Hello"
          - varB: "World"
  - logStep:
      call: sys.log
      args:
          text: TEXT
          severity: SEVERITY 
  - step2:
      return: ${varA + " " + varB}
    

JSON

    [
      {
        "step1": {
          "assign": [
            {
              "varA": "Hello"
            },
            {
              "varB": "World"
            }
          ]
        }
      },
      {
        "logStep": {
          "call": "sys.log",
          "args": {
            "text": "TEXT",
            "severity": "SEVERITY"
          }
        }
      },
      {
        "step2": {
          "return": "${varA + " " + varB}"
        }
      }
    ]
      

Saat membuat entri log, tentukan hal-hal berikut:

• TEXT: wajib diisi. Teks yang akan dicatat. Jika Anda perlu mencatat nilai peta ke dalam log, gunakan ${json.encode_to_string(myMap)}.
• SEVERITY: optional. Tingkat keparahan entri log. Misalnya, INFO, WARNING, atau CRITICAL.

Untuk mengetahui informasi selengkapnya, lihat referensi fungsi sys.log.

Izin yang diperlukan

Untuk menerapkan logging panggilan atau mengirim log kustom ke Logging, alur kerja harus dikaitkan dengan akun layanan yang menyertakan izin logging.logEntries.create (misalnya, peran roles/logging.logWriter). Jika Anda perlu mengubah akun layanan yang diperbarui dengan alur kerja, lihat Memperbarui alur kerja. Untuk mempelajari lebih lanjut cara membuat akun layanan dan menetapkan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Lihat log alur kerja

Anda dapat melihat log di Workflows atau di Logging. Untuk melihat log untuk satu alur kerja, gunakan tab Logs di Alur kerja. Untuk mendapatkan tampilan gabungan log untuk semua alur kerja Anda, gunakan halaman Logs Explorer di Logging.

Melihat log di Workflows

Untuk melihat log alur kerja di Workflows, lakukan hal berikut:

1. Di konsol Google Cloud, buka halaman Workflows:

   Buka Workflows

2. Untuk mengakses log alur kerja, klik nama alur kerja untuk membuka halaman Details.

3. Untuk melihat log, klik Logs.

4. Untuk memfilter log menurut tingkat keparahan, dalam daftar Default, pilih jenis log yang akan ditampilkan. Secara default, log dari semua tingkat keparahan ditampilkan.

Tab Logs di halaman Details alur kerja menampilkan jenis log berikut:

• Log dikirim ke Logging

• Log audit operasi apa pun yang dilakukan pada alur kerja, seperti pembaruan pada definisi alur kerja

Lihat log di Logging

Untuk melihat log di Logging, lakukan langkah-langkah berikut:

1. Di konsol Google Cloud, buka halaman Logs Explorer:
   

   Buka Logs Explorer

2. Di Query builder, klik Resource dan masukkan workflow. Pilih Cloud Workflow dari daftar, lalu klik Add.

   

3. Klik Jalankan kueri.

Untuk mempelajari lebih lanjut cara melihat log di Logging, baca artikel Menggunakan Logs Explorer.

Langkah selanjutnya

• Menjalankan alur kerja

• Memecahkan masalah