إضافة طلبات إلى اختبارات التحميل المستندة إلى عنوان URL في اختبار تحميل Azure

مقالة
11/16/2023

في هذه المقالة، ستتعلم كيفية إضافة طلبات HTTP إلى اختبار تحميل يستند إلى عنوان URL في اختبار تحميل Azure. استخدم اختبار تحميل يستند إلى عنوان URL للتحقق من صحة نقاط نهاية HTTP، مثل تطبيقات الويب أو نقاط نهاية REST، دون معرفة مسبقة بأدوات اختبار التحميل والبرمجة النصية.

يدعم Azure طريقتين لتعريف طلبات HTTP في اختبار التحميل المستند إلى عنوان URL. يمكنك دمج كلا الأسلوبين ضمن اختبار التحميل.

حدد تفاصيل نقطة نهاية HTTP، مثل عنوان URL لنقطة النهاية أو أسلوب HTTP أو الرؤوس أو معلمات الاستعلام أو نص الطلب.
أدخل أمر cURL لطلب HTTP.

إذا كان لديك طلبات تابعة، يمكنك استخراج قيم الاستجابة من طلب واحد وتمريرها كمدخل إلى طلب لاحق. على سبيل المثال، يمكنك أولا استرداد تفاصيل العميل، واستخراج معرف العميل لاسترداد تفاصيل طلب العميل.

إذا كنت تستخدم اختبار تحميل يستند إلى عنوان URL في سير عمل CI/CD، يمكنك تمرير ملف JSON الذي يحتوي على طلبات HTTP إلى اختبار التحميل الخاص بك.

يمكنك إضافة ما يصل إلى خمسة طلبات إلى اختبار تحميل يستند إلى عنوان URL. بالنسبة لاختبارات التحميل الأكثر تعقيدا، يمكنك إنشاء اختبار تحميل عن طريق تحميل برنامج نصي لاختبار JMeter. على سبيل المثال، عندما يكون لديك أكثر من خمسة طلبات، إذا كنت تستخدم بروتوكولات غير HTTP، أو إذا كنت بحاجة إلى استخدام المكونات الإضافية JMeter.

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.
مورد اختبار تحميل Azure. لإنشاء مورد اختبار تحميل، راجع إنشاء اختبار تحميل وتشغيله.

إضافة طلبات بتفاصيل HTTP

يمكنك تحديد طلب HTTP لاختبار تحميل يستند إلى عنوان URL من خلال توفير تفاصيل طلب HTTP. يسرد الجدول التالي الحقول التي يمكنك تكوينها لطلب HTTP في اختبار تحميل Azure:

الحقل	تفاصيل
عنوان URL	عنوان URL لنقطة نهاية HTTP. على سبيل المثال، `https://www.contoso.com/products`.
الطريقة	أسلوب HTTP. يدعم اختبار تحميل Azure GET وPOST و PUT وDELETE و PATCH و HEAD و OPTIONS.
معلمات الاستعلام	(اختياري) أدخل معلمات سلسلة الاستعلام لإلحاقها بعنوان URL.
رؤوس عناوين HTTP	(اختياري) أدخل عناوين HTTP لتضمينها في طلب HTTP. يمكنك إضافة ما يصل إلى 20 رأسا لطلب.
نص الطلب	(اختياري) اعتمادا على أسلوب HTTP، يمكنك تحديد محتوى نص HTTP. يدعم Azure Load Testing التنسيقات التالية: البيانات الأولية، وطريقة عرض JSON، وJavaScript، وHTML، وXML.

اتبع هذه الخطوات لإضافة طلب HTTP إلى اختبار تحميل يستند إلى عنوان URL:

مدخل Microsoft Azure
Azure Pipelines / GitHub Actions

في مدخل Microsoft Azure، انتقل إلى مورد اختبار التحميل.
في جزء التنقل الأيمن، حدد Tests لعرض جميع الاختبارات.
في القائمة، حدد اختبار التحميل، ثم حدد تحرير.

تأكد من تحديد اختبار تحميل مستند إلى عنوان URL من القائمة ومن تمكين تمكين الإعدادات المتقدمة في علامة التبويب الأساسيات .
انتقل إلى علامة التبويب خطة الاختبار، وحدد إضافة طلب.
حدد Add input in UI لإدخال تفاصيل طلب HTTP.

أدخل تفاصيل طلب HTTP، ثم حدد إضافة لإضافة الطلب إلى اختبار التحميل الخاص بك.

الحقل	‏‏الوصف
تنسيق الطلب	حدد Add input in UI لتكوين تفاصيل الطلب من خلال الحقول في مدخل Microsoft Azure.
اسم الطلب	أدخل اسما فريدا للطلب. يمكنك الرجوع إلى اسم الطلب هذا عند تحديد معايير فشل الاختبار.
عنوان URL	عنوان URL لنقطة نهاية التطبيق.
الطريقة	حدد أسلوب HTTP من القائمة. يدعم اختبار تحميل Azure GET وPOST و PUT وDELETE و PATCH و HEAD و OPTIONS.
معلمات الاستعلام	(اختياري) أدخل معلمات سلسلة الاستعلام لإلحاقها بعنوان URL.
رؤوس	(اختياري) أدخل عناوين HTTP لتضمينها في طلب HTTP.
نص الرسالة	(اختياري) اعتمادا على أسلوب HTTP، يمكنك أيضا تحديد محتوى نص HTTP. يدعم Azure Load Testing التنسيقات التالية: البيانات الأولية، وطريقة عرض JSON، وJavaScript، وHTML، وXML.

حدد تطبيق لحفظ اختبار التحميل.

عند تشغيل اختبار التحميل كجزء من سير عمل CI/CD، مثل GitHub Actions أو Azure Pipelines، فإنك توفر قائمة طلبات HTTP في ملف JSON للطلبات. في ملف تكوين اختبار التحميل YAML، يمكنك الرجوع إلى ملف JSON في الخاصية testPlan .

requests.json إنشاء ملف لتخزين طلبات HTTP ولصق القصاصة البرمجية التالية في الملف:

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

اختياريا، قم بتكوين إعدادات التحميل في الخاصية testSetup . تعرف على المزيد حول تكوين معلمات التحميل لاختبارات التحميل المستندة إلى عنوان URL.

أضف تفاصيل طلب HTTP في الخاصية requests :

تعرض القصاصة البرمجية التالية مثالا لطلب HTTP POST. لاحظ أن requestType هو 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"
},

تحديث ملف تكوين اختبار التحميل YAML وتعيين testType الإعدادات و testPlan :

تأكد من تعيين الخاصية testType إلى URL للإشارة إلى أنك تقوم بتشغيل اختبار تحميل يستند إلى عنوان URL.

testPlan تشير الخاصية إلى ملف JSON للطلبات الذي قمت بإنشائه في الخطوة السابقة.

يظهر مقتطف التعليمات البرمجية التالي جزءا من مثال ملف تكوين اختبار التحميل:
```
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
```
احفظ كلا الملفين وقم بتثبيتهما في مستودع التحكم بالمصادر.

إضافة طلبات باستخدام cURL

بدلا من توفير تفاصيل طلب HTTP، يمكنك أيضا توفير أوامر cURL لطلبات HTTP في اختبار التحميل المستند إلى عنوان URL. cURL هي أداة سطر أوامر ومكتبة للطلبات المستندة إلى عنوان URL.

اتبع هذه الخطوات لإضافة طلب HTTP إلى اختبار تحميل باستخدام أمر cURL.

مدخل Microsoft Azure
Azure Pipelines / GitHub Actions

في قائمة الاختبارات، حدد اختبار التحميل، ثم حدد تحرير.

تأكد من تحديد اختبار تحميل مستند إلى عنوان URL من القائمة ومن تمكين تمكين الإعدادات المتقدمة في علامة التبويب الأساسيات .
انتقل إلى علامة التبويب خطة الاختبار، وحدد إضافة طلب.
حدد Add cURL command لإنشاء طلب HTTP باستخدام cURL.
أدخل الأمر cURL في حقل الأمر cURL، ثم حدد إضافة لإضافة الطلب إلى اختبار التحميل الخاص بك.

يستخدم المثال التالي cURL لتنفيذ طلب HTTP GET، مع تحديد عنوان HTTP:
```
curl --request GET 'http://www.contoso.com/customers?version=1' --header 'api-token: my-token'
```
حدد تطبيق لحفظ اختبار التحميل.

