Referensi metrik, dimensi, dan filter Analytics

Halaman ini berlaku untuk Apigee dan Apigee Hybrid.

Lihat dokumentasi Apigee Edge.

Topik ini adalah referensi untuk metrik, dimensi, dan filter analisis. Untuk mengetahui konteks selengkapnya tentang penggunaan ini, lihat Ringkasan Analisis API.

Topik ini menunjukkan nama metrik dan dimensi sebagaimana yang muncul di UI dan sebagaimana yang perlu Anda gunakan dalam panggilan API.

Metrik

Berikut adalah metrik API yang dapat Anda ambil dalam laporan kustom dan panggilan API Apigee.

Metrik Nama yang akan digunakan di Apigee API Functions Deskripsi
Rata-rata transaksi per detik tps Tidak ada

Jumlah rata-rata transaksi, yang berarti permintaan proxy API, per detik. Perhatikan bahwa jika Anda memiliki jumlah transaksi yang relatif rendah selama jangka waktu tersebut, jumlah rata-rata transaksi per detik dapat tampak nol dalam laporan kustom UI jika jumlahnya lebih kecil dari dua tempat desimal.

Sintaksis API: tps

Cache ditemukan cache_hit jumlah

Jumlah permintaan API yang berhasil yang menggunakan ResponseCache, bukan respons dari layanan target.

Sintaksis API: sum(cache_hit)

Jumlah elemen Cache L1 ax_cache_l1_count rata-rata, min, maks

Jumlah elemen dalam cache L1 (dalam memori) per transaksi selama jangka waktu tertentu. Misalnya, jika Anda memilih max untuk jangka waktu satu hari, dan dalam hari tersebut, jumlah elemen tertinggi dalam cache adalah 12 untuk transaksi tertentu, maka jumlahnya adalah 12. Untuk avg, jika ada tiga transaksi dalam jangka waktu yang Anda kueri, dan jumlah cache-nya adalah 5, 6, dan 7, rata-ratanya adalah 6. Cache L1 adalah cache dalam memori, bukan cache database L2, seperti yang dijelaskan dalam Internal cache.

Sintaksis API: avg(ax_cache_l1_count)

Error kebijakan policy_error jumlah

Jumlah total error kebijakan selama jangka waktu tertentu.

Error kebijakan biasanya terjadi karena desain. Misalnya, kebijakan VerifyApiKey akan menampilkan error saat kunci API yang tidak valid diteruskan dalam permintaan, dan kebijakan SpikeArrest akan menampilkan error jika jumlah panggilan API melebihi batas yang ditentukan dalam kebijakan. Jadi, metrik ini berguna untuk menemukan potensi masalah pada API Anda. Misalnya, metrik policy_error, yang dikelompokkan menurut dimensi developer_app, dapat membantu Anda menemukan bahwa kunci API atau token OAuth telah habis masa berlakunya untuk aplikasi tertentu; atau Anda mungkin menemukan bahwa proxy API tertentu memunculkan banyak error kebijakan SpikeArrest, sehingga Anda menemukan bahwa batas penahanan lonjakan proxy tidak memperhitungkan peningkatan traffic selama musim liburan.

Error kebijakan dicatat dalam analisis hanya jika error mengakibatkan kegagalan proxy API. Misalnya, jika atribut continueOnError kebijakan ditetapkan ke true, proxy API akan terus memproses permintaan meskipun kebijakan gagal. Dalam hal ini, error kebijakan tidak dicatat ke dalam log di Analytics.

Dimensi Nama Kebijakan pada Error (ax_execution_fault_policy_name) berguna untuk mengelompokkan error kebijakan menurut nama kebijakan.

Kegagalan target (seperti 404 atau 503) tidak dihitung sebagai kegagalan kebijakan. Kegagalan tersebut dihitung sebagai kegagalan proxy API (is_error).

Sintaksis API: sum(policy_error)

Error proxy is_error jumlah

Jumlah total kegagalan proxy API selama jangka waktu yang ditentukan. Kegagalan proxy dapat terjadi saat kebijakan gagal atau saat terjadi kegagalan runtime, seperti 404 atau 503 dari layanan target.

Dimensi Proxy (apiproxy) berguna untuk mengelompokkan kegagalan proxy API menurut proxy.

Sintaksis API: sum(is_error)

Latensi pemrosesan permintaan request_processing_latency rata-rata, min, maks

Jumlah waktu (rata-rata, minimum, atau maksimum), dalam milidetik, yang diperlukan Apigee untuk memproses permintaan masuk. Waktu dimulai saat permintaan mencapai Apigee dan berakhir saat Apigee meneruskan permintaan ke layanan target.

