Memantau penggunaan API

Halaman ini menjelaskan cara menggunakan metrik API untuk melacak dan memahami penggunaan Anda atas Google API dan Google Cloud API.

Google API menghasilkan metrik penggunaan mendetail yang dapat membantu Anda:

• Melacak dan memahami penggunaan Google API Anda.
• Pantau performa aplikasi dan Google API Anda.
• Temukan masalah antara aplikasi Anda dan Google API.

Hal ini dapat mempercepat waktu penyelesaian masalah secara signifikan saat Anda memecahkan masalah atau memerlukan dukungan teknis dari Google.

Metrik yang dihasilkan Google API adalah sinyal standar yang digunakan oleh Engineer Keandalan Situs (SRE) Google sendiri untuk menilai keandalan layanan. Metrik ini mencakup jumlah permintaan, tingkat error, total latensi, latensi backend, ukuran permintaan, dan ukuran respons. Untuk definisi metrik API, lihat dokumentasi Cloud Monitoring.

Anda dapat melihat metrik API di dua tempat: Dasbor API dan Cloud Monitoring. Metrik yang Anda lihat khusus untuk project Anda, dan tidak mencerminkan status layanan secara keseluruhan.

Menggunakan Dasbor API

Cara termudah untuk melihat metrik API adalah dengan menggunakan Dasbor API di konsol Google Cloud. Anda dapat melihat ringkasan semua penggunaan API, atau melihat perincian penggunaan API tertentu.

Untuk melihat ringkasan penggunaan API Anda:

1. Buka bagian APIs and Services di Konsol Cloud. Dasbor API utama ditampilkan secara default. Di halaman ini, Anda dapat melihat semua API yang saat ini diaktifkan untuk project Anda, serta diagram ringkasan untuk metrik berikut:

   • Traffic: jumlah permintaan per detik yang dibuat oleh atau tentang project Anda ke API yang diaktifkan
   • Error: persentase permintaan ke API yang diaktifkan yang mengakibatkan error
   • Latensi median: latensi median untuk permintaan ke API yang diaktifkan, jika tersedia".

Untuk melihat detail penggunaan API tertentu:

1. Pilih API yang ingin Anda lihat di daftar API Dashboard API utama. Halaman Ringkasan API menampilkan diagram traffic yang lebih mendetail dengan perincian menurut kode respons.

2. Untuk informasi penggunaan yang lebih mendetail, pilih Lihat metrik. Secara default, diagram bawaan berikut ditampilkan, meskipun ada lebih banyak diagram yang tersedia:

   • Traffic menurut kode respons
   • Error menurut metode API
   • Latensi keseluruhan pada persentil ke-50, ke-95, dan ke-99
   • Latensi menurut metode API (median)

3. Jika ingin menambahkan lebih banyak diagram, Anda dapat memilih diagram bawaan tambahan dari menu drop-down Pilih Grafik.

Menggunakan Cloud Monitoring

Jika menggunakan Cloud Monitoring, Anda dapat mempelajari data metrik yang tersedia lebih dalam menggunakan Metrics Explorer untuk mendapatkan insight yang lebih baik tentang penggunaan API Anda. Cloud Monitoring mendukung berbagai metrik, yang dapat digabungkan dengan filter dan agregasi untuk tampilan baru yang bermakna terkait performa aplikasi Anda. Misalnya, Anda dapat menggabungkan metrik jumlah permintaan dengan filter pada class Kode Respons HTTP untuk membuat dasbor yang menunjukkan tingkat error dari waktu ke waktu, atau Anda dapat melihat latensi persentil ke-95 permintaan ke Cloud Pub/Sub API.

Metrik yang tersedia

Tabel berikut mencantumkan metrik serviceruntime yang tersedia. Metrik penggunaan API adalah metrik yang menyertakan consumed_api sebagai resource yang dimonitor.

String "jenis metrik" dalam tabel ini harus diawali dengan serviceruntime.googleapis.com/. Awalan tersebut telah dihilangkan dari entri dalam tabel. Saat membuat kueri label, gunakan awalan metric.labels.; misalnya, metric.labels.LABEL="VALUE".

