Melihat log eksekusi

Integrasi Aplikasi menghasilkan pesan log eksekusi untuk setiap pengoperasian integrasi. Pesan log berisi informasi yang dapat membantu menentukan status setiap langkah dalam integrasi, atau untuk memecahkan masalah integrasi, tugas, atau peristiwa yang gagal. Untuk mengetahui informasi selengkapnya tentang logging di Integrasi Aplikasi, lihat Pengantar log.

Melihat log eksekusi integrasi

Untuk melihat halaman Execution Logs, pilih salah satu opsi:

Konsol

Di Application Integration, buka halaman Logs.
Buka Log Integrasi Aplikasi
Di menu navigasi, klik Logs. Atau, di menu navigasi, klik Integration, lalu pilih integrasi yang log-nya ingin Anda lihat. Kemudian, klik Lihat log eksekusi untuk integrasi ini. Halaman Execution Logs akan muncul.
Catatan: Jika ukuran log eksekusi lebih besar dari 300 MB, Integrasi Aplikasi akan menampilkan error Response size too large dan log tidak akan dimuat di halaman Log Eksekusi. Dalam hal ini, gunakan metode projects.locations.integrations.executions.list seperti yang dijelaskan di tab API.
Dari daftar Region, pilih region untuk melihat log eksekusi khusus region integrasi. Anda juga dapat mengklik muat ulang Muat Ulang Log untuk memuat ulang daftar log saat ini.

Gambar berikut menunjukkan contoh halaman Log Eksekusi Integrasi Aplikasi.

Atribut berikut ditampilkan untuk setiap pesan log eksekusi.
- Nama integrasi: Nama integrasi.
- ID Eksekusi: ID unik yang dibuat untuk setiap pengoperasian integrasi.
- Status: Status eksekusi integrasi.
  - Dalam proses: Menunjukkan bahwa integrasi sedang dijalankan.
  - Berhasil: Menunjukkan bahwa integrasi berhasil dijalankan.
  - Gagal: Menunjukkan bahwa integrasi gagal dijalankan.
  - Dibatalkan: Menunjukkan bahwa eksekusi integrasi dibatalkan oleh pengguna.
  - Tertunda: Menunjukkan bahwa eksekusi integrasi dijeda untuk sementara dan menunggu peristiwa atau tindakan selesai.
  - Tunggu untuk mencoba lagi: Menunjukkan bahwa eksekusi integrasi gagal dan sedang menunggu percobaan ulang.
  - Ditangguhkan: Menunjukkan bahwa eksekusi integrasi dijeda untuk sementara dan memerlukan intervensi manual untuk melanjutkan integrasi.
- Start time: Stempel waktu saat integrasi memulai eksekusi.
- Durasi: Waktu yang diperlukan untuk eksekusi integrasi.
  Catatan: Jangan gunakan nilai Duration untuk menghitung latensi eksekusi menyeluruh integrasi. Waktu yang ditampilkan di kolom Durasi tidak mencerminkan total waktu eksekusi integrasi, karena tidak memperhitungkan waktu tambahan yang diperlukan integrasi sebelum atau setelah eksekusi. Misalnya, waktu yang diperlukan untuk penerapan kuota atau autentikasi tidak tercermin dalam nilai Durasi.
- Versi Integrasi: Versi integrasi yang dijalankan.
- ID Pemicu: Nilai ID pemicu.
- Cloud Logging: Menunjukkan apakah integrasi dikonfigurasi untuk mencatat log ke Cloud Logging. Jika Cloud Logging diaktifkan, kolom ini akan menyediakan link untuk melihat log di Cloud Logging. Jika Cloud Logging tidak diaktifkan, kolom ini akan disetel ke Nonaktif.
- Diputar ulang dari: Jika eksekusi integrasi diputar ulang, kolom ini akan memberikan ID eksekusi dari eksekusi yang diputar ulang. Anda dapat memutar ulang eksekusi integrasi yang dipublikasikan jika ingin menjalankan kembali integrasi dengan parameter yang sama seperti eksekusi sebelumnya. Misalnya, Anda dapat memutar ulang eksekusi jika integrasi gagal karena error waktu tunggu habis atau jika output integrasi tidak seperti yang diharapkan. Untuk mempelajari cara memutar ulang eksekusi, lihat Memutar ulang eksekusi.
Di kolom Filter, tambahkan filter. Anda dapat memfilter log berdasarkan kriteria seperti nama integrasi, ID eksekusi, tanggal atau rentang waktu, status eksekusi, jenis variabel, dan nama atau nilai variabel. Untuk penelusuran yang lebih disesuaikan, gunakan metode projects.locations.integrations.executions.list seperti yang dijelaskan di tab API.
Untuk menambahkan filter untuk eksekusi kasus pengujian, gunakan format berikut:
Integration name:INTEGRATION_NAME:TEST_CASE_NAME.
Ganti kode berikut:
- INTEGRATION_NAME: nama integrasi yang berisi pengujian fungsional.
- TEST_CASE_NAME: nama kasus pengujian yang ingin Anda cantumkan eksekusi pengujiannya.

API