Dengan menggunakan dimensi yang berbeda, Anda dapat memeriksa latensi pemrosesan permintaan menurut proxy API, aplikasi developer, region, dan sebagainya.

Sintaksis API: max(request_processing_latency)

Ukuran permintaan request_size sum, avg, min, max

Ukuran payload permintaan yang diterima oleh Apigee, dalam byte.

Sintaksis API: avg(request_size)

Cache respons dieksekusi ax_cache_executed jumlah

Jumlah total eksekusi kebijakan ResponseCache selama jangka waktu tertentu.

Karena kebijakan ResponseCache dilampirkan di dua tempat dalam proxy API (sekali dalam permintaan dan sekali dalam respons), kebijakan ini biasanya dieksekusi dua kali dalam panggilan API. Cache GET dan cache PUT masing-masing dihitung sebagai satu eksekusi.

Namun, eksekusi cache respons adalah 0 jika elemen <SkipCacheLookup> dalam kebijakan dievaluasi ke benar (dalam permintaan), dan 0 jika elemen <SkipCachePopulation> dalam kebijakan dievaluasi ke benar (dalam respons).

Di alat Debug, Anda dapat mengklik ikon ResponseCache dalam panggilan API yang dieksekusi dan melihat responsecache.executed variabel alur untuk melihat apakah ada eksekusi cache (nilai 1) atau tidak.

Sintaksis API: sum(ax_cache_executed)

Latensi pemrosesan respons response_processing_latency rata-rata, min, maks

Jumlah waktu (rata-rata, minimum, atau maksimum), dalam milidetik, yang diperlukan Apigee untuk memproses respons API. Waktu dimulai saat proxy API menerima respons layanan target dan berakhir saat Apigee meneruskan respons ke pemanggil asli.

Dengan menggunakan dimensi yang berbeda, Anda dapat memeriksa latensi pemrosesan respons menurut proxy API, region, dan sebagainya.

Sintaksis API: min(response_processing_latency)

Ukuran respons response_size sum, avg, min, max

Ukuran payload respons yang ditampilkan ke klien, dalam byte.

Sintaksis API: max(response_size)

Error target target_error jumlah

Jumlah total respons 5xx dari layanan target. Ini adalah error layanan target yang tidak disebabkan oleh Apigee.

Sintaksis API: sum(target_error)

Waktu respons target target_response_time sum, avg, min, max

Jumlah waktu (jumlah, rata-rata, minimum, atau maksimum), dalam milidetik, agar server target merespons panggilan. Metrik ini memberi tahu Anda performa server target. Waktu dimulai saat Apigee meneruskan permintaan ke layanan target dan berakhir saat Apigee menerima respons.

Perhatikan bahwa jika panggilan API menampilkan respons dari cache (menggunakan kebijakan ResponseCache, misalnya), panggilan tidak akan pernah mencapai layanan target, dan tidak ada metrik waktu respons target yang dicatat.

Sintaksis API: avg(target_response_time)

Total waktu respons total_response_time sum, avg, min, max

Jumlah waktu (jumlah, rata-rata, minimum, atau maksimum), dalam milidetik, dari saat Apigee menerima permintaan dari klien hingga Apigee mengirimkan respons kembali ke klien. Waktu ini mencakup overhead jaringan (seperti waktu yang dibutuhkan load balancer dan router untuk melakukan tugasnya), latensi pemrosesan permintaan, latensi pemrosesan respons, dan waktu respons target (jika respons ditayangkan dari layanan target, bukan dari cache).

Dengan menggunakan dimensi yang berbeda, Anda dapat memeriksa latensi pemrosesan menurut proxy API, aplikasi developer, wilayah, dan sebagainya.

Sintaksis API: avg(total_response_time)

Traffic message_count jumlah

Jumlah total panggilan API yang diproses oleh Apigee dalam jangka waktu yang ditentukan.

Gunakan dimensi untuk mengelompokkan jumlah traffic dengan cara yang paling bermakna bagi Anda.

Sintaksis API: sum(message_count)

Monetisasi
Biaya fees sum, avg, min, max

Jumlah yang mewakili biaya penyiapan, biaya berulang, atau penambahan saldo prabayar.

Sintaksis API: sum(fees)

Pembagian keuntungan developer x_apigee_mintng_dev_share sum, avg, min, max

Bagian developer dalam pendapatan transaksi. Apigee menghitung bagian developer hanya jika Anda telah mengaktifkan pembagian pendapatan dalam paket tarif.

