لترحيل اختبارات JMeter إلى Apidog، استورد ملف .jmx (يُدرج Apidog صيغة JMeter ضمن الصيغ المدعومة للاستيراد، كما يقبل Apidog CLI الوسيط --format jmeter)، وراجع ما تم استيراده، وأعد بناء التدفق كسيناريو اختبار، ثم تأكد من نجاحه في تشغيل وظيفي قبل تحميله لاختبار الأحمال. المؤقتات (Timers) وسكربتات Groovy وأدوات أخذ العينات غير HTTP تحتاج إلى عمل يدوي.
في الأسفل: ما يحتويه ملف .jmx، وكيفية مطابقة كل عنصر، وأين يفشل التطابق، وكيف يمكن لوكيل البرمجة لديك إنجاز العمل باستخدام Apidog CLI.
ماذا يحتوي ملف JMeter .jmx؟
ملف .jmx هو خطة اختبار JMeter المحفوظة: شجرة XML من العناصر ينفذها JMeter من الأعلى إلى الأسفل. يحدد دليل مستخدم JMeter وحدات البناء الأساسية. كل طلب يقع تحت مجموعة خيوط (Thread Group)، وكل عنصر آخر يغيّر كيفية إرسال تلك الطلبات أو التحقق منها أو توقيتها.
إليك ما ستجده عند فتح أحد هذه الملفات:
- Thread Group: المستخدمون المحاكاة. تحدد عدد الخيوط، ومدة التدرّج (ramp-up)، وعدد التكرارات.
- Samplers: الطلبات نفسها. HTTP Request هو الأكثر شيوعًا، لكن توجد أيضًا أدوات أخذ عينات لـ JDBC وFTP وLDAP وTCP.
- Logic controllers: متحكمات If وWhile وLoop وTransaction وSimple التي تحدد الترتيب والتكرار.
- Config elements: HTTP Request Defaults وHeader Manager وCookie Manager وCSV Data Set Config وUser Defined Variables.
- Pre- and post-processors: مستخرجات (Regex وJSON وXPath وBoundary) وسكربتات JSR223، عادةً بلغة Groovy.
- Assertions: تحققات الاستجابة والمدة والحجم وJSON.
- Timers: تأخيرات ثابتة وعشوائية غاوسية وغيرها بين أدوات أخذ العينات.
- Listeners: أشجار النتائج، والتقارير المجمعة، ولوحة التحكم HTML.
إذا كنت بحاجة إلى تذكير بالأداة نفسها، اقرأ ما هو JMeter وكيف يعمل قبل البدء في تفكيك الخطط.
هل يمكن لـ Apidog استيراد ملفات JMeter؟
نعم. يدرج دليل الترحيل إلى Apidog JMeter ضمن فئة "API Clients & Data Tools" مع الوصف "استيراد ملفات سكربتات Apache JMeter". كما يوفر Apidog CLI نفس المستورد: يعرض الأمر apidog import --help القيمة jmeter ضمن القيم الممكنة لـ --format.
ما لا تنشره المستندات هو جدول مطابقة عنصرًا بعنصر لعمليات استيراد JMeter. يقدم دليل ترحيل JMeter من Postman تقرير استيراد يصنّف العناصر إلى "مستورد كما هو" و"مقارَّب" و"غير مدعوم"؛ أما الاستيراد اليدوي في Apidog فيمنحك معاينة بدلًا من ذلك، حيث تختار ما تريد إحضاره قبل التأكيد. لذا تعامل مع الاستيراد باعتباره المسودة الأولى لترحيلك، وليس المجموعة النهائية. افتح ما تم استيراده، وقارنه بشجرة .jmx، وأصلح الفجوات يدويًا أو باستخدام وكيلك البرمجي.
تنبيه صريح: ميزة اختبارات الأداء في Apidog لا تزال في المرحلة التجريبية وتدعم حتى 100 مستخدم افتراضي لكل تشغيل. إذا كانت خطة JMeter لديك تدير آلاف الخيوط عبر إعداد موزّع، فاحتفظ بـ JMeter لتلك الأحمال القصوى، وانقل الجانب الوظيفي واختبارات الانحدار إلى Apidog.
كيف تتطابق عناصر JMeter مع Apidog
معظم خطة اختبار HTTP النموذجية لها مكان مباشر في Apidog. يوضح الجدول موقع كل عنصر بعد الترحيل وما يجب التحقق منه بمجرد اكتمال الاستيراد.

