全部产品
Search

搜索本产品

    API Gateway：Aktifkan pengiriman log untuk gerbang

    文档中心

    API Gateway：Aktifkan pengiriman log untuk gerbang

    更新时间：Nov 10, 2025

    Fitur pengiriman log untuk AI Gateway menggunakan Alibaba Cloud Simple Log Service (SLS). Setelah Anda mengaktifkan pengiriman log, Anda dapat menganalisis log akses AI Gateway untuk memahami perilaku pengguna dan distribusi geografis guna pemecahan masalah. Topik ini menjelaskan cara mengaktifkan pengiriman log untuk AI Gateway.

    Prasyarat

    Aktifkan pengiriman log

    Catatan

    Produk AI tidak membebankan biaya untuk log. Namun, Simple Log Service (SLS) akan menagih Anda berdasarkan penggunaan. Untuk informasi lebih lanjut tentang metode penagihan SLS, lihat Bayar sesuai pemakaian.

    2. AI Gateway menyediakan dua metode untuk mengaktifkan pengiriman log:

      Metode 1: Gunakan Pusat Log

      1. Pada panel navigasi di sebelah kiri, klik Observability > Log Center.

      2. Klik Enable Log Delivery. Pada kotak dialog Enable Log Delivery, pilih Use Default atau Use Existing untuk Proyek SLS, lalu klik OK.

      Metode 2: Gunakan konfigurasi parameter

      1. Pada panel navigasi di sebelah kiri, klik Parameter Configuration.

      2. Pada area Observability Parameters, klik ikon 1 di sebelah kanan Access Log Delivery Configuration. Pada kotak dialog Access Log Delivery Configuration, aktifkan Gateway Access Log (AccessLog).

      3. Aktifkan Output Logs Compatible With Nginx Ingress Format. Hal ini memastikan bahwa log keluaran memiliki format yang sama dengan log Nginx Ingress, sehingga menyederhanakan analisis log dan meningkatkan kompatibilitas lintas sistem.

      4. Pilih Use Default atau Use Existing untuk Proyek SLS, lalu klik OK.

      Catatan

      Jika Anda memilih Use Default, Simple Log Service akan membuat proyek default untuk Anda.

      Setelah Anda mengaktifkan pengiriman log, buka bagian Observability Parameters. Klik tautan di sebelah kanan Project untuk membuka Logstore untuk gerbang tersebut. Untuk informasi selengkapnya, lihat Panduan cepat untuk kueri dan analisis.

    Bidang log

    Tabel berikut menjelaskan bidang-bidang dalam log akses gerbang.

    Nama bidang

    Tipe

    Deskripsi

    __time__

    long

    Waktu saat log dihasilkan.

    cluster_id

    string

    Instans gerbang yang dibeli.

    ai_log

    json

    Bidang log yang dirancang untuk Model API, Agent API, dan MCP API. Bidang ini dalam format JSON. Bidang ini kosong untuk jenis API lainnya.

    • api: Nama API AI.

    • cache_status: Jika caching konten diaktifkan untuk Model API, bidang ini menunjukkan apakah permintaan mengenai cache.

    • consumer: Jika autentikasi konsumen diaktifkan, bidang ini mencatat identitas konsumen untuk permintaan saat ini.

    • fallback_from: Jika kebijakan fallback diaktifkan untuk Model API, bidang ini mencatat rute dari mana permintaan dialihkan.

    • input_token: Jumlah token input dalam permintaan LLM.

    • llm_first_token_duration: Waktu respons (RT) paket pertama dari permintaan LLM.

    • llm_service_duration: RT keseluruhan dari permintaan LLM.

    • model: Nama model dalam permintaan LLM.

    • output_token: Jumlah token output dalam permintaan LLM.

    • response_type: Jenis respons dari permintaan LLM, seperti streaming atau non-streaming.

    • safecheck_status: Status Moderasi Konten dari permintaan LLM.

    • token_ratelimit_status: Menunjukkan apakah permintaan LLM diblokir oleh pembatasan laju berbasis token.

    authority

    string

    Header Host dalam pesan permintaan.

    bytes_received

    long

    Ukuran badan permintaan, tidak termasuk header.

    bytes_sent

    long

    Ukuran badan respons, tidak termasuk header.

    downstream_local_address

    string

    Alamat pod gerbang.

    downstream_remote_address

    string

    Alamat klien yang terhubung ke gerbang.

    duration

    long

    Total waktu yang diperlukan untuk memproses permintaan. Ini adalah periode mulai dari saat gerbang menerima byte pertama dari layanan downstream hingga mengirim byte terakhir dari respons. Satuan: milidetik.

    method

    string

    Metode HTTP.

    path

    string

    Jalur dalam permintaan HTTP.

    protocol

    string

    Versi protokol HTTP.

    request_duration

    long

    Periode mulai dari saat gerbang menerima byte pertama dari layanan downstream hingga menerima byte terakhir dari layanan downstream. Satuan: milidetik.

    request_id

    string

    Gerbang menghasilkan ID untuk setiap permintaan dan menyertakannya dalam header x-request-id. Backend dapat menggunakan bidang ini untuk pencatatan log dan pemecahan masalah.

    requested_server_name

    string

    Nama server yang digunakan untuk koneksi SSL-VPN.

    response_code_details

    string

    Memberikan informasi tambahan tentang kode respons. Misalnya, `via_upstream` menunjukkan bahwa kode respons dikembalikan oleh layanan backend, dan `route_not_found` menunjukkan bahwa tidak ada entri rute yang cocok untuk permintaan tersebut.

    response_tx_duration

    long

    Periode mulai dari saat gerbang menerima byte pertama dari layanan upstream hingga mengirim byte terakhir ke layanan downstream. Satuan: milidetik.

    route_name

    string

    Nama entri rute.

    start_time

    string

    Waktu permintaan dimulai. Format: UTC.

    trace_id

    string

    ID jejak.

    upstream_cluster

    string

    Kluster upstream.

    upstream_host

    string

    Alamat IP upstream.

    upstream_local_address

    string

    Alamat lokal yang digunakan untuk terhubung ke layanan upstream.

    upstream_service_time

    long

    Waktu yang diperlukan oleh layanan upstream untuk memproses permintaan, dalam milidetik. Ini mencakup latensi jaringan untuk akses gerbang ke layanan upstream dan waktu pemrosesan layanan upstream itu sendiri.

    upstream_transport_failure_reason

    string

    Alasan kegagalan koneksi ke layanan upstream.

    user_agent

    string

    Header User-Agent dalam permintaan HTTP.

    x_forwarded_for

    string

    Header x-forwarded-for dalam permintaan HTTP. Header ini biasanya menunjukkan alamat IP asal klien HTTP.

    Alasan kegagalan permintaan

    Nilai bidang Response_Flag dalam log menunjukkan alasan kegagalan permintaan. Daftar berikut menjelaskan nilai-nilai yang mungkin dari Response_Flag.

    Catatan

    Downstream mengacu pada klien, dan upstream mengacu pada layanan backend.

    • UH: Tidak ada host upstream yang sehat dalam kluster upstream.

    • UF: Koneksi upstream gagal.

    • NR: Tidak ada entri rute yang dikonfigurasi untuk permintaan tersebut.

    • URX: Permintaan ditolak karena batas percobaan ulang upstream (HTTP) atau jumlah maksimum upaya koneksi (TCP) telah tercapai.

    • NC: Kluster upstream tidak ditemukan.

    • DT: Permintaan atau koneksi melebihi max_connection_duration atau max_downstream_connection_duration.

    • DC: Koneksi downstream dihentikan.

    • LH: Layanan lokal gagal dalam permintaan pemeriksaan kesehatan.

    • UT: Permintaan upstream mengalami timeout.

    • LR: Koneksi direset secara lokal.

    • UR: Koneksi upstream direset dari jarak jauh.

    • UC: Koneksi upstream dihentikan.

    • DI: Pemrosesan permintaan ditunda selama periode yang ditentukan oleh injeksi kesalahan.

    • FI: Permintaan dibatalkan dengan kode respons yang ditentukan oleh injeksi kesalahan.

    • RL: Permintaan dibatasi lajunya secara lokal oleh filter pembatasan laju HTTP, tetapi kode respons 429 tidak dikembalikan.

    • UAEX: Permintaan ditolak oleh layanan otorisasi eksternal.

    • RLSE: Permintaan ditolak karena terjadi kesalahan pada layanan pembatasan laju.

    • IH: Permintaan ditolak karena nilai yang tidak valid ditetapkan pada header yang diperiksa secara ketat.

    • SI: Timeout idle aliran tercapai.

    • DPE: Terjadi kesalahan protokol HTTP pada permintaan downstream.

    • UPE: Terjadi kesalahan protokol HTTP pada respons upstream.

    • UMSDR: Permintaan upstream mencapai durasi aliran maksimum.

    • OM: Pengelola beban berlebih menghentikan permintaan.