Bagian developer dihitung menggunakan formula berikut:

x_apigee_mintng_dev_share = revShareGrossPrice * (share percentage)

Nilai persentase pembagian diperoleh dari paket tarif Anda.

Sintaksis API: sum(x_apigee_mintng_dev_share)

Harga monetisasi x_apigee_mintng_price sum, avg, min, max

Total pendapatan transaksi. Pendapatan transaksi ditetapkan ke nilai variabel monetisasi revShareGrossPrice yang diambil dalam kebijakan DataCapture Anda.

Sintaksis API: sum(x_apigee_mintng_price)

Pengganda harga API x_apigee_mintng_price_multiplier sum, avg, min, max

Faktor (pengali) yang digunakan untuk mengalikan biaya per transaksi. Biaya per transaksi ditentukan dalam harga Biaya berbasis konsumsi paket tarif.

Sintaksis API: avg(x_apigee_mintng_price_multiplier)

Rasio monetisasi x_apigee_mintng_rate sum, avg, min, max

Tarif yang dibebankan untuk transaksi. Tarif yang dikenakan untuk transaksi dihitung menggunakan rumus berikut:

x_apigee_mintng_rate = (consumption-based pricing rate) * perUnitPriceMultiplier value

Nilai tarif harga berbasis penggunaan diambil dari paket tarif Anda dan nilai perUnitPriceMultiplier hanya dikalikan jika variabel diambil oleh kebijakan DataCapture.

Sintaksis API: sum(x_apigee_mintng_rate)

Dimensi

Dimensi memungkinkan Anda melihat metrik dalam pengelompokan yang bermakna. Misalnya, melihat jumlah total traffic menjadi jauh lebih efektif jika Anda melihatnya untuk setiap aplikasi developer atau proxy API.

Berikut adalah dimensi yang disediakan Apigee secara langsung.

Dimensi Nama yang akan digunakan di Apigee API Deskripsi
Token Akses access_token Token akses OAuth pengguna akhir aplikasi.
Produk API api_product
  • Nama produk API yang berisi proxy API yang dipanggil. Untuk mendapatkan dimensi ini, aplikasi developer yang melakukan panggilan harus dikaitkan dengan satu atau beberapa produk API yang berisi proxy API, dan proxy yang dipanggil harus memeriksa kunci API atau token OAuth yang dikirim dengan panggilan API. Kunci atau token dikaitkan dengan produk API. Untuk mengetahui informasi selengkapnya, lihat Bagaimana cara membuat data analisis yang lengkap?.

    Jika kriteria di atas tidak terpenuhi, Anda akan melihat nilai (not set). Lihat juga Apa arti nilai entitas analisis "(not set)"?.

  • Dalam konteks metrik biaya, ini akan menjadi produk API yang sesuai dengan paket tarif yang biaya penyiapan atau biaya berulangnya harus diterapkan. Nilai akan kosong untuk isi ulang prabayar.

Nama Aplikasi AppGroup app_group_app Nama aplikasi yang dipanggil saat menjadi bagian dari AppGroup. Lihat Menggunakan AppGroups untuk mengatur kepemilikan aplikasi untuk mengetahui informasi tentang AppGroups.
Nama AppGroup app_group_name Nama AppGroup yang berisi aplikasi yang dipanggil, jika ada. Lihat Menggunakan AppGroups untuk mengatur kepemilikan aplikasi untuk mengetahui informasi tentang AppGroups.
Kunci Cache ax_cache_key

Kunci yang berisi nilai ResponseCache yang diakses. Untuk mengetahui informasi selengkapnya tentang cara kunci dibuat untuk cache respons, lihat kebijakan ResponseCache.

Di alat Debug, saat Anda memilih kebijakan ResponseCache yang membaca dari atau menulis ke cache, Anda dapat melihat nilai ini di responsecache.cachekey variabel alur.

Nama Cache ax_cache_name

Nama cache yang berisi kunci/nilai yang digunakan oleh kebijakan ResponseCache, dengan awalan orgName__envName__. Misalnya, jika org adalah myorgf, lingkungan adalah test, dan nama cache adalah myCache, maka ax_cache_name adalah foo__test__myCache.

Di alat Debug, saat memilih kebijakan ResponseCache, Anda dapat melihat nilai ini di responsecache.cachename variabel alur.

Sumber Cache ax_cache_source

Tingkat cache (dalam memori L1 atau database L2) tempat ResponseCache diambil. Dimensi ini juga menampilkan CACHE_MISS saat respons dikirim dari target, bukan cache (dan cache respons diperbarui dengan respons target); atau saat kunci cache dalam permintaan tidak valid. Kunci cache dibatasi hingga berukuran 2 KB.

