Mengumpulkan data kustom dengan kebijakan DataCapture

Halaman ini berlaku untuk Apigee dan Apigee hybrid.

Lihat Dokumentasi Apigee Edge.

Selain data API biasa yang dikumpulkan oleh Apigee, Anda juga dapat mengumpulkan data kustom menggunakan DataCapture lebih lanjut. Ada dua langkah utama yang diperlukan, seperti yang dijelaskan di bagian berikut:

  1. Membuat resource REST Data Collector.
  2. Tentukan data yang ingin dikumpulkan menggunakan elemen <Collect> kebijakan DataCapture.

Membuat resource REST Data Collector

Untuk menggunakan kebijakan DataCapture, Anda harus membuat dahulu Resource REST Data Collector. Untuk melakukannya, kirim permintaan API seperti berikut:

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -X POST -H "content-type:application/json" \
  -d '
{
  "name": "dc_my_custom_data",
  "description": "Collects data for analysis.",
  "type": "STRING",
}' \
  "https://apigee.googleapis.com/v1/organizations/$PROJECT_ID/datacollectors"

Tindakan ini akan membuat resource bernama dc_my_custom_data, yang dapat Anda gunakan bersama kebijakan DataCapture.

Menentukan data yang akan dikumpulkan

Anda dapat menentukan data yang akan dikumpulkan menggunakan kebijakan DataCapture Elemen <Collect>. Ada berbagai cara untuk melakukannya, seperti yang ditampilkan di Contoh di halaman referensi DataCapure. Salah satu caranya adalah dengan menentukan variabel flow, yang menyimpan data yang diteruskan dalam permintaan dan respons API. Misalnya, Anda bisa mengumpulkan data yang dimasukkan pelanggan dalam formulir halaman web menggunakan alur variabel message.formparam.param_name.values, dengan param_name adalah nama parameter dalam formulir. Misalkan formulir memiliki parameter bernama payment_amount. Variabel aliran yang sesuai akan message.formparam.payment_amount.values.

Kode berikut menentukan variabel ini berdasarkan atribut ref dari elemen <Collect>.

<DataCapture name="capturepayment">
    <Capture>
        <DataCollector>dc_my_custom_data</DataCollector>
        <Collect ref="message.form_param.payment_amount.values" >
    </Capture>
</DataCapture>

Dengan setelan ini, data yang dimasukkan dalam kolom payment_amount formulir akan yang dikumpulkan oleh DataCapture dan disimpan dalam variabel bernama dc_my_custom_data.

Membuat laporan kustom dari data yang dikumpulkan dengan DataCapture

Setelah menyiapkan pengumpulan data dengan kebijakan DataCapture, Anda dapat menggunakan data untuk membuat laporan khusus dengan prosedur yang dijelaskan di Menambahkan laporan kustom. Untuk melakukannya, saat Anda memilih metrik untuk dalam laporan, seperti yang ditunjukkan dalam langkah 4 dari prosedur, pilih variabel yang memiliki nama yang sama dengan Data Collector Resource REST yang Anda buat untuk DataCapture—misalnya, dc_my_custom_data— sebagaimana ditunjukkan di bawah ini.

Menambahkan metrik kustom untuk DataCapture.

Anda juga dapat menggunakan variabel yang sama seperti dimensi dalam laporan kustom. Karena dimensi mengelompokkan data berdasarkan nilai variabel, hal itu variabel sebaiknya berupa {i>string<i} yang hanya menggunakan sejumlah kecil masing-masing.