Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Melihat log eksekusi

Application Integration menghasilkan log eksekusi mendetail untuk setiap eksekusi integrasi. Anda dapat menggunakan log eksekusi untuk memecahkan masalah kegagalan eksekusi integrasi, mengidentifikasi status eksekusi setiap langkah dalam integrasi, dan memantau status eksekusi integrasi utama dan sub-integrasi. Untuk mengetahui informasi selengkapnya tentang logging di Application Integration, lihat Pengantar log.

Melihat log eksekusi integrasi

Anda dapat melihat log eksekusi di konsol Google Cloud atau menggunakan API.

Catatan: Jika ukuran log eksekusi lebih besar dari 300 MB, Application Integration akan menampilkan error Response size too large dan log tidak akan dimuat di halaman Execution Logs. Jika demikian, gunakan metode projects.locations.integrations.executions.list seperti yang dijelaskan di tab API.

Konsol

Untuk melihat log eksekusi di konsol Google Cloud , lakukan langkah-langkah berikut:

Di konsol Google Cloud , buka halaman Application Integration.
Buka Application Integration
Di menu navigasi, klik Logs.
Halaman Execution Logs akan muncul dan mencantumkan log eksekusi yang dihasilkan untuk integrasi di region default. Atribut berikut ditampilkan untuk setiap pesan log eksekusi:
- Nama integrasi: Nama integrasi.
- ID Eksekusi: ID unik yang dibuat untuk setiap operasi integrasi.
- Status: Status eksekusi integrasi.
  - Sedang diproses: 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.
  - On hold: Menunjukkan bahwa eksekusi integrasi dijeda untuk sementara dan sedang menunggu peristiwa atau tindakan selesai.
  - Coba lagi ditahan: Menunjukkan bahwa eksekusi integrasi gagal dan sedang menunggu percobaan ulang.
  - Suspended: Menunjukkan bahwa eksekusi integrasi dijeda sementara dan memerlukan intervensi manual untuk melanjutkan integrasi.
- Waktu mulai: Stempel waktu saat integrasi mulai dieksekusi.
- Duration: Waktu yang diperlukan untuk eksekusi integrasi.
  Catatan: Jangan gunakan nilai Duration untuk menghitung latensi eksekusi end-to-end dari sebuah integrasi. Waktu yang ditampilkan di kolom Duration tidak mencerminkan total waktu eksekusi integrasi, karena tidak memperhitungkan waktu tambahan yang diperlukan oleh integrasi sebelum atau setelah eksekusinya. Misalnya, waktu yang diperlukan untuk penerapan kuota atau autentikasi tidak tercermin dalam nilai Duration.
- 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 ditetapkan ke Disabled.
- 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 ulang 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 sesuai harapan. Untuk mempelajari cara memutar ulang eksekusi, lihat Memutar ulang eksekusi.
Untuk melihat log eksekusi khusus region, ubah region dari daftar Region.
Atau, Anda dapat mengklik refresh Refresh Logs untuk memuat ulang daftar log saat ini.

Gambar berikut menunjukkan contoh halaman Execution Logs Application Integration.

API

Jika ukuran log eksekusi lebih besar dari 300 MB, Application Integration akan menampilkan error Response too large error dan log tidak akan dimuat di halaman Execution Logs. 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 yang ditetapkan ke TRUE:
```
curl -v -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/INTEGRATION_NAME/executions' \
    -d "snapshotMetadataWithoutParams=true"
```
Ganti kode berikut:
- PROJECT_ID: ID project Google Cloud Anda.
- LOCATION: region integrasi.
- INTEGRATION_NAME: nama integrasi.
ID eksekusi ditampilkan dalam respons. Salin ID eksekusi yang ingin Anda lihat log-nya.
Untuk mendapatkan log eksekusi untuk ID eksekusi, buat permintaan GET menggunakan metode projects.locations.integrations.executions.list dengan filter pada ID eksekusi yang Anda salin di langkah sebelumnya:
```
curl -X GET \
    -G \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    'https://integrations.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/integrations/-/executions' \
    --data-urlencode 'filter=execution_id="EXECUTION_ID"'
```
Ganti kode berikut:
- PROJECT_ID: ID project Google Cloud Anda.
- LOCATION: region integrasi.
- EXECUTION_ID: ID eksekusi yang disalin dari langkah sebelumnya.
Dalam respons, lihat kolom ExecutionDetails untuk melihat detail log.

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

Contoh: Memfilter log

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

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

Ganti kode berikut:

PROJECT_ID: ID project Google Cloud Anda.
LOCATION: region integrasi.
INTEGRATION_NAME: nama integrasi.

Anda dapat memfilter kolom berikut:

execution_id, workflow_name, dan trigger_id: Mengapit nilai string ini dalam tanda kutip ganda.
state: Menerima nilai status ExecutionDetails, seperti FAILED atau SUCCEEDED. Jangan gunakan tanda kutip (misalnya, state=FAILED).
create_timestamp dan update_time: Memerlukan stempel waktu RFC 3339 dalam UTC, yang diakhiri dengan Z. Jangan gunakan tanda petik (misalnya, create_timestamp>=2026-10-01T00:00:00Z).

Melihat detail eksekusi tugas

Anda dapat melihat log mendetail tentang eksekusi setiap tugas dalam integrasi atau sub-integrasi. Untuk melihat detail eksekusi tugas, buka halaman Execution Logs dan luaskan nama integrasi yang ingin Anda lihat detail eksekusi tugasnya.

Halaman Execution Logs menampilkan daftar log eksekusi untuk integrasi. Setiap log eksekusi sesuai dengan operasi integrasi tertentu.

Untuk melihat detail eksekusi tugas tertentu, klik nama tugas. Panel Task Execution Details akan muncul dan menampilkan detail eksekusi tugas.
Poin Penting: Panel Task Execution Details menampilkan nilai lengkap variabel tugas yang tidak dipotong, sehingga Anda dapat melakukan debug secara efektif.
Untuk melihat parameter permintaan dan respons tugas, klik Request Parameters atau Response Parameters.
Untuk melihat log eksekusi sub-integrasi, luaskan nama tugas dan klik nama sub-integrasi. Hal ini berlaku untuk tugas Call Integration, tugas For Each Parallel, tugas For Each Loop, dan tugas While Loop.

Filter log

Anda dapat memfilter log berdasarkan kriteria seperti, nama integrasi, ID eksekusi, rentang tanggal atau waktu, status eksekusi, jenis variabel, dan nama atau nilai variabel. 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 eksekusi ujinya ingin Anda cantumkan.

Contoh: Integration name:example-integration-name:example-test-case.

Gunakan log untuk memecahkan masalah

Bagian berikut menjelaskan cara memecahkan masalah kegagalan untuk kasus penggunaan berikut:

Memecahkan masalah kegagalan integrasi
Melihat pengecualian stack trace
Melacak kegagalan konektor

Memecahkan masalah kegagalan integrasi

Pesan log eksekusi dapat menjadi referensi yang berharga saat memecahkan masalah eksekusi integrasi yang gagal.

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

Telusuri atau pilih integrasi yang akan dipecahkan masalahnya dari daftar Integrations, 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 ingin Anda lihat lognya.
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 dalam rentang waktu tertentu, di kolom Execution log filter, pilih Start date after dan masukkan waktu yang diinginkan dalam format yang valid. Kemudian, pilih Tanggal akhir sebelum dan masukkan waktu yang diinginkan. Beberapa filter digabungkan menggunakan kondisi AND secara default.

Jika integrasi gagal selama jangka waktu yang difilter, halaman Execution Logs akan menampilkan daftar pesan log. Setiap pesan log sesuai dengan kegagalan tertentu dalam menjalankan integrasi.

Untuk mengetahui informasi tentang cara memecahkan masalah log eksekusi yang gagal menggunakan AI, lihat Memecahkan masalah log eksekusi yang gagal menggunakan AI.

Melihat pengecualian stack trace

Untuk melihat daftar pengecualian, klik pesan log mana pun. Klik link di setiap pesan pengecualian untuk melihat pelacakan tumpukan 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 Application Integration:

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

Application Integration 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 Query 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"

Download log

Anda dapat mendownload log untuk eksekusi integrasi tertentu guna membantu proses debug dan analisis. Log berisi informasi mendetail tentang proses eksekusi, termasuk stempel waktu, peristiwa, dan error yang terjadi.

Untuk mendownload log eksekusi integrasi, lakukan langkah-langkah berikut:

Buka halaman Execution Logs.
Di baris yang sesuai dengan eksekusi integrasi yang lognya ingin Anda download, klik (menu tindakan), lalu pilih Download.

Log eksekusi didownload sebagai file JSON ke folder download default browser Anda.

Batasan

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

Langkah berikutnya

Untuk mengetahui informasi tentang log di Application Integration, lihat Pengantar log.
Pelajari Kasus Pengujian.