كيفية نقل اختبارات JMeter إلى Apidog

انقل اختبارات JMeter إلى Apidog: استورد ملف .jmx، وطابق مجموعات الخيوط (thread groups) والمستخرجات والتأكيدات (assertions)، وأصلح ما لا يُنقل تلقائيًا، ثم شغّل الاختبارات في CI باستخدام Apidog CLI.

INEZA Felin-Michel

INEZA Felin-Michel

16 نوفمبر 2026

كيفية نقل اختبارات JMeter إلى Apidog

Apidog للمؤسسات

النشر على الخوادم المحلية

SSO و RBAC

متوافق مع SOC 2

استكشف Apidog للمؤسسات

لترحيل اختبارات JMeter إلى Apidog، استورد ملف .jmx (يُدرج Apidog صيغة JMeter ضمن الصيغ المدعومة للاستيراد، كما يقبل Apidog CLI الوسيط --format jmeter)، وراجع ما تم استيراده، وأعد بناء التدفق كسيناريو اختبار، ثم تأكد من نجاحه في تشغيل وظيفي قبل تحميله لاختبار الأحمال. المؤقتات (Timers) وسكربتات Groovy وأدوات أخذ العينات غير HTTP تحتاج إلى عمل يدوي.

في الأسفل: ما يحتويه ملف .jmx، وكيفية مطابقة كل عنصر، وأين يفشل التطابق، وكيف يمكن لوكيل البرمجة لديك إنجاز العمل باستخدام Apidog CLI.

ماذا يحتوي ملف JMeter .jmx؟

ملف .jmx هو خطة اختبار JMeter المحفوظة: شجرة XML من العناصر ينفذها JMeter من الأعلى إلى الأسفل. يحدد دليل مستخدم JMeter وحدات البناء الأساسية. كل طلب يقع تحت مجموعة خيوط (Thread Group)، وكل عنصر آخر يغيّر كيفية إرسال تلك الطلبات أو التحقق منها أو توقيتها.

إليك ما ستجده عند فتح أحد هذه الملفات:

إذا كنت بحاجة إلى تذكير بالأداة نفسها، اقرأ ما هو 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. يوضح الجدول موقع كل عنصر بعد الترحيل وما يجب التحقق منه بمجرد اكتمال الاستيراد.

Diagram mapping six JMeter elements to their Apidog equivalents: HTTP Request sampler to request step, User Defined Variables to environment variables, Response Assertion to assertion, Thread Group to virtual users, CSV Data Set Config to test data, Constant Timer to wait step
عنصر 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 ليس لها مكافئ مباشر، والتظاهر بغير ذلك هو ما يُفسد عمليات الترحيل. خطط لهذه الحالات:

  1. سكربتات Groovy وBeanShell. سكربتات المعالجة الأولية واللاحقة في Apidog تعمل بلغة JavaScript مع واجهة برمجة pm على نمط Postman. أعد كتابة منطق JSR223 بلغة JavaScript؛ ووكيل البرمجة لديك بارع تحديدًا في هذا النوع من التحويل.
  2. أدوات أخذ العينات غير HTTP. أدوات أخذ العينات FTP وLDAP وTCP وJMS تختبر بروتوكولات خارج نطاق عميل API. احتفظ بتلك الأدوات في JMeter. يمكن غالبًا تحويل فحوصات JDBC إلى عمليات قواعد بيانات في Apidog (MySQL وMongoDB وRedis وOracle موثقة)، لكن أعد بناءها بشكل مدروس.
  3. تشكيل الإنتاجية (Throughput shaping). تضبط مؤقتات JMeter ومتحكمات الإنتاجية ومجموعات الخيوط الإضافية معدل الطلبات بدقة. أما اختبار الأداء في Apidog فيحدد المستخدمين الافتراضيين والمدة ومدة التدرّج، ويمر كل مستخدم عبر السيناريو في حلقات. توقّع أرقام طلبات في الثانية مختلفة.
  4. التوسع إلى ما بعد 100 مستخدم افتراضي. هذا هو الحد الأقصى الموثق لاختبارات الأداء في Apidog حاليًا.
  5. تصدير تقارير لاختبارات الأحمال. تقول المستندات إن تقارير الأداء لا يمكن تصديرها بعد؛ بل تُعرض داخل العميل. أما التشغيلات الوظيفية من سطر الأوامر فيمكنها تصدير HTML وJSON وJUnit.

لا شيء من هذا يمنع الترحيل؛ بل يحدد أي الاختبارات تنتقل. عادةً ما تنتقل المجموعة الوظيفية وتبقى بعض خطط الأحمال القصوى. يعرض برنامج JMeter التعليمي لاختبار API نوع الخطة الوظيفية التي تنتقل بسهولة.

خطوة بخطوة: ترحيل خطة اختبار JMeter

إليك المسار الكامل، من .jmx إلى مهمة CI خضراء (ناجحة).

Flow diagram of the migration: checkout.jmx, then apidog import with the jmeter format, then a test scenario, then a functional run with apidog run, then a performance test and CI
  1. سجّل خط أساس (Baseline). شغّل الخطة مرة واحدة في وضع سطر الأوامر، وهو ما توصي به وثائق JMeter لأي اختبار حمل: jmeter -n -t checkout.jmx -l baseline.jtl -e -o baseline-report/. سجّل زمن الاستجابة p95 ومعدل الأخطاء.
  2. نظّف الخطة. عطّل المستمعين (Listeners) وأزل الفروع الميتة. انقل الأسرار (Secrets) خارج الملف.
  3. استوردها. استخدم نافذة الاستيراد في التطبيق أو apidog import --project <projectId> --format jmeter --file ./checkout.jmx.
  4. راجع ما تم استيراده. اعرض نقاط النهاية وسيناريوهات الاختبار، ثم قارنها بشجرة .jmx باستخدام الجدول أعلاه.
  5. أصلح الفجوات. أعد كتابة مراجع ${}، وحوّل السكربتات إلى JavaScript، وأرفق بيانات CSV كبيانات اختبار، وأضف خطوات انتظار.
  6. شغّلها وظيفيًا. لا فائدة من اختبار أداء ما لم ينجح كل طلب بمفرده، وتقول وثائق Apidog الشيء نفسه.
  7. اختبر الحمل. في التطبيق، حدد المستخدمين الافتراضيين والمدة ومدة التدرّج للسيناريو، وقارن p95 ومعدل الأخطاء مع خط أساس JMeter لديك عند نفس عدد المستخدمين.
  8. اربطه بـ 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.

ممارسة تصميم API في Apidog

اكتشف طريقة أسهل لبناء واستخدام واجهات برمجة التطبيقات