Menambahkan permintaan ke pengujian beban berbasis URL di Azure Load Testing

Dalam artikel ini, Anda mempelajari cara menambahkan permintaan HTTP ke pengujian beban berbasis URL di Azure Load Testing. Gunakan pengujian beban berbasis URL untuk memvalidasi titik akhir HTTP, seperti aplikasi web atau titik akhir REST, tanpa pengetahuan sebelumnya tentang alat pengujian beban dan pembuatan skrip.

Azure mendukung dua cara untuk menentukan permintaan HTTP dalam pengujian beban berbasis URL. Anda dapat menggabungkan kedua metode dalam pengujian beban.

• Tentukan detail titik akhir HTTP, seperti URL titik akhir, metode HTTP, header, parameter kueri, atau isi permintaan.
• Masukkan perintah cURL untuk permintaan HTTP.

Jika Anda memiliki permintaan dependen, Anda dapat mengekstrak nilai respons dari satu permintaan dan meneruskannya sebagai input ke permintaan berikutnya. Misalnya, Anda mungkin terlebih dahulu mengambil detail pelanggan, dan mengekstrak ID pelanggan untuk mengambil detail pesanan pelanggan.

Jika Anda menggunakan pengujian beban berbasis URL di alur kerja CI/CD, Anda dapat meneruskan file JSON yang berisi permintaan HTTP ke pengujian beban Anda.

Anda dapat menambahkan hingga lima permintaan ke pengujian beban berbasis URL. Untuk pengujian beban yang lebih kompleks, Anda dapat membuat pengujian beban dengan mengunggah skrip pengujian JMeter. Misalnya, ketika Anda memiliki lebih dari lima permintaan, jika Anda menggunakan protokol non-HTTP, atau jika Anda perlu menggunakan plugin JMeter.

Prasyarat

• Akun Azure dengan langganan aktif. Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
• Sumber daya pengujian beban Azure. Untuk membuat sumber daya pengujian beban, lihat Membuat dan menjalankan pengujian beban.

Menambahkan permintaan dengan detail HTTP

Anda dapat menentukan permintaan HTTP untuk pengujian beban berbasis URL dengan memberikan detail permintaan HTTP. Tabel berikut mencantumkan bidang yang bisa Anda konfigurasi untuk permintaan HTTP di Azure Load Testing:

Bidang	Detail
URL	URL titik akhir HTTP. Contohnya, https://www.contoso.com/products.
Metode	Metode HTTP. Azure Load Testing mendukung GET, POST, PUT, DELETE, PATCH, HEAD, dan OPTIONS.
Parameter kueri	(Opsional) Masukkan parameter string kueri untuk ditambahkan ke URL.
Header HTTP	(Opsional) Masukkan header HTTP untuk disertakan dalam permintaan HTTP. Anda dapat menambahkan hingga 20 header untuk permintaan.
Isi permintaan	(Opsional) Bergantung pada metode HTTP, Anda dapat menentukan konten isi HTTP. Azure Load Testing mendukung format berikut: data mentah, tampilan JSON, JavaScript, HTML, dan XML.

Ikuti langkah-langkah ini untuk menambahkan permintaan HTTP ke pengujian beban berbasis URL:

Portal Azure

1. Di portal Azure, buka sumber daya pengujian beban Anda.

2. Di navigasi kiri, pilih Pengujian untuk melihat semua pengujian.

3. Dalam daftar, pilih uji beban Anda, lalu pilih Edit.

   Pastikan untuk memilih uji beban berbasis URL dari daftar dan Mengaktifkan Aktifkan pengaturan tingkat lanjut pada tab Dasar .

4. Buka tab Uji paket , dan pilih Tambahkan permintaan.

   

5. Pilih Tambahkan input di UI untuk memasukkan detail permintaan HTTP.

6. Masukkan detail permintaan HTTP, lalu pilih Tambahkan untuk menambahkan permintaan ke pengujian beban Anda.

   Bidang	Deskripsi
   Format permintaan	Pilih Tambahkan input di UI untuk mengonfigurasi detail permintaan melalui bidang di portal Azure.
   Nama permintaan	Masukkan nama unik untuk permintaan tersebut. Anda dapat merujuk ke nama permintaan ini saat menentukan kriteria kegagalan pengujian.
   URL	URL titik akhir aplikasi.
   Metode	Pilih metode HTTP dari daftar. Azure Load Testing mendukung GET, POST, PUT, DELETE, PATCH, HEAD, dan OPTIONS.
   Parameter kueri	(Opsional) Masukkan parameter string kueri untuk ditambahkan ke URL.
   Header	(Opsional) Masukkan header HTTP untuk disertakan dalam permintaan HTTP.
   Isi	(Opsional) Bergantung pada metode HTTP, Anda juga dapat menentukan konten isi HTTP. Azure Load Testing mendukung format berikut: data mentah, tampilan JSON, JavaScript, HTML, dan XML.

   

