Membuat log log akses Apigee

Halaman ini berlaku untuk Apigee, tetapi tidak untuk Apigee Hybrid.

Baca dokumentasi Apigee Edge.

Pelanggan Langganan Apigee dan Bayar sesuai penggunaan dapat mengaktifkan log akses masuk Cloud Logging untuk setiap instance Apigee di organisasi mereka. Setelah diaktifkan, fitur ini memungkinkan Anda melihat log yang dihasilkan oleh gateway masuk di infrastruktur Apigee, seperti Load Balancer Aplikasi eksternal atau gateway Anthos, untuk membantu memecahkan masalah panggilan API Apigee.

Penting untuk diperhatikan bahwa jika fitur ini diaktifkan untuk satu atau beberapa instance Apigee, Anda akan dikenai biaya untuk log yang dikirimkan ke project Anda. Untuk mengetahui informasi selengkapnya tentang biaya Google Cloud untuk logging, lihat harga Cloud Logging.

Topik ini menjelaskan cara pelanggan Apigee dapat mengaktifkan dan menggunakan log akses masuk Cloud Logging untuk instance Apigee di organisasi mereka.

Sebelum memulai

Untuk mengaktifkan fitur ini, Anda harus memiliki peran dan izin berikut:

• Peran: Admin Organisasi Apigee (roles/apigee.admin)
• Izin:
  • apigee.instances.create
  • apigee.instances.update

Mengaktifkan logging akses masuk untuk instance Apigee

Anda dapat mengaktifkan logging akses masuk Cloud Logging saat membuat atau mengedit instance Apigee menggunakan UI Apigee di Cloud Console atau API.

Untuk mengaktifkan fitur ini saat membuat atau mengupdate instance Apigee, ikuti petunjuk dalam Mengelola instance untuk mulai membuat atau mengedit instance.

curl "http://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{ 
      "name": "INSTANCE_NAME",
      "accessLoggingConfig": 
        { 
          "enabled": "true", 
          "filter": "status_code >= 0 && status_code < 600 " 
        }
      }'

Setelah instance berhasil dibuat atau diupdate, log akses masuk untuk instance tersebut akan tersedia di project Anda dalam hitungan menit.

Melihat log akses masuk

Setelah fitur ini diaktifkan, Anda dapat melihat log akses masuk untuk instance di project dalam hitungan menit menggunakan Logs Explorer di Konsol Google Cloud.

Untuk melihat entri log di Logs Explorer:

1. Di konsol Google Cloud, pilih Logging > Logs Explorer.

   Buka Logs Explorer

2. Pastikan project Google Cloud Anda dipilih.
3. Dari tab Query, masukkan nama log ke dalam kolom editor Query menggunakan salah satu metode berikut:
   • Untuk menggunakan kotak pilihan Log name:
     1. Klik kotak pilihan Log name untuk membuka panel Log name.
     2. Masukkan ingress_instance di kotak Select log names.
     3. Klik Terapkan.
     4. Nama log akan muncul di kolom editor Query.
   • Di kolom editor Query, masukkan nama log secara langsung:

     logName="projects/ORG_NAME/logs/apigee.googleapis.com/ORG_NAME"

     dengan ORG_NAME adalah nama organisasi Apigee Anda.

4. Buat kueri lainnya di kolom editor Query. Log akan muncul di daftar Query results.
5. Klik entri log mana pun untuk mengetahui detail selengkapnya.

Memecahkan masalah dengan log akses masuk

Setelah fitur diaktifkan dan log tersedia di Logs Explorer, Anda dapat memanfaatkan sejumlah fitur Cloud Logging untuk membantu pemecahan masalah, termasuk:

• Membangun kueri menggunakan bahasa kueri Cloud Logging

  Anda dapat mengambil dan menganalisis log saat menggunakan Logs Explorer dengan menulis kueri di kolom editor kueri dan dengan menentukan pilihan dari opsi menu filter yang disertakan dengan entri log. Untuk mempelajari lebih lanjut cara membangun kueri dan menganalisis data di Logs Explorer, lihat Membuat dan menyimpan kueri menggunakan bahasa kueri Cloud Logging.

• Mengaktifkan pemberitahuan dan metrik berbasis log

  Anda dapat menentukan metrik berbasis log sendiri untuk mengambil informasi yang spesifik untuk instance Apigee Anda. Untuk mengetahui informasi selengkapnya, lihat Ringkasan metrik berbasis log.

  Anda dapat membuat kebijakan pemberitahuan berbasis log dari Logs Explorer. Untuk mengetahui informasi selengkapnya dan langkah-langkah mendetail, lihat Membuat kebijakan pemberitahuan berbasis log dengan menggunakan Logs Explorer.

• Pemfilteran menurut kode status HTTP

  Anda dapat menyaring kueri di Logs Explorer untuk memfilter menurut kode status HTTP, meskipun Anda tidak memilih untuk memfilter log akses masuk menurut kode status HTTP saat mengaktifkan fitur. Untuk menambahkan filter ini ke kueri Anda, gunakan format berikut:

  status_code > XX && status code <= YY

  Contoh:

  status_code >= 500 && status_code < 504

• Memfilter menurut kode status masuk

  Selain memfilter berdasarkan kode status HTTP, Anda dapat membuat kueri untuk memfilter ingress status_code 0. Kode ini sering menunjukkan masalah jaringan atau konektivitas yang mencegah klien menerima respons server.

Untuk penjelasan mendetail mengenai semua fungsi yang tersedia di Logs Explorer, lihat Melihat log menggunakan Logs Explorer.

Nonaktifkan fitur

Setelah selesai memecahkan masalah instance Apigee, Anda dapat mengedit instance untuk menonaktifkan fitur tersebut. Menonaktifkan fitur ini akan menonaktifkan akses ke log ingress_instance di project Anda dan akan menghentikan penagihan.

Anda dapat mengedit instance untuk menonaktifkan fitur menggunakan UI Apigee di Cloud Console atau API.

curl "http://apigee.googleapis.com/v1/organizations/ORG_NAME/instances/INSTANCE_NAME?updateMask=access_logging_config.enabled,access_logging_config.filter" \
    -X PATCH -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' -H 'Content-Type: application/json' \
    -d '{ 
      "name": "INSTANCE_NAME",
      "accessLoggingConfig": 
        { 
            "enabled": "false" 
        }
        }'