Jenis metrik Tahap peluncuran (Tingkat hierarki resource) Nama tampilan
Jenis, Tipe, Unit Resource yang dimonitor	Deskripsi Label
api/request_count GA  (project) Jumlah permintaan
DELTA, INT64, 1 api consumed_api produced_api	Jumlah permintaan yang selesai. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik. protocol: Protokol permintaan, misalnya "http", "grpc". response_code: Kode respons HTTP untuk permintaan HTTP, atau kode yang setara dengan HTTP untuk permintaan gRPC. Lihat pemetaan kode di https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto. response_code_class: Class kode respons untuk permintaan HTTP, atau class yang setara dengan HTTP untuk permintaan gRPC, misalnya "2xx", "4xx". grpc_status_code: Kode respons gRPC numerik untuk permintaan gRPC, atau kode yang setara dengan gRPC untuk permintaan HTTP. Lihat pemetaan kode di https://github.com/googleapis/googleapis/blob/master/google/rpc/code.proto.
api/request_latencies GA  (project) Latensi permintaan
DELTA, DISTRIBUTION, s api consumed_api produced_api	Distribusi latensi dalam detik untuk permintaan non-streaming. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik.
api/request_latencies_backend GA  (project) Meminta latensi backend
DELTA, DISTRIBUTION, s api produced_api	Distribusi latensi backend dalam detik untuk permintaan non-streaming. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik.
api/request_latencies_overhead GA  (project) Latensi overhead permintaan
DELTA, DISTRIBUTION, s api produced_api	Distribusi latensi permintaan dalam hitungan detik untuk permintaan non-streaming, tidak termasuk backend. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik.
api/request_sizes GA  (project) Ukuran permintaan
DELTA, DISTRIBUTION, By api consumed_api produced_api	Distribusi ukuran permintaan dalam byte yang dicatat saat permintaan selesai. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik.
api/response_sizes GA  (project) Ukuran respons
DELTA, DISTRIBUTION, By api consumed_api produced_api	Distribusi ukuran respons dalam byte yang dicatat saat permintaan selesai. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 1.800 detik.
mcp/request_count BETA  (project) Jumlah Permintaan MCP
DELTA, INT64, 1 consumed_mcp_api	Jumlah permintaan MCP. response_code: Kode respons HTTP untuk permintaan HTTP, atau kode yang setara dengan HTTP untuk permintaan MCP. response_code_class: Class kode respons untuk permintaan HTTP, atau class yang setara dengan HTTP untuk permintaan gRPC, misalnya '2xx', '4xx'.
mcp/request_durations BETA  (project) Durasi Permintaan MCP
DELTA, DISTRIBUTION, s consumed_mcp_api	Durasi permintaan MCP dari saat dikirim hingga respons atau ACK diterima.
quota/allocation/usage GA  (project, folder, organization) Penggunaan kuota alokasi
GAUGE, INT64, 1 consumer_quota producer_quota	Total kuota alokasi yang digunakan. Nilai yang dilaporkan lebih dari 1/menit akan dihilangkan. Jika tidak ada perubahan yang diterima dalam penggunaan kuota, nilai terakhir akan diulang setidaknya setiap 24 jam. Dibuat sampelnya setiap 60 detik. quota_metric: Nama metrik kuota atau grup kuota.
quota/concurrent/exceeded ALPHA  (project, folder, organization) Concurrent Quota Exceeded
DELTA, INT64, 1 consumer_quota	Jumlah upaya yang melebihi kuota serentak. Sampelnya dibuat setiap 86.400 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota. time_window: Ukuran periode untuk batas operasi serentak.
quota/concurrent/limit ALPHA  (project, folder, organization) Batas Kuota Serentak
GAUGE, INT64, 1 consumer_quota producer_quota	Batas serentak untuk kuota. Sampelnya dibuat setiap 86.400 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota. time_window: Ukuran periode untuk batas operasi serentak.
quota/concurrent/usage ALPHA  (project, folder, organization) Penggunaan Kuota Serentak
GAUGE, INT64, 1 consumer_quota producer_quota	Penggunaan kuota secara serentak. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota. time_window: Ukuran periode untuk batas operasi serentak.
quota/exceeded GA  (project, folder, organisasi) Error kuota terlampaui
GAUGE, BOOL, 1 consumer_quota	Error terjadi saat batas kuota terlampaui. Dibuat sampelnya setiap 60 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota.
quota/limit GA  (project, folder, organization) Batas kuota
GAUGE, INT64, 1 consumer_quota producer_quota	Batas untuk kuota. Sampelnya dibuat setiap 86.400 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota.
quota/rate/net_usage GA  (project, folder, organisasi) Penggunaan kuota kecepatan
DELTA, INT64, 1 consumer_quota producer_quota	Total kuota tarif yang digunakan. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 240 detik. method: Nama metode API, seperti "disks.list". quota_metric: Nama metrik kuota atau grup kuota.
quota/ratev2/exceeded BETA  (project, folder, organisasi) Kuota Kecepatan Berjendela Terlampaui
DELTA, INT64, 1 consumer_quota	Jumlah percobaan yang melebihi kuota kecepatan berwindow. Sampelnya dibuat setiap 86.400 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota. window_size: Ukuran periode untuk batas operasi kecepatan.
quota/ratev2/limit BETA  (project, folder, organisasi) Batas Kuota Kecepatan Berjendela
GAUGE, INT64, 1 consumer_quota producer_quota	Batas frekuensi berjendela untuk kuota. Sampelnya dibuat setiap 86.400 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. limit_name: Nama batas kuota, seperti "Permintaan per hari" atau "Alamat IP yang digunakan". quota_metric: Nama metrik kuota atau grup kuota. window_size: Ukuran periode untuk batas operasi kecepatan.
quota/ratev2/net_usage BETA  (project, folder, organisasi) Penggunaan Kuota Tingkat Berjendela
GAUGE, INT64, 1 consumer_quota producer_quota	Penggunaan kuota tarif berjangka waktu. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 240 detik. method: Nama metode API, seperti "disks.list". limit_name: Nama batas kuota, seperti "RequestsPerDay" atau "InUseIpAddresses". quota_metric: Nama metrik kuota atau grup kuota. window_size: Ukuran periode untuk batas operasi kecepatan. window_start_time: Waktu mulai periode.
reserved/metric1 EARLY_ACCESS  (project) Tidak digunakan lagi
DELTA, INT64, 1 deprecated_resource	Tidak digunakan lagi. Dibuat sampelnya setiap 60 detik. Setelah sampelnya dibuat, data tidak akan terlihat selama maksimal 180 detik. quota_name: Tidak digunakan lagi. credential_id: Tidak digunakan lagi. quota_location: Tidak digunakan lagi.

