Log Integrasi Apigee

Pengumuman: Application Integration kini tersedia untuk project Google Cloud Anda. Anda kini dapat menggunakan Integrasi Apigee dan Application Integration dalam project Google Cloud yang sama. Pelajari lebih lanjut

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

Catatan: Integrasi Apigee mempertahankan log eksekusi integrasi selama jangka waktu maksimum 32 hari.

Lihat log eksekusi integrasi

Untuk melihat halaman Log Eksekusi, pilih salah satu opsi:

Konsol

1. Di Application Integration, buka halaman Logs.

   Buka Application Integration Logs

2. Di menu navigasi, klik Log. Atau, di menu navigasi, klik Integration dan pilih integrasi yang lognya 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 Apigee akan menampilkan error Response size too large dan log tidak dimuat di halaman Execution Logs. Dalam hal ini, gunakan metode projects.locations.integrations.executions.list seperti yang dijelaskan di tab API.
3. Dari daftar Region, pilih region untuk melihat log eksekusi integrasi khusus region. Anda juga dapat mengklik refresh Refresh Log untuk memuat ulang daftar log saat ini.

   Gambar berikut menunjukkan contoh halaman Execution Logs Apigee Integration.

   

   Atribut berikut ditampilkan untuk setiap pesan log eksekusi.

   • Nama integrasi: Nama integrasi.
   • ID Eksekusi: ID unik yang dihasilkan 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.
     • Ditangguhkan: Menunjukkan bahwa eksekusi integrasi dijeda sementara dan menunggu peristiwa atau tindakan selesai.
     • Coba lagi ditangguhkan: Menunjukkan bahwa eksekusi integrasi gagal dan sedang menunggu percobaan ulang.
     • Ditangguhkan: Menunjukkan bahwa eksekusi integrasi dijeda sementara dan memerlukan intervensi manual untuk melanjutkan integrasi.
   • Waktu mulai: Stempel waktu saat integrasi memulai eksekusi.
   • Durasi: Waktu yang diperlukan untuk menjalankan integrasi.
     Catatan: Jangan gunakan nilai Duration untuk menghitung latensi eksekusi integrasi secara menyeluruh. Waktu yang ditampilkan di kolom Durasi tidak mencerminkan total waktu eksekusi integrasi karena waktu tambahan tersebut 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 Durasi.
   • Versi Integrasi: Versi integrasi yang dijalankan.
   • ID Pemicu: Nilai ID pemicu.

4. 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.

API

Jika ukuran log eksekusi lebih besar dari 300 MB, Integrasi Apigee akan menampilkan error Response too large error dan log tidak 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:

1. Untuk mendapatkan ID eksekusi yang log eksekusinya ingin Anda lihat, buat permintaan GET menggunakan metode projects.locations.integrations.executions.list dengan parameter snapshotMetadataWithoutParams yang disetel 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 lognya ingin Anda lihat.

2. Guna 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 yang diharapkan untuk 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 Apigee.

Memecahkan masalah kegagalan integrasi

Pesan log eksekusi dapat menjadi sumber daya berharga saat memecahkan masalah integrasi yang gagal berjalan.

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

1. Telusuri atau pilih integrasi yang ingin dipecahkan dari daftar Integrations, dan klik untuk membuka editor integrasi.
2. Klik Logs di toolbar editor integrasi untuk melihat pesan log.
3. Klik Add a filter untuk menampilkan daftar filter yang tersedia.
4. Pilih Nama integrasi.
5. Masukkan nama integrasi, lalu klik Terapkan.
6. Klik Add a filter untuk menampilkan daftar filter yang tersedia.
7. Pilih Execution status untuk menampilkan daftar status.
8. Centang kotak FAILED, lalu klik Apply untuk menampilkan integrasi yang gagal.
9. Klik Add a filter untuk menampilkan daftar filter yang tersedia.
10. Pilih Rentang tanggal/waktu, lalu masukkan rentang waktu yang diinginkan untuk memeriksa kegagalan. Misalnya, masukkan:
    • Tanggal Dari: Pilih 2020-12-16
    • From Time: Pilih 04:00:00 PM
    • Tanggal Akhir: Pilih 2019-12-16
    • Ke Waktu: Pilih 05:00:00 PM
    Beberapa filter digabungkan menggunakan kondisi AND secara default.
    • Klik Terapkan.

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

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.

Catatan: Parameter peristiwa pesan log eksekusi (string atau JSON) terpotong dengan batas 2.000 karakter.

Kegagalan konektor rekaman aktivitas

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.

Catatan: Data log dari tugas konektor yang gagal tersedia di Logs Explorer hanya jika Cloud Logging diaktifkan untuk masing-masing koneksi di Integration Connectors. Lihat Melihat log konektor untuk detail selengkapnya.

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

1. Buka halaman Execution Logs dari integrasi yang Anda inginkan.
2. Luaskan pesan log tentang kegagalan eksekusi, dan pelacakan tumpukan ke baris yang berisi Tugas konektor yang gagal.
3. Di kolom Status, klik Gagal.

   

Integrasi Apigee 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 dari tugas konektor yang gagal secara manual, Anda dapat menjalankan kueri berikut di halaman Query di 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 informasi tentang log di Integrasi Apigee, lihat Pengantar log.