Di alat Debug, saat memilih kebijakan ResponseCache, Anda dapat melihat nilai ini di responsecache.cachesource variabel alur.

Untuk mengetahui informasi selengkapnya tentang tingkat cache, lihat Internal cache.

ID Klien client_id

Kunci konsumen (kunci API) aplikasi developer yang melakukan panggilan API, baik diteruskan dalam permintaan sebagai kunci API atau disertakan dalam token OAuth.

Untuk mendapatkan dimensi ini, proxy yang menerima panggilan harus dikonfigurasi untuk memeriksa kunci API atau token OAuth yang valid. Aplikasi developer mendapatkan kunci API, yang dapat digunakan untuk membuat token OAuth, saat aplikasi didaftarkan di Apigee. Untuk mengetahui informasi selengkapnya, lihat Bagaimana cara membuat data analisis yang lengkap?.

Jika kriteria di atas tidak terpenuhi, Anda akan melihat nilai (not set). Lihat juga Apa arti nilai entitas analytics "(not set)"?.

Aplikasi Developer developer_app

Aplikasi developer yang terdaftar di Apigee melakukan panggilan API.

Untuk mendapatkan dimensi ini, aplikasi harus dikaitkan dengan satu atau beberapa produk API yang berisi proxy API yang dipanggil, dan proxy harus memeriksa kunci API atau token OAuth yang dikirim dengan panggilan API. Kunci atau token mengidentifikasi aplikasi developer. Untuk informasi selengkapnya, lihat Bagaimana cara membuat data analisis yang lengkap?.

Jika kriteria di atas tidak terpenuhi, Anda akan melihat nilai (not set). Lihat juga Apa arti nilai entitas analytics "(not set)"?.

Email Developer developer_email
  • Email developer terdaftar di Apigee yang aplikasinya melakukan panggilan API. Kolom ini tidak ditetapkan untuk aplikasi AppGroup.

    Untuk mendapatkan dimensi ini, developer atau AppGroup harus memiliki aplikasi yang terkait dengan satu atau beberapa produk API yang berisi proxy API yang dipanggil, dan proxy harus memeriksa kunci API atau token OAuth yang dikirim dengan panggilan API. Kunci atau token mengidentifikasi aplikasi developer. Untuk mengetahui informasi selengkapnya, lihat Bagaimana cara menghasilkan data analisis yang lengkap?.

    Jika kriteria di atas tidak terpenuhi, Anda akan melihat nilai (not set). Lihat juga Apa arti nilai entitas analytics "(not set)"?.

  • Dalam konteks metrik biaya, developer yang akan dikenai biaya penyiapan, biaya berulang, atau pengisian ulang prabayar.
ID Developer developer

ID developer unik yang dibuat Apigee dalam bentuk org_name@@@unique_id. Untuk AppGroup, unique_id adalah nama AppGroup.

Untuk mendapatkan dimensi ini, developer harus memiliki aplikasi yang terkait dengan satu atau beberapa produk API yang berisi proxy API yang dipanggil, dan proxy harus memeriksa kunci API atau token OAuth yang dikirim dengan panggilan API. Kunci atau token mengidentifikasi developer. Untuk mengetahui informasi selengkapnya, lihat Bagaimana cara membuat data analisis yang lengkap?.

Jika kriteria di atas tidak terpenuhi, Anda akan melihat nilai (not set). Lihat juga Apa arti nilai entitas analytics "(not set)"?.

Lingkungan environment Lingkungan Apigee tempat proxy API di-deploy. Misalnya test atau prod.
Kode Kesalahan pada Error ax_edge_execution_fault_code

Kode kesalahan error. Contoh: messaging.adaptors.http.flow.GatewayTimeout

Nama Alur saat Terjadi Error ax_execution_fault
  _flow_name

Flow bernama di proxy API yang memunculkan error. Misalnya, PreFlow, PostFlow, atau nama alur bersyarat yang Anda buat.

Perhatikan bahwa nama lengkap yang akan digunakan di Apigee API adalah ax_execution_fault_flow_name, tanpa jeda baris.

Jika tidak ada error, Anda akan melihat nilai (not set).

Resource Alur flow_resource Khusus penggunaan Apigee. Lihat Cara menggunakan Dimensi "Alur Resource" di Analytics jika Anda penasaran.
Status Alur pada Error ax_execution_fault
  _flow_state

Nama status alur proxy API yang memunculkan error, seperti PROXY_REQ_FLOW atau TARGET_RESP_FLOW.