Tabel dihasilkan pada 2026-06-24 20:26:54 UTC.

Untuk melihat metrik API di Metrics Explorer, pilih Consumed API sebagai jenis resource, lalu pilih salah satu metrik serviceruntime. Kemudian, gunakan opsi filter dan agregasi untuk menyaring data Anda. Setelah menemukan informasi penggunaan API yang diinginkan, Anda dapat menggunakan Cloud Monitoring untuk membuat dasbor dan pemberitahuan kustom yang akan membantu Anda terus memantau dan memelihara aplikasi yang tangguh. Anda dapat mengetahui cara melakukannya di halaman berikut:

• Membuat diagram
• Pengantar pemberitahuan
• Mengelola kebijakan pemberitahuan

Untuk mengetahui informasi selengkapnya, lihat Metrics Explorer.

Memecahkan masalah dengan metrik API

Metrik API dapat sangat berguna jika Anda perlu menghubungi Google saat terjadi masalah, dan bahkan dapat menunjukkan bahwa Anda tidak perlu menghubungi dukungan sama sekali. Contoh:

• Jika semua panggilan Anda ke layanan gagal untuk satu ID kredensial, tetapi tidak untuk ID kredensial lainnya, kemungkinan ada masalah dengan akun tersebut yang dapat Anda perbaiki sendiri dengan mudah tanpa membuka tiket.
• Anda sedang memecahkan masalah pada aplikasi, dan melihat korelasi antara penurunan performa aplikasi dan peningkatan berkelanjutan pada latensi persentil ke-50 dari layanan GCP penting. Sebaiknya hubungi kami dan tunjukkan data ini kepada kami agar kami dapat mulai mengatasi masalahnya secepat mungkin.
• Latensi untuk laporan layanan GCP terlihat baik dan tidak berubah dari sebelumnya, tetapi metrik dalam aplikasi Anda melaporkan bahwa latensi pada panggilan ke layanan tersebut sangat tinggi. Hal ini menunjukkan bahwa ada masalah di jaringan. Hubungi penyedia jaringan Anda (dalam beberapa kasus, Google) untuk memulai proses pen-debug-an.

