Log Integrasi Apigee

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

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

Catatan: Integrasi Apigee menyimpan log eksekusi integrasi selama periode maksimum 32 hari.

Lihat log eksekusi integrasi

Untuk melihat halaman Execution Logs, pilih salah satu opsi:

Konsol

1. Di Application Integration, buka halaman Logs.

   Buka Log Application Integration

2. Di menu navigasi, klik Log. Atau, dalam menu navigasi, klik Integration dan pilih integrasi yang ingin Anda lihat log. 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 akan dimuat di halaman Log Eksekusi. 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 khusus region untuk integrasi tersebut. Anda juga dapat mengklik memuat ulang Muat Ulang Log untuk memuat ulang daftar log saat ini.

   Gambar berikut menampilkan contoh halaman Execution Logs Integrasi Apigee.

   

   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 saat ini 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 diselesaikan.
     • Coba lagi yang ditangguhkan: Menunjukkan bahwa eksekusi integrasi gagal dan 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 dibutuhkan untuk menjalankan integrasi.
     Catatan: Jangan gunakan nilai Duration untuk menghitung latensi eksekusi menyeluruh dari sebuah integrasi. Waktu yang ditampilkan di kolom Durasi tidak mencerminkan total waktu eksekusi integrasi, karena integrasi itu tidak memperhitungkan waktu tambahan apa pun yang dibutuhkan oleh integrasi sebelum atau setelah eksekusinya. Misalnya, waktu yang dibutuhkan untuk penerapan kuota atau autentikasi tidak ditampilkan 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 memberikan link untuk melihat log di Cloud Logging. Jika Cloud Logging tidak diaktifkan, kolom ini akan disetel ke Nonaktif.

4. Di kolom Filter, tambahkan filter. 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 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 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:

1. Untuk mendapatkan ID eksekusi yang ingin Anda lihat log eksekusinya, 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 ingin Anda lihat lognya.

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 pada 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 berdasarkan ID eksekusi.

Contoh: Memfilter log

Jika Anda ingin memfilter respons guna 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 kegagalan menggunakan log eksekusi Integrasi Apigee.

Memecahkan masalah kegagalan integrasi

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

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

1. Telusuri atau pilih integrasi untuk memecahkan masalah dari daftar Integrations dan klik untuk membuka editor integrasi.
2. Klik Logs di toolbar editor integrasi untuk melihat pesan log.
3. Klik Tambahkan filter untuk menampilkan daftar filter yang tersedia.
4. Pilih Integration name.
5. Masukkan nama integrasi, lalu klik Apply.
6. Klik Tambahkan filter untuk menampilkan daftar filter yang tersedia.
7. Pilih Status eksekusi untuk menampilkan daftar status.
8. Centang kotak FAILED, lalu klik Apply untuk menampilkan integrasi yang gagal.
9. Klik Tambahkan filter untuk menampilkan daftar filter yang tersedia.
10. Pilih Rentang tanggal/waktu, lalu masukkan rentang waktu yang diinginkan untuk memeriksa kegagalan. Misalnya, masukkan:
    • Tanggal Mulai: Pilih 2020-12-16
    • Dari Waktu: Pilih 04:00:00 PM
    • Hingga Saat Ini: Pilih 2019-12-16
    • Waktu Ke Waktu: Pilih 05:00:00 PM
    Beberapa filter digabungkan menggunakan kondisi DAN secara default.
    • Klik Terapkan.

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

Lihat pengecualian stack trace

Untuk melihat daftar pengecualian, klik pesan log apa 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 dari tugas konektor yang gagal disimpan menggunakan Cloud Logging dan dapat dilihat di Logs Explorer.

Catatan: Data log tugas konektor yang gagal tersedia di Logs Explorer hanya jika Cloud Logging diaktifkan untuk masing-masing koneksi di Integration Connectors. Baca Melihat log konektor untuk mengetahui 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 dari eksekusi yang gagal, dan stack trace ke baris yang berisi tugas Connector yang gagal.
3. Di kolom Status, klik Gagal.

   

Integrasi Apigee secara 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 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 Apigee, lihat Pengantar log.