Perhatikan bahwa nama lengkap yang akan digunakan di Apigee API adalah ax_execution_fault_flow_state, tanpa jeda baris.

ID Alur Gateway gateway_flow_id Saat panggilan API melewati Apigee, setiap panggilan akan mendapatkan ID alur gateway-nya sendiri. Contoh: rrt329ea-12575-114653952-1. ID Alur Gateway berguna untuk membedakan metrik dalam situasi TPS tinggi saat dimensi lain seperti organisasi, lingkungan, dan stempel waktu sama di seluruh panggilan.
Organisasi organization Organisasi Apigee tempat proxy API di-deploy.
Nama Kebijakan yang Menyebabkan Error ax_execution_fault
  _policy_name

Nama kebijakan yang memunculkan error dan menyebabkan panggilan API gagal.

Perhatikan bahwa nama lengkap yang akan digunakan di Apigee API adalah ax_execution_fault_policy_name, tanpa jeda baris.

Jika kebijakan menampilkan error, tetapi atribut root kebijakan continueOnError disetel ke true, alur proxy API akan berlanjut tanpa kegagalan, dan kegagalan kebijakan tidak dihitung dalam dimensi ini.

Proxy apiproxy Nama mesin (bukan nama tampilan) proxy API.
Jalur Dasar Proxy proxy_basepath

BasePath dikonfigurasi di ProxyEndpoint proxy API. Jalur dasar tidak menyertakan bagian domain dan port dari URL proxy API. Misalnya, jika URL dasar proxy API adalah https://apigeedocs-test.apigee.net/releasenotes/, jalur dasarnya adalah /releasenotes.

Nilai juga disimpan dalam variabel alur proxy.basepath.

Jenis Deployment Proxy proxy_deployment_type

Jenis proxy API untuk proxy yang di-deploy. Menentukan jenis proxy akan membatasi hasil ke jenis proxy tersebut. Nilai yang mungkin adalah STANDARD, EXTENSIBLE, atau tidak ditetapkan.

Akhiran Jalur Proxy proxy_pathsuffix

Jalur resource ditambahkan ke jalur dasar proxy API. Misalnya, jika URL dasar proxy API adalah https://apigeedocs-test.apigee.net/hello/, dan panggilan dilakukan ke https://apigeedocs-test.apigee.net/hello/json, maka pathsuffix adalah /json.

Jika tidak ada pathsuffix yang digunakan, nilainya kosong.

Nilai juga disimpan dalam variabel alur proxy.pathsuffix.

Revisi proxy apiproxy_revision Nomor revisi proxy API yang menangani panggilan API. Hal ini tidak berarti revisi terbaru proxy API. Jika proxy API memiliki 10 revisi, revisi ke-8 mungkin saat ini di-deploy. Selain itu, API dapat memiliki beberapa revisi yang di-deploy selama revisi tersebut memiliki Jalur Dasar yang berbeda, seperti yang dijelaskan dalam Men-deploy proxy.
IP Klien yang Diselesaikan ax_resolved_client_ip

Alamat IP klien asal. Nilai ini berasal dari resolusi alamat IP klien default atau algoritma yang dikonfigurasi di resolusi IP klien yang dikonfigurasi.

Dengan perilaku default, nilai dimensi ax_resolved_client_ip dihitung dari nilai dalam dimensi ax_true_client_ip dan x_forwarded_for_ip.

Perhatikan bahwa saat menggunakan produk perutean seperti Akamai untuk mengambil alamat IP sebenarnya dari klien, IP klien diteruskan ke Apigee di header HTTP True-Client-IP, yang kemudian digunakan untuk menetapkan dimensi ax_true_client_ip.

Nilai dimensi ax_resolved_client_ip dihitung sebagai berikut:

  1. Jika ax_true_client_ip tidak null dan tidak berisi alamat IP lokal, tetapkan ax_resolved_client_ip ke ax_true_client_ip.
  2. Jika tidak, setel ax_resolved_client_ip ke alamat IP non-lokal pertama di x_forwarded_for_ip.
  3. Jika ax_true_client_ip dan x_forwarded_for_ip hanya berisi IP lokal, tetapkan ax_resolved_client_ip ke IP lokal terakhir di x_forwarded_for_ip.
  4. Jika ax_true_client_ip dan x_forwarded_for_ip bernilai null, tetapkan ax_resolved_client_ip ke (not set).
  5. Jika ax_true_client_ip adalah IP lokal dan x_forwarded_for_ip adalah null, tetapkan ax_resolved_client_ip ke (not set).