| عنصر JMeter | موقعه في Apidog | تحقق بعد الاستيراد |
|---|---|---|
| أداة أخذ العينات HTTP Request | طلب نقطة نهاية أو خطوة في سيناريو اختبار | الطريقة والمسار والجسم والترويسات |
| HTTP Request Defaults | عنوان URL الأساسي في البيئة | عنوان URL أساسي واحد لكل بيئة |
| Header Manager والمصادقة | ترويسات الطلب أو إعدادات المصادقة | الرموز (Tokens) منقولة إلى متغيرات، وليست مضمّنة في الكود |
User Defined Variables ${var} |
متغيرات البيئة أو العامة {{var}} |
إعادة كتابة كل مرجع ${} |
| مستخرج JSON أو Regex | معالج لاحق لاستخراج المتغيرات (JSONPath، XPath) | الاسم المستخرج يطابق الخطوات اللاحقة |
| Response Assertion | معالج لاحق للتحققات (Assertions) | فحوصات الحالة والجسم ما زالت تعمل |
| Duration Assertion | سكربت pm.test على pm.response.responseTime |
قيمة العتبة |
| CSV Data Set Config | بيانات الاختبار، بتطابق عشوائي أو تسلسلي | أسماء الأعمدة تطابق المتغيرات |
| متحكمات Loop وIf وWhile | حلقة For وIf وغيرها من شروط التحكم في التدفق | معالجة الفواصل والأخطاء |
| متحكم Transaction | مجموعة في سيناريو الاختبار | ترتيب الخطوات |
| Constant Timer | خطوة انتظار | التأخير بالمللي ثانية |
| Thread Group | المستخدمون الافتراضيون ومدة التدرّج في اختبار الأداء | أقل من 100 مستخدم افتراضي |
| Listeners | تقارير الاختبار داخل التطبيق، أو -r html,json,junit من سطر الأوامر |
التقرير يصل إلى المكان الذي يتوقعه CI |
تغيير صيغة المتغيرات هو ما يوقع معظم الناس في الأخطاء. يشير JMeter إلى ${token}، بينما يستخدم Apidog {{token}}. ابحث في السيناريو عن أي ${ متبقٍ بعد الاستيراد؛ أي مرجع تجده سيُرسل كسلسلة نصية حرفية.
ما لا ينتقل بشكل سلس
بعض ميزات JMeter ليس لها مكافئ مباشر، والتظاهر بغير ذلك هو ما يُفسد عمليات الترحيل. خطط لهذه الحالات:
- سكربتات Groovy وBeanShell. سكربتات المعالجة الأولية واللاحقة في Apidog تعمل بلغة JavaScript مع واجهة برمجة
pmعلى نمط Postman. أعد كتابة منطق JSR223 بلغة JavaScript؛ ووكيل البرمجة لديك بارع تحديدًا في هذا النوع من التحويل. - أدوات أخذ العينات غير HTTP. أدوات أخذ العينات FTP وLDAP وTCP وJMS تختبر بروتوكولات خارج نطاق عميل API. احتفظ بتلك الأدوات في JMeter. يمكن غالبًا تحويل فحوصات JDBC إلى عمليات قواعد بيانات في Apidog (MySQL وMongoDB وRedis وOracle موثقة)، لكن أعد بناءها بشكل مدروس.
- تشكيل الإنتاجية (Throughput shaping). تضبط مؤقتات JMeter ومتحكمات الإنتاجية ومجموعات الخيوط الإضافية معدل الطلبات بدقة. أما اختبار الأداء في Apidog فيحدد المستخدمين الافتراضيين والمدة ومدة التدرّج، ويمر كل مستخدم عبر السيناريو في حلقات. توقّع أرقام طلبات في الثانية مختلفة.
- التوسع إلى ما بعد 100 مستخدم افتراضي. هذا هو الحد الأقصى الموثق لاختبارات الأداء في Apidog حاليًا.
- تصدير تقارير لاختبارات الأحمال. تقول المستندات إن تقارير الأداء لا يمكن تصديرها بعد؛ بل تُعرض داخل العميل. أما التشغيلات الوظيفية من سطر الأوامر فيمكنها تصدير HTML وJSON وJUnit.
لا شيء من هذا يمنع الترحيل؛ بل يحدد أي الاختبارات تنتقل. عادةً ما تنتقل المجموعة الوظيفية وتبقى بعض خطط الأحمال القصوى. يعرض برنامج JMeter التعليمي لاختبار API نوع الخطة الوظيفية التي تنتقل بسهولة.
خطوة بخطوة: ترحيل خطة اختبار JMeter
إليك المسار الكامل، من .jmx إلى مهمة CI خضراء (ناجحة).

- سجّل خط أساس (Baseline). شغّل الخطة مرة واحدة في وضع سطر الأوامر، وهو ما توصي به وثائق JMeter لأي اختبار حمل:
jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. سجّل زمن الاستجابة p95 ومعدل الأخطاء. - نظّف الخطة. عطّل المستمعين (Listeners) وأزل الفروع الميتة. انقل الأسرار (Secrets) خارج الملف.
- استوردها. استخدم نافذة الاستيراد في التطبيق أو
apidog import --project <projectId> --format jmeter --file ./checkout.jmx. - راجع ما تم استيراده. اعرض نقاط النهاية وسيناريوهات الاختبار، ثم قارنها بشجرة
.jmxباستخدام الجدول أعلاه. - أصلح الفجوات. أعد كتابة مراجع
${}، وحوّل السكربتات إلى JavaScript، وأرفق بيانات CSV كبيانات اختبار، وأضف خطوات انتظار. - شغّلها وظيفيًا. لا فائدة من اختبار أداء ما لم ينجح كل طلب بمفرده، وتقول وثائق Apidog الشيء نفسه.
- اختبر الحمل. في التطبيق، حدد المستخدمين الافتراضيين والمدة ومدة التدرّج للسيناريو، وقارن p95 ومعدل الأخطاء مع خط أساس JMeter لديك عند نفس عدد المستخدمين.
- اربطه بـ CI باستخدام
apidog runوتقرير JUnit.
دع وكيل البرمجة لديك ينجز الترحيل باستخدام Apidog CLI
الخطوات من 3 إلى 6 ميكانيكية، مما يجعلها عملًا مثاليًا للوكيل البرمجي. يمكن لـ Claude Code أو Codex أو Cursor قراءة ملف XML الخاص بـ .jmx، وتشغيل الاستيراد، ومقارنة النتيجة، وسد الفجوات بينما أنت تراجع.
جهّز البيئة مرة واحدة:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
تعلم المهارة (Skill) وكيلك البرمجي أوامر سطر الأوامر ومخططاتها (Schemas). وإذا كنت تفضل أن يتولى الوكيل الإعداد أيضًا، قل له: "اقرأ https://apidog.com/apidog-cli-installation-guide.md وثبّت Apidog CLI." يغطي دليل تثبيت Apidog CLI الخطوات نفسها للبشر.
ثم أعطِ وكيلك تعليمات واحدة من المجلد الذي يحتوي على الخطة:
Import ./checkout.jmx into Apidog project <projectId> with the jmeter format.
Then list what was created and compare it with the .jmx: every HTTP sampler,
extractor, assertion, CSV data set and controller. Fix variable syntax,
rewrite any Groovy JSR223 scripts as JavaScript, and give me a table of
anything that did not carry over. Finally run the checkout scenario against
the staging environment and summarize failures.
ينفذ الوكيل أوامر مثل هذه:
apidog import --project <projectId> --format jmeter --file ./checkout.jmx
apidog endpoint list --project <projectId>
apidog test-scenario list --project <projectId>
apidog environment list --project <projectId>
apidog cli-schema get test-scenario-create
apidog run -t <scenarioId> --project <projectId> -e <envId> -r cli,json
هناك وسيطان مهمان لعمليات الاستيراد المتكررة. يحدد --overwrite-mode استراتيجية التعامل مع التعارضات (overwrite أو merge أو ignore أو keepBoth، والقيمة الافتراضية overwrite)، ويسمح لك --branch بالاستيراد إلى فرع سبرنت بحيث لا يمس الترحيل الفرع الرئيسي حتى تراجعه. قبل كتابة أي حمولة JSON، يجب أن ينفذ الوكيل apidog cli-schema get وapidog cli-schema validate؛ فتقول مساعدة سطر الأوامر نفسها عدم بناء الحمولات من الذاكرة. لإلقاء نظرة أعمق على سير العمل هذا، انظر Apidog CLI في Claude Code.
شغّل الاختبارات المهاجرة في CI
بمجرد نجاح السيناريو محليًا، يصبح تشغيله في CI أمرًا بسيطًا بخطوة واحدة. يكتب apidog run تقارير بصيغ cli أو html أو json أو junit، وتقرير JUnit هو ما تقرأه GitHub Actions وGitLab وJenkins بشكل أصلي:
apidog run -t <scenarioId> --project <projectId> -e <envId> \
-r cli,junit --out-dir apidog-reports --upload-report
يرسل الوسيط --upload-report ملخص التشغيل إلى السحابة ليتمكن فريقك من فتحه في التطبيق. أما التشغيلات المبنية على البيانات فتقبل -d مع ملف CSV أو JSON أو معرّف بيانات اختبار، وهو ما يحل محل CSV Data Set الخاص بـ JMeter في خط الأنابيب. يقبل --on-error القيم ignore أو continue أو end. يحتوي دليل خط أنابيب CI/CD في Apidog CLI على ملفات سير عمل كاملة، ويغطي مرجع أمر apidog run كل وسيط.
احتفظ بتشغيل JMeter بالتوازي لدورة إصدار أو دورتين. عندما تلتقط مجموعة Apidog نفس حالات الانحدار وتتطابق أرقام الأحمال لديك عند نفس عدد المستخدمين، تقاعد ملفات .jmx المقابلة. وإذا كنت لا تزال تزن الخيارات بين الأدوات، فإن ملخص بدائل JMeter يقارن بينها.
الأسئلة الشائعة
هل يستورد Apidog ملفات .jmx مباشرة؟ نعم. JMeter صيغة استيراد مدرجة في وثائق Apidog، ويقبل Apidog CLI الأمر apidog import --format jmeter --file <path>. راجع النتيجة مقابل الخطة الأصلية، لأن الوثائق لا تنشر جدول مطابقة عنصرًا بعنصر.
هل يمكنني تصدير اختبارات Apidog مرة أخرى إلى JMeter؟ نعم. تقول وثائق Apidog إن سيناريوهات الاختبار يمكن تصديرها كملفات بيانات Apidog CLI وPostman وJMeter، لذا يمكنك تشغيلها في JMeter إذا كان فريق ما لا يزال بحاجة إليها.
كم عدد المستخدمين الافتراضيين الذين يدعمهم Apidog لاختبارات الأحمال؟ تقول وثائق اختبار الأداء إنه حتى 100 مستخدم افتراضي لكل تشغيل، والميزة لا تزال في المرحلة التجريبية. احتفظ بـ JMeter للاختبارات الموزعة التي تتجاوز ذلك.
ماذا يحدث لسكربتات Groovy الخاصة بي؟ لا تعمل في Apidog. أعد كتابتها كسكربتات معالجة أولية أو لاحقة بلغة JavaScript، تستخدم واجهة برمجة pm على نمط Postman. يمكن لوكلاء البرمجة ترجمة معظم مقاطع JSR223 بسرعة؛ لكن راجع المخرجات.
هل أحتاج إلى تغيير صيغة المتغيرات؟ نعم. يستخدم JMeter ${var} ويستخدم Apidog {{var}}. ابحث في السيناريو المهاجر عن أي ${ متبقٍ قبل أول تشغيل.
هل Apidog مجاني لهذا الغرض؟ تغطي خطة Apidog المجانية حتى 4 مستخدمين، وهو ما يكفي لترحيل المجموعة الوظيفية لفريقك وتشغيلها في CI.