Praktik terbaik

Meskipun metrik API adalah alat yang sangat berguna, ada masalah yang perlu Anda pertimbangkan untuk memastikan metrik tersebut memberikan informasi yang berguna, terutama saat menyiapkan pemberitahuan berdasarkan nilai metrik. Praktik terbaik berikut akan membantu Anda mendapatkan hasil maksimal dari data metrik API.

Apakah latensi menyebabkan masalah?

Meskipun beberapa layanan cukup sensitif terhadap latensi, untuk layanan lainnya, skala dan keandalan lebih penting. Beberapa API, misalnya Cloud Storage atau BigQuery, dapat memiliki latensi tinggi selama beberapa detik tanpa disadari pelanggan. Dengan data dari metrik API, Anda dapat mempelajari apa yang dibutuhkan pengguna dari layanan tertentu.

Mencari perubahan dari kebiasaan

Sebelum Anda memutuskan untuk memberikan pemberitahuan tentang nilai metrik tertentu, pertimbangkan apa yang sebenarnya dihitung sebagai perilaku tidak biasa. Melihat metrik API dapat menunjukkan bahwa hasil latensi untuk sebagian besar layanan berada dalam distribusi normal: tonjolan besar di tengah, dan pencilan di kedua sisi. Metrik ini akan membantu Anda memahami distribusi normal sehingga Anda dapat merekayasa aplikasi agar berfungsi dengan baik dalam kurva distribusi. Metrik juga dapat membantu Anda mengorelasikan perubahan distribusi dengan waktu saat aplikasi Anda tidak berfungsi sebagaimana mestinya, untuk membantu Anda menemukan penyebab utama masalah. Kami memperkirakan persentil ke-99 akan terlihat sangat berbeda dengan median. Namun, kami tidak memperkirakan adanya perubahan dramatis pada persentil tersebut dari waktu ke waktu.

Anda juga dapat melihat bahwa beberapa jenis permintaan memerlukan waktu lebih lama daripada yang lain. Jika ukuran median foto yang diupload ke Google Foto adalah 4 MB, tetapi Anda biasanya mengupload file RAW 20 MB, rata-rata waktu untuk mengupload 20 foto kemungkinan akan jauh lebih buruk daripada kebanyakan pengguna, tetapi masih merupakan perilaku normal Anda.

Semua ini berarti tidak terlalu berguna untuk memberikan peringatan saat panggilan RPC satu detik atau panggilan HTTP 5xx terdeteksi untuk pertama kalinya. Sebagai gantinya, saat menyelidiki layanan Google sebagai kemungkinan penyebab masalah yang dialami aplikasi Anda, bandingkan kode yang ditampilkan dan tingkat latensi dari waktu ke waktu dan cari perubahan berkelanjutan dari norma yang berkorelasi dengan masalah yang diamati di aplikasi Anda.

Tarif traffic

Metrik API paling berguna jika Anda memiliki volume traffic yang tinggi yang menuju ke API. Jika Anda memanggil layanan hanya sesekali, metrik API Anda tidak akan valid secara statistik dan tidak akan memberikan informasi triase yang bermakna.

Misalnya, jika Anda ingin melacak latensi persentil ke-99,5 untuk suatu layanan, dan Anda hanya melakukan 100 panggilan per jam, memantau pengukuran selama dua jam hanya akan memberi Anda satu titik data untuk merepresentasikan persentil ke-99,5, yang tidak akan memberi tahu Anda banyak hal tentang perilaku normal API atau aplikasi Anda. Pastikan rasio traffic, persentil yang Anda lacak, dan jangka waktu yang Anda pertimbangkan menghasilkan banyak titik data yang menarik atau data pemantauan tidak akan berguna bagi Anda.

API yang didukung

Semua Google API dan Google Cloud API, serta API yang dibangun di atas Cloud Endpoints dan Gateway API, mendukung metrik API. Jika Anda adalah konsumen API, Anda dapat melihat metrik API yang Digunakan di Dasbor API. Jika Anda adalah produsen API, Anda dapat melihat metrik API yang Diproduksi di Dasbor Endpoint.