Kode Status Respons response_status_code Kode status respons HTTP yang diteruskan dari Apigee ke klien, seperti 200, 404, 503, dan sebagainya. Di Apigee, kode status respons dari target dapat diganti dengan kebijakan seperti kebijakan AssignMessage dan kebijakan RaiseFault, itulah sebabnya dimensi ini dapat berbeda dengan Kode Respons Target (target_response_code).
Host Virtual virtual_host Nama host virtual tempat panggilan API dilakukan. Untuk mengetahui informasi selengkapnya, lihat Tentang lingkungan dan grup lingkungan.
Inbound/Klien
Alamat IP Klien client_ip Alamat IP sistem yang mengakses router, seperti klien asli (proxy_client_ip) atau load balancer. Jika ada beberapa IP di header X-Forwarded-For, IP ini adalah IP terakhir yang tercantum.
Kategori Perangkat ax_ua_device_category Jenis perangkat yang digunakan untuk melakukan panggilan API, seperti Tablet atau Smartphone.
Keluarga OS ax_ua_os_family Kelompok sistem operasi perangkat yang melakukan panggilan, seperti Android atau iOS.
Versi OS ax_ua_os_version

Versi sistem operasi perangkat yang melakukan panggilan.

Dimensi ini berguna untuk digunakan sebagai dimensi perincian kedua dengan Grup OS (ax_ua_os_family) untuk melihat versi sistem operasi.

IP Klien Proxy proxy_client_ip

Alamat IP klien yang memanggil, disimpan dalam proxy.client.ip variabel alur. Ini sering kali merupakan alamat X-Forwarded-For dari panggilan masuk, yaitu alamat IP yang diterima Apigee dari handshake TCP eksternal terakhir. Ini bisa berupa klien yang memanggil atau load balancer. Jika ada beberapa IP di header X-Forwarded-For, IP ini adalah IP terakhir yang tercantum.

IP Klien yang Dirujuk ax_true_client_ip

Saat menggunakan produk perutean seperti Akamai untuk mengambil alamat IP sebenarnya dari klien, IP klien diteruskan ke Apigee di header HTTP True-Client-IP. Dimensi ini mengambil IP klien sebenarnya dari header tersebut.

Untuk menentukan Alamat IP klien asli, yang diakses melalui dimensi ax_resolved_client_ip, Apigee menggunakan dimensi ax_true_client_ip dan x_forwarded_for_ip.

Jalur Permintaan request_path

Jalur resource (tidak termasuk domain) ke layanan target, tidak termasuk parameter kueri.

Misalnya, target contoh Apigee http://mocktarget.apigee.net mencakup beberapa resource, termasuk /user, yang menampilkan ucapan. Terlepas dari cara proxy API Anda memanggil http://mocktarget.apigee.net/user, request_path adalah /user.

URI Permintaan request_uri

Jalur resource (tidak termasuk domain) ke layanan target, termasuk parameter kueri.

Misalnya, target contoh Apigee http://mocktarget.apigee.net mencakup beberapa resource, termasuk resource /user?user={name} dan parameter kueri untuk menampilkan ucapan kustom ke nama yang diberikan. Terlepas dari cara proxy API Anda memanggil http://mocktarget.apigee.net/user?user=Dude, request_uri adalah /user?user=Dude.

Kata Kerja Permintaan request_verb Kata kerja permintaan HTTP dalam permintaan API, seperti GET, POST, PUT, DELETE.
Agen Pengguna useragent

Nama agen pengguna, atau agen software, yang digunakan untuk melakukan panggilan API. Contoh:

  • Pixel XL melakukan panggilan melalui Chrome: Mozilla/5.0 (Linux; Android 7.1.2; Pixel XL Build/NHG47N) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.92 Mobile Safari/537.36
  • iPad yang melakukan panggilan melalui Chrome: Mozilla/5.0 (iPad; CPU OS 10_2 like Mac OS X) AppleWebKit/602.1.50 (KHTML, like Gecko) CriOS/54.0.2840.91 Mobile/14C92 Safari/602.1
  • cURL dari terminal: curl/7.51.0
Kelompok Agen Pengguna ax_ua_agent_family Keluarga agen pengguna, seperti Chrome Mobile atau curl.
Jenis Agen Pengguna ax_ua_agent_type Jenis agen pengguna, seperti Browser, Mobile Browser, Library, dan sebagainya.
Versi Agen Pengguna ax_ua_agent_version

Versi agen pengguna.