7. Pilih Terapkan untuk menyimpan uji beban.

Azure Pipelines / GitHub Actions

Saat Anda menjalankan pengujian beban sebagai bagian dari alur kerja CI/CD, seperti GitHub Actions atau Azure Pipelines, Anda menyediakan daftar permintaan HTTP dalam file JSON permintaan. Dalam file YAML konfigurasi pengujian beban, Anda mereferensikan file JSON di testPlan properti .

1. Buat requests.json file untuk menyimpan permintaan HTTP dan tempelkan cuplikan kode berikut dalam file:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Secara opsional, konfigurasikan pengaturan beban di testSetup properti . Pelajari selengkapnya tentang mengonfigurasi parameter beban untuk pengujian beban berbasis URL.

2. Tambahkan detail permintaan HTTP di requests properti :

   Cuplikan kode berikut menunjukkan contoh permintaan HTTP POST. Perhatikan bahwa requestType adalah URL.

   {
       "requestName": "add",
       "responseVariables": [],
       "queryParameters": [
           {
               "key": "param1",
               "value": "value1"
           }
       ],
       "requestType": "URL",
       "endpoint": "http://www.contoso.com/orders",
       "headers": {
           "api-token": "my-token"
       },
       "body": "{\r\n  \"customer\": \"Contoso\",\r\n  \"items\": {\r\n\t  \"product_id\": 321,\r\n\t  \"count\": 50,\r\n\t  \"amount\": 245.95\r\n  }\r\n}",
       "method": "POST",
       "requestBodyFormat": "JSON"
   },
   

3. Perbarui file YAML konfigurasi pengujian beban dan atur testType pengaturan dan testPlan :

   Pastikan untuk mengatur properti ke testTypeURL untuk menunjukkan bahwa Anda menjalankan pengujian beban berbasis URL.

   Properti testPlan mereferensikan file JSON permintaan yang Anda buat di langkah sebelumnya.

   Cuplikan kode berikut menunjukkan fragmen contoh file konfigurasi pengujian beban:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Simpan kedua file dan terapkan ke repositori kontrol sumber Anda.

Menambahkan permintaan menggunakan cURL

Alih-alih memberikan detail permintaan HTTP, Anda juga dapat memberikan perintah cURL untuk permintaan HTTP dalam pengujian beban berbasis URL Anda. cURL adalah alat baris perintah dan pustaka untuk permintaan berbasis URL.

Ikuti langkah-langkah ini untuk menambahkan permintaan HTTP ke uji beban dengan menggunakan perintah cURL.

Portal Azure

1. Dalam daftar pengujian, pilih uji beban Anda, lalu pilih Edit.

   Pastikan untuk memilih uji beban berbasis URL dari daftar dan Mengaktifkan Aktifkan pengaturan tingkat lanjut pada tab Dasar .

2. Buka tab Uji paket , dan pilih Tambahkan permintaan.

3. Pilih Tambahkan perintah cURL untuk membuat permintaan HTTP dengan menggunakan cURL.

4. Masukkan perintah cURL di bidang perintah cURL, lalu pilih Tambahkan untuk menambahkan permintaan ke uji beban Anda.

   Contoh berikut menggunakan cURL untuk melakukan permintaan HTTP GET, menentukan header HTTP:

   curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
   

   

5. Pilih Terapkan untuk menyimpan uji beban.

Azure Pipelines / GitHub Actions

Saat Anda menjalankan pengujian beban sebagai bagian dari alur kerja CI/CD, seperti GitHub Actions atau Azure Pipelines, Anda menyediakan daftar permintaan HTTP dalam file JSON permintaan. Dalam file YAML konfigurasi pengujian beban, Anda mereferensikan file JSON di testPlan properti .

