Lihat konektor yang didukung untuk Application Integration.

Lihat log eksekusi di Application Integration

Application Integration 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 Application Integration, lihat Pengantar log.

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 gambar yang menampilkan ikon untuk log eksekusiLihat log eksekusi untuk integrasi ini. Halaman Execution Logs akan muncul.
  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 halaman Execution Logs Integrasi Aplikasi.

    gambar yang menampilkan halaman Application Integration Execution Logs gambar yang menampilkan halaman Application Integration Execution Logs

    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.
    • 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, Application Integration 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 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 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.

  3. 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 Aplikasi.

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.

gambar yang menunjukkan error pengecualian log diperluas gambar yang menunjukkan error pengecualian log diperluas

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.

Lakukan langkah-langkah berikut untuk mengakses data log tugas konektor yang gagal dari Application Integration:

  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.

    gambar yang menunjukkan log tugas konektor yang gagal gambar yang menunjukkan log tugas konektor yang gagal

  4. Integrasi Aplikasi akan otomatis menjalankan kueri yang diperlukan untuk tugas konektor yang gagal dan membuka halaman Logs Explorer untuk menampilkan data log eksekusi 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 Application Integration, lihat Pengantar log.