Dimensi ini berguna sebagai dimensi perincian kedua dengan Keluarga Agen Pengguna (ax_ua_agent_family) untuk mendapatkan versi keluarga agen.

Keluar/Target
Target target Endpoint target yang menangani permintaan. Misalnya, default.
Jalur Dasar Target target_basepath

Jalur resource (tidak termasuk domain) ke layanan target, tidak termasuk parameter kueri, yang ditentukan dalam <TargetEndpoint> proxy.

Misalnya, proxy API memanggil target berikut:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Dalam contoh ini, target_basepath adalah /user.

Jika targetnya adalah ini:

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net</URL>
</HTTPTargetConnection>

target_basepath akan berupa null.

Di Alat debug, saat Anda memilih ikon AX di akhir diagram alur, target.basepath variabel alur dipetakan ke dimensi target_basepath.

Nama Layanan gRPC x_apigee_grpc_service_name Hanya berlaku jika layanan target adalah gRPC. Nama layanan gRPC. Untuk mengetahui informasi tentang proxy gRPC, lihat Membuat proxy API gRPC.
Status gRPC x_apigee_grpc_status Hanya berlaku jika layanan target adalah gRPC. Status permintaan gRPC. Untuk mengetahui informasi tentang proxy gRPC, lihat Membuat proxy API gRPC.
Host Target target_host Host layanan target. Misalnya, jika proxy API memanggil http://mocktarget.apigee.net/help, target_host adalah mocktarget.apigee.net.
Alamat IP Target target_ip Alamat IP layanan target yang menampilkan respons ke proxy API.
Kode Respons Target target_response_code

Kode status respons HTTP yang ditampilkan oleh layanan target ke proxy API, seperti 200, 404, 503, dan sebagainya.

Nilai null berarti permintaan tidak pernah mencapai layanan target. Error ini terjadi saat respons ditayangkan oleh kebijakan ResponseCache atau saat terjadi kegagalan dalam pemrosesan permintaan.

Hal ini berbeda dengan dimensi Kode Status Respons (response_status_code).

Nama RPC gRPC x_apigee_grpc_rpc_name Hanya berlaku jika layanan target adalah gRPC. Nama RPC. Untuk mengetahui informasi tentang proxy gRPC, lihat Membuat proxy API gRPC.
URL Target target_url

URL lengkap layanan target yang ditentukan di TargetEndpoint proxy API.

<TargetEndpoint name="default">
...
<HTTPTargetConnection>
  <URL>http://mocktarget.apigee.net/user?user=Dude</URL>
</HTTPTargetConnection>

Dalam contoh ini, target_url adalah http://mocktarget.apigee.net/user?user=Dude.

Perhatikan bahwa URL juga dapat diganti selama pemrosesan proxy API dengan target.url variabel flow.

Dalam proxy chaining, target_url di proxy panggilan adalah null.

IP X-Forwarded-For x_forwarded_for_ip

Daftar alamat IP di header X-Forwarded-For.

Untuk menentukan Alamat IP klien asli, yang diakses melalui dimensi ax_resolved_client_ip, Apigee menggunakan dimensi ax_true_client_ip dan x_forwarded_for_ip.

Proto X-Forwarded-For x_forwarded_proto

Protokol yang digunakan klien untuk terhubung ke router. Nilai yang valid mencakup http atau https.

Waktu
Hari ax_day_of_week Singkatan tiga huruf untuk hari dalam seminggu saat panggilan API dilakukan. Misalnya, Sen, Sel, Rab.
Bulan ax_month_of_year Bulan numerik saat panggilan API dilakukan. Misalnya, 03 untuk bulan Maret.
Waktu ax_hour_of_day

Berdasarkan jam 24 jam, jam 2 digit saat panggilan API dilakukan. Misalnya, panggilan API yang dilakukan dalam satu jam antara pukul 22.00 dan 23.00, ax_hour_of_day adalah 22.

Nilai waktu dalam UTC.

Zona Waktu ax_geo_timezone Nama umum zona waktu tempat panggilan API dilakukan, seperti America/New_York dan Europe/Dublin.
Minggu dalam Bulan ax_week_of_month Minggu dalam bulan (angka). Misalnya, untuk panggilan API yang dilakukan pada minggu ke-3 dalam sebulan, ax_week_of_month adalah 3.
Location
Kota ax_geo_city Kota tempat panggilan API dilakukan.
Benua ax_geo_continent Kode dua huruf dari benua tempat panggilan API dilakukan. Misalnya, NA untuk Amerika Utara.
Negara ax_geo_country Kode dua huruf negara tempat panggilan API dilakukan. Misalnya, US untuk Amerika Serikat.
Wilayah Geografis ax_geo_region Kode yang dipisahkan dengan tanda hubung untuk wilayah geografis, seperti STATE-COUNTRY. Misalnya, WA-US untuk Washington-Amerika Serikat.
Wilayah ax_dn_region Nama pusat data Apigee tempat proxy API di-deploy, seperti us-east-1.
Monetisasi
Dibuat created

Saat ini tersedia di organisasi Apigee, bukan organisasi Apigee Hybrid.

Stempel Waktu Unix saat jadwal biaya ditambahkan untuk developer aplikasi dan produk API.

Jenis biaya fees_type Jenis biaya. Biaya ini dapat berupa biaya penyiapan, biaya berulang, atau isi ulang prabayar. Nilai ini hanya diisi jika Anda telah memilih metrik Fees.
Mata uang pendapatan x_apigee_mintng_currency
  • Mata uang pendapatan transaksi ditetapkan ke nilai variabel monetisasi currency yang diambil dalam kebijakan DataCapture Anda. Mata uang ini dikaitkan dengan mata uang revShareGrossPrice.
  • Dalam konteks metrik biaya, mata uang ini akan menjadi mata uang biaya penyiapan, biaya berulang, atau pengisian ulang prabayar.
ID paket tarif x_apigee_mintng_rate_plan_id

Saat ini tersedia di organisasi Apigee, bukan organisasi Apigee Hybrid.

Paket tarif monetisasi untuk developer aplikasi.

Keberhasilan transaksi x_apigee_mintng_tx_success Status monetisasi transaksi disetel ke nilai variabel monetisasi transactionSuccess yang diambil dalam kebijakan DataCapture Anda.

Filter

Filter memungkinkan Anda membatasi hasil ke metrik dengan karakteristik tertentu. Berikut beberapa contoh filter. Gunakan nama gaya API metrik dan dimensi saat menentukan filter.

Menampilkan metrik untuk proxy API dengan nama buku atau musik:

filter=(apiproxy in 'books','music')

Menampilkan metrik untuk proxy API dengan nama yang diawali dengan m:

filter=(apiproxy like 'm%')

Menampilkan metrik untuk proxy API dengan nama yang tidak dimulai dengan m:

filter=(apiproxy not like 'm%')

Menampilkan metrik untuk panggilan API dengan kode status respons antara 400 dan 599:

filter=(response_status_code ge 400 and response_status_code le 599)

Menampilkan metrik untuk panggilan API dengan kode status respons 200 dan kode respons target 404:

filter=(response_status_code eq 200 and target_response_code eq 404)

Menampilkan metrik untuk panggilan API dengan kode status respons 500:

filter=(response_status_code eq 500)

Menampilkan metrik untuk panggilan API yang tidak menghasilkan error:

filter=(is_error eq 0)

Menampilkan metrik untuk panggilan API yang tidak menghasilkan respons null:

filter=(response_status_code isnot null)

Berikut adalah operator yang dapat Anda gunakan untuk membuat filter laporan.

Operator Deskripsi
in Sertakan dalam daftar
notin Mengecualikan dari daftar
is Gunakan response_status_code is null untuk memfilter respons yang kode statusnya adalah null.
isnot Gunakan response_status_code isnot null untuk memfilter respons yang kode statusnya bukan null.
eq Sama dengan, ==
ne Tidak sama dengan, !=
gt Lebih besar dari, >
lt Kurang dari, <
ge Lebih besar dari atau sama dengan, >=
le Kurang dari atau sama dengan, <=
like Menampilkan nilai benar (true) jika pola string cocok dengan pola yang diberikan.
not like Menampilkan nilai salah jika pola string cocok dengan pola yang diberikan.
similar to Menampilkan nilai benar atau salah, bergantung pada apakah polanya cocok dengan string yang diberikan. Fungsinya mirip dengan like, tetapi menafsirkan pola menggunakan definisi ekspresi reguler standar SQL.
not similar to Menampilkan nilai salah atau benar, bergantung pada apakah polanya cocok dengan string yang diberikan. Fungsinya mirip dengan not like, kecuali bahwa fungsi ini menafsirkan pola menggunakan definisi ekspresi reguler standar SQL.
and Memungkinkan Anda menggunakan logika AND untuk menyertakan lebih dari satu ekspresi filter. Filter menyertakan data yang memenuhi semua kondisi.
or Memungkinkan Anda menggunakan logika OR untuk mengevaluasi berbagai kemungkinan ekspresi filter. Filter mencakup data yang memenuhi setidaknya salah satu kondisi.