1. Buat file JSON untuk menyimpan permintaan HTTP dan tempelkan cuplikan kode berikut dalam file:

   {
       "version": "1.0",
       "scenarios": {
           "requestGroup1": {
               "requests": [
               ],
               "csvDataSetConfigList": []
           }
       },
       "testSetup": [
           {
               "virtualUsersPerEngine": 50,
               "durationInSeconds": 300,
               "loadType": "Linear",
               "scenario": "requestGroup1",
               "rampUpTimeInSeconds": 60
           }
       ]
   }
   

   Secara opsional, konfigurasikan pengaturan beban di testSetup properti . Pelajari selengkapnya tentang mengonfigurasi parameter beban untuk pengujian beban berbasis URL.

2. Tambahkan perintah cURL di requests properti :

   Cuplikan kode berikut menunjukkan contoh permintaan HTTP POST. Perhatikan bahwa requestType adalah CURL.

   {
       "requestName": "get-customers",
       "responseVariables": [],
       "requestType": "CURL",
       "curlCommand": "curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'"
   },
   

3. Atur testType pengaturan dan testPlan dalam file YAML konfigurasi pengujian beban untuk mereferensikan file JSON permintaan:

   Pastikan untuk mengatur properti ke testTypeURL untuk menunjukkan bahwa Anda menjalankan pengujian beban berbasis URL.

   Properti testPlan mereferensikan file JSON permintaan yang Anda buat di langkah sebelumnya.

   Cuplikan kode berikut menunjukkan fragmen contoh file konfigurasi pengujian beban:

   displayName: my-first-load-test
   testPlan: requests.json
   description: Web application front-end
   engineInstances: 1
   testId: my-first-load-test
   testType: URL
   splitAllCSVs: False
   failureCriteria: []
   autoStop:
     errorPercentage: 90
     timeWindow: 60
   

4. Simpan kedua file dan terapkan ke repositori kontrol sumber Anda.

Menggunakan variabel dalam permintaan HTTP

Anda dapat menggunakan variabel dalam permintaan HTTP Anda untuk membuat pengujian Anda lebih fleksibel, atau untuk menghindari termasuk rahasia dalam rencana pengujian Anda. Misalnya, Anda dapat menggunakan variabel lingkungan dengan nama domain titik akhir Anda lalu menggunakan nama variabel dalam permintaan HTTP individual. Penggunaan variabel membuat rencana pengujian Anda lebih fleksibel dan dapat dipertahankan.

Dengan pengujian beban berbasis URL di Azure Load Testing, Anda dapat menggunakan variabel untuk merujuk ke informasi berikut:

• Variabel lingkungan: Anda dapat mengonfigurasi variabel lingkungan untuk pengujian beban
• Rahasia: mengonfigurasi rahasia Azure Key Vault dalam pengujian beban Anda
• Nilai dari file input CSV: gunakan variabel untuk kolom dalam file input CSV dan jalankan permintaan untuk setiap baris dalam file
• Variabel respons: mengekstrak nilai dari permintaan HTTP sebelumnya

Sintaks untuk merujuk ke variabel dalam permintaan adalah: ${variable-name}.

Cuplikan layar berikut menunjukkan cara merujuk ke token variabel di header HTTP dengan menggunakan ${token}.

Catatan

Jika Anda menentukan sertifikat, Azure Load Testing secara otomatis meneruskan sertifikat di setiap permintaan HTTP.

Menggunakan variabel respons untuk permintaan dependen

Untuk membuat permintaan HTTP yang membedakan permintaan sebelumnya, Anda dapat menggunakan variabel respons. Misalnya, dalam permintaan pertama Anda dapat mengambil daftar item dari API, mengekstrak ID dari hasil pertama, lalu membuat ID berikutnya dan meneruskan ID ini sebagai parameter string kueri.

Azure Load Testing mendukung opsi berikut untuk mengekstrak nilai dari permintaan HTTP dan menyimpannya dalam variabel:

• JSONPath
• XPath
• Ekspresi reguler

Misalnya, contoh berikut menunjukkan cara menggunakan XPathExtractor untuk menyimpan isi permintaan dalam token variabel respons. Anda kemudian dapat menggunakan ${token} dalam permintaan HTTP lainnya untuk merujuk ke nilai ini.

"responseVariables": [
    {
        "extractorType": "XPathExtractor",
        "expression": "/note/body",
        "variableName": "token"
    }
]

Konten terkait

• Mengonfigurasi pengujian beban dengan variabel dan rahasia lingkungan
• Membaca data dari file CSV input
• Referensi YAML konfigurasi pengujian beban