إنشاء ملف JSON لتخزين طلبات HTTP ولصق القصاصة البرمجية التالية في الملف:

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

إضافة أمر cURL في الخاصية requests :

تعرض القصاصة البرمجية التالية مثالا لطلب HTTP POST. لاحظ أن requestType هو CURL.

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

testType تعيين الإعدادات و testPlan في ملف YAML لتكوين اختبار التحميل للإشارة إلى ملف JSON للطلبات:

تأكد من تعيين الخاصية testType إلى URL للإشارة إلى أنك تقوم بتشغيل اختبار تحميل يستند إلى عنوان URL.

testPlan تشير الخاصية إلى ملف JSON للطلبات الذي قمت بإنشائه في الخطوة السابقة.

يظهر مقتطف التعليمات البرمجية التالي جزءا من مثال ملف تكوين اختبار التحميل:
```
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
```
احفظ كلا الملفين وقم بتثبيتهما في مستودع التحكم بالمصادر.

استخدام المتغيرات في طلبات HTTP

يمكنك استخدام المتغيرات في طلب HTTP لجعل اختباراتك أكثر مرونة، أو لتجنب تضمين البيانات السرية في خطة الاختبار الخاصة بك. على سبيل المثال، يمكنك استخدام متغير بيئة مع اسم مجال نقطة النهاية الخاصة بك ثم استخدام اسم المتغير في طلبات HTTP الفردية. استخدام المتغيرات يجعل خطة الاختبار الخاصة بك أكثر مرونة وقابلية للصيانة.

باستخدام اختبارات التحميل المستندة إلى عنوان URL في اختبار تحميل Azure، يمكنك استخدام المتغيرات للإشارة إلى المعلومات التالية:

متغيرات البيئة: يمكنك تكوين متغيرات البيئة لاختبار التحميل
الأسرار: تكوين أسرار Azure Key Vault في اختبار التحميل الخاص بك
القيم من ملف إدخال CSV: استخدم المتغيرات للأعمدة في ملف إدخال CSV وقم بتشغيل طلب لكل صف في الملف
متغيرات الاستجابة: استخراج القيم من طلب HTTP سابق

بناء الجملة للإشارة إلى متغير في طلب هو: ${variable-name}.

توضح لقطة الشاشة التالية كيفية الرجوع إلى token متغير في رأس HTTP باستخدام ${token}.

إشعار

إذا قمت بتحديد الشهادات، فإن Azure Load Testing يمرر الشهادات تلقائيا في كل طلب HTTP.

استخدام متغيرات الاستجابة للطلبات التابعة

لإنشاء طلبات HTTP التي تتكبت على طلب سابق، يمكنك استخدام متغيرات الاستجابة. على سبيل المثال، في الطلب الأول، قد تسترد قائمة بالعناصر من واجهة برمجة التطبيقات، واستخراج المعرف من النتيجة الأولى، ثم إجراء لاحق وتمرير هذا المعرف كمعلمة سلسلة استعلام.

يدعم Azure Load Testing الخيارات التالية لاستخراج القيم من طلب HTTP وتخزينها في متغير:

مسار JSON
XPath
التعبير العادي

على سبيل المثال، يوضح المثال التالي كيفية استخدام XPathExtractor لتخزين نص طلب في متغير الاستجابة token . يمكنك بعد ذلك استخدام ${token} في طلبات HTTP الأخرى للإشارة إلى هذه القيمة.

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

مشاركة عبر

إضافة طلبات إلى اختبارات التحميل المستندة إلى عنوان URL في اختبار تحميل Azure

المتطلبات الأساسية

إضافة طلبات بتفاصيل HTTP

إضافة طلبات باستخدام cURL

استخدام المتغيرات في طلبات HTTP

استخدام متغيرات الاستجابة للطلبات التابعة

الملاحظات

الموارد الإضافية

مشاركة عبر

إضافة طلبات إلى اختبارات التحميل المستندة إلى عنوان URL في اختبار تحميل Azure

المتطلبات الأساسية

إضافة طلبات بتفاصيل HTTP

إضافة طلبات باستخدام cURL

استخدام المتغيرات في طلبات HTTP

استخدام متغيرات الاستجابة للطلبات التابعة

المحتوى ذو الصلة

الملاحظات

الموارد الإضافية