Jika ukuran log eksekusi lebih besar dari 300 MB, Integrasi Aplikasi akan menampilkan error Response too large error dan log tidak akan dimuat di halaman Log Eksekusi. Dalam hal ini, Anda harus menggunakan metode projects.locations.integrations.executions.list untuk mendapatkan log. Untuk melihat log menggunakan metode API, ikuti langkah-langkah berikut:

Untuk mendapatkan ID eksekusi yang log eksekusinya ingin Anda lihat, buat permintaan GET menggunakan metode projects.locations.integrations.executions.list dengan parameter snapshotMetadataWithoutParams ditetapkan ke TRUE:
```
curl -v -X -G GET
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'snapshotMetadataWithoutParams=true'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
```
ID eksekusi ditampilkan dalam respons. Salin ID eksekusi yang ingin Anda lihat log-nya.
Untuk mendapatkan log eksekusi untuk ID eksekusi, buat permintaan POST menggunakan metode projects.locations.integrations.executions.list dengan filter pada ID eksekusi yang Anda salin di langkah sebelumnya:
```
curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter=execution_id="EXECUTION_ID"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions'
```
Dalam respons, lihat kolom ExecutionDetails untuk melihat detail log.

Atau, di konsol Google Cloud, Anda dapat memfilter log eksekusi menurut ID eksekusi.

Contoh: Memfilter log

Jika Anda ingin memfilter respons untuk mencantumkan log untuk semua integrasi kecuali satu integrasi, gunakan format berikut:

curl -v -X -G GET 
    -H "Content-Type: application/json"
    -H "Authorization: Bearer $(gcloud auth print-access-token)"
    -d 'filter= workflowName!="INTEGRATION_NAME"'
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions'

Gunakan log untuk memecahkan masalah

Bagian berikut menjelaskan cara memecahkan masalah kegagalan menggunakan log eksekusi Integrasi Aplikasi.

Memecahkan masalah kegagalan integrasi

Pesan log eksekusi dapat menjadi referensi yang berharga saat memecahkan masalah integrasi yang tidak berhasil dijalankan.

Misalnya, jika integrasi gagal berjalan dalam jangka waktu tertentu, gunakan langkah-langkah berikut untuk mengakses dan memfilter log guna memecahkan masalah kegagalan:

Telusuri atau pilih integrasi yang akan dipecahkan masalahnya dari daftar Integrasi, lalu klik untuk membuka editor integrasi.
Klik Logs di toolbar editor integrasi untuk melihat pesan log.
Di kolom Execution log filter, pilih Integration name dan masukkan nama integrasi yang log-nya ingin Anda lihat.
Klik Enter.
Untuk menampilkan integrasi yang gagal, di kolom Execution log filter, pilih Execution status untuk menampilkan daftar status, lalu pilih Failed.
Untuk menampilkan integrasi yang gagal antara rentang waktu tertentu, di kolom Filter log eksekusi, pilih Tanggal mulai setelah, lalu masukkan waktu yang diinginkan dalam format yang valid. Kemudian, pilih Tanggal akhir sebelum dan masukkan waktu yang diinginkan. Beberapa filter digabungkan menggunakan kondisi DAN secara default.

Jika integrasi gagal selama jangka waktu yang difilter, halaman Log Eksekusi akan menampilkan daftar pesan log. Setiap pesan log sesuai dengan kegagalan integrasi tertentu.

Melihat pengecualian pelacakan tumpukan

Untuk melihat daftar pengecualian, klik pesan log mana pun. Klik link di setiap pesan pengecualian untuk melihat stack trace lengkap pengecualian.

gambar yang menampilkan error pengecualian log yang diperluas

Melacak kegagalan konektor

Anda dapat menggunakan pesan log eksekusi untuk memecahkan masalah dan melacak eksekusi tugas konektor yang gagal. Data log tugas konektor yang gagal disimpan menggunakan Cloud Logging dan dapat dilihat di Logs Explorer.

Lakukan langkah-langkah berikut untuk mengakses data log tugas konektor yang gagal dari Integrasi Aplikasi:

Buka halaman Execution Logs untuk integrasi yang Anda inginkan.
Luaskan pesan log dari eksekusi yang gagal, dan pelacakan tumpukan ke baris yang berisi tugas Konektor yang gagal.
Di kolom Status, klik Failed.

Integrasi Aplikasi akan otomatis menjalankan kueri yang diperlukan untuk tugas konektor yang gagal dan membuka halaman Logs Explorer untuk menampilkan data log eksekusi yang mendetail.

Untuk mengambil data log tugas konektor yang gagal secara manual, Anda dapat menjalankan kueri berikut di halaman Kueri Logs Explorer. Untuk mengetahui informasi selengkapnya tentang cara menggunakan Logs Explorer, lihat Antarmuka Logs Explorer.

Format kueri

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="EXECUTION_ID_EXECUTION_TASK_ID_EXECUTION_ATTEMPT_NUMBER"

Contoh

resource.type="connectors.googleapis.com/Connection"
jsonPayload.integration_connectors_trace_id="9db51e4b-7d57-473d-931f-cc27b282dfad_1_2"

Batasan

Jika logging lokal dinonaktifkan untuk integrasi, log eksekusi tidak akan dibuat untuk integrasi tersebut.

Langkah selanjutnya

Untuk mengetahui informasi tentang log di Integrasi Aplikasi, lihat Pengantar log.
Pelajari Kasus Pengujian.