All Products
Search

This Product

    API Gateway:Lihat log panggilan API dengan Simple Log Service

    Document Center

    API Gateway:Lihat log panggilan API dengan Simple Log Service

    Last Updated:Jun 22, 2026

    API Gateway terintegrasi secara mulus dengan Simple Log Service (SLS). Anda dapat menggunakan SLS untuk mengkueri log secara real time, mengunduhnya, serta melakukan analisis statistik multidimensi. Log juga dapat dikirimkan ke Object Storage Service (OSS) atau MaxCompute.

    • 500 MB pertama data log yang diproses oleh Simple Log Service setiap bulan gratis. Untuk detail harga, lihat harga Simple Log Service.

    Fitur

    Kueri log online

    Fitur ini berguna untuk troubleshooting dan analisis statistik.

    Log panggilan terperinci

    Log berisi bidang-bidang berikut: Bidang requestQueryString, requestHeaders, requestBody, responseHeaders, dan responseBody hanya tersedia untuk dedicated instance dan harus diaktifkan pada halaman detail grup.

    Parameter

    Deskripsi

    apiGroupUid

    ID grup API.

    apiGroupName

    Nama grup API.

    apiUid

    ID API.

    apiName

    Nama API.

    apiStageUid

    ID lingkungan.

    apiStageName

    Nama lingkungan.

    httpMethod

    Metode HTTP yang digunakan untuk panggilan.

    path

    Jalur permintaan.

    domain

    Nama domain yang digunakan untuk panggilan.

    statusCode

    Kode status HTTP.

    errorMessage

    Pesan kesalahan.

    appId

    ID aplikasi pemanggil.

    appName

    Nama aplikasi pemanggil.

    clientIp

    Alamat IP klien.

    exception

    Pesan kesalahan spesifik dari layanan backend.

    exchangeTimestamp

    Timestamp peristiwa I/O dalam siklus hidup permintaan.

    • FrontRequestStart: Waktu saat API Gateway mulai menerima permintaan klien.

    • FrontRequestEnd: Waktu saat API Gateway selesai menerima permintaan klien.

    • BackendRequestStart: Waktu saat API Gateway mulai mengirim permintaan ke layanan backend.

    • BackendRequestEnd: Waktu saat API Gateway selesai mengirim permintaan ke layanan backend.

    • BackendResponseStart: Waktu saat API Gateway mulai menerima respons dari layanan backend.

    • BackendResponseEnd: Waktu saat API Gateway selesai menerima respons dari layanan backend.

    • FrontResponseStart: Waktu saat API Gateway mulai mengirim respons ke klien.

    • FrontResponseEnd: Waktu saat API Gateway selesai mengirim respons ke klien.

    providerAliUid

    ID akun penyedia API.

    region

    Wilayah. Contoh: cn-hangzhou.

    requestHandleTime

    Waktu permintaan (UTC).

    requestId

    ID permintaan unik global.

    requestSize

    Ukuran permintaan dalam byte.

    responseSize

    Ukuran respons dalam byte.

    serviceLatency

    Total waktu yang dihabiskan untuk mengakses sumber daya backend, termasuk mengalokasikan sumber daya koneksi, membangun koneksi, dan memanggil layanan backend. Satuan: milidetik.

    errorCode

    Kode kesalahan. Contoh: X500ER.

    requestProtocol

    Protokol permintaan klien. Nilai yang valid: HTTP, HTTPS, dan WS.

    instanceId

    ID instans tempat layanan API berjalan.

    initialRequestId

    Jika satu API memanggil API lain (misalnya, API-1 memanggil API-2), bidang ini mencatat ID permintaan panggilan pertama (API-1) dalam log panggilan kedua (API-2).

    clientNonce

    Header X-Ca-Nonce dari permintaan klien.

    requestQueryString

    String kueri dari permintaan klien (hanya untuk dedicated instance).

    requestHeaders

    Header dari permintaan klien (hanya untuk dedicated instance).

    requestBody

    Isi permintaan klien, hingga 1.024 byte (hanya untuk dedicated instance).

    responseHeaders

    Header dari respons API (hanya untuk dedicated instance).

    responseBody

    Isi respons API, hingga 1.024 byte (hanya untuk dedicated instance).

    consumerAppKey

    AppKey dari permintaan API.

    totalLatency

    Total latensi permintaan API dalam milidetik.

    customTraceId

    ID jejak dari log end-to-end.

    jwtClaims

    Claim yang diurai dari JSON Web Token (JWT). Anda dapat mengonfigurasi ini di pengaturan grup API.

    plugin

    Daftar plug-in yang cocok dengan permintaan API dan konteks terkaitnya.

    Lihat log API dengan Simple Log Service

    Metode konfigurasi

    Tersedia dua metode konfigurasi:

    1. Gunakan fitur Log Audit di konsol SLS untuk menyinkronkan log API Gateway. Dengan metode ini, log dari semua wilayah dikumpulkan ke dalam proyek Log Audit tanpa memerlukan konfigurasi tambahan di API Gateway.

    2. Konfigurasikan data ingestion untuk API Gateway di konsol SLS. Dengan metode ini, Anda harus mengonfigurasi sinkronisasi sekali untuk setiap wilayah.

    Bagian berikut menjelaskan kedua metode tersebut.

    Catatan

    Untuk Alibaba Gov Cloud dan Alibaba Finance Cloud, Anda hanya dapat menyinkronkan log SLS dengan menggunakan metode pertama.

    Menggunakan Log Audit

    1. Buka halaman konfigurasi Log Audit Service dan pilih wilayah pusat, tempat semua log API Gateway selanjutnya akan dikirimkan.

      Bagian atas halaman Global Configurations menampilkan wilayah dan nama proyek pusat. Di bawahnya, sebuah tabel menampilkan item konfigurasi untuk produk cloud seperti ActionTrail, Object Storage Service (OSS), RDS, Virtual Private Cloud (VPC), DNS, PolarDB, Server Load Balancer (SLB), dan Application Load Balancer (ALB). Item-item tersebut mencakup sakelar pengumpulan log, Storage Mode (Centralized atau By Region), periode retensi, Sync To Center, dan Archive After N Days. Aktifkan sakelar pengumpulan log untuk produk cloud yang diperlukan, lalu klik Save di pojok kanan atas. Di bagian Collection and Synchronization Authorization, jika muncul pesan bahwa akun tidak memiliki otorisasi untuk mengumpulkan dan menyinkronkan log, lengkapi otorisasi dengan menggunakan manual authorization atau Authorize with AccessKey.

    2. Pilih metode otorisasi dan ikuti petunjuk di layar. Contoh ini menggunakan otorisasi manual.

    3. Setelah otorisasi selesai, log panggilan API Gateway tersedia di penyimpanan log apigateway_log dalam proyek pusat.

      Log panggilan API Gateway mencakup bidang seperti apiGroupName, apiGroupUid, apiName, apiStageName, apiStageUid, dan apiUid. Anda dapat melihat pasangan kunci-nilai terperinci untuk setiap entri log pada tab Raw Logs.

    Konfigurasi di konsol API Gateway

    1) Pastikan Anda telah mengaktifkan SLS. Kemudian, login ke konsol SLS, pilih wilayah target, dan buat proyek serta penyimpanan log. Contoh ini menggunakan wilayah China (Hangzhou).

    Dalam kotak dialog Create Project, masukkan Project Name (misalnya, gateway-t***), pertahankan resource group default, dan pilih preferensi Anda di bagian Enable Logging for, seperti Operation Log dan Global Log. Lalu, klik OK. Setelah proyek dibuat, klik Create Logstore di kotak dialog yang muncul. Saat membuat penyimpanan log, konfigurasikan pengaturannya. Misalnya, atur Nama Penyimpanan Log menjadi gateway_log, Jenis menjadi Standard, Mode Penagihan menjadi Pay-By-Data-Written, Periode Retensi Data menjadi 30 hari, dan Jumlah Shard menjadi 2. Aktifkan Auto Split Shard (maksimal 64 shard) dan Log Public IP, lalu klik OK. Di kotak dialog konfirmasi akhir, klik Data Import Wizard.

    2) Konfigurasikan data ingestion API Gateway dan pilih produk API Gateway.

    Setelah Anda memilih API Gateway, halaman Data Source Configuration akan muncul. Pastikan RAM authorization telah selesai (halaman menampilkan "You have authorized Log Service to distribute logs"). Di bagian Create Distribution Rule, pastikan log akses API Gateway diimpor ke penyimpanan log tujuan, lalu klik Next. Lanjutkan mengklik Next hingga langkah-langkah berikutnya selesai untuk menyelesaikan konfigurasi.

    Lihat log

    Login ke konsol SLS untuk melihat log dan mencari log panggilan menggunakan sintaks kueri SLS.

    Dalam hasil kueri, setiap entri log berisi bidang seperti apiGroupName, apiGroupUid, apiName, __source__, __tag__:__receive_time__, dan __topic__. Anda dapat menyaring log berdasarkan bidang di panel Quick Analysis di sebelah kiri, atau gunakan sintaks kueri di kotak pencarian di bagian atas untuk pencarian yang lebih tepat.

    Menyesuaikan laporan kueri

    Anda dapat menyesuaikan laporan kueri sesuai kebutuhan bisnis Anda. Untuk petunjuknya, lihat Buat dashboard.