دليل Express مع AllStak

التثبيت

ثبّت الحزمة والحزمة الأساسية (peer: express >=4).

npm install @allstak/express @allstak/js

الإعداد

استدعِ allstakExpress(app, options) — يهيّئ @allstak/js ويثبّت معالج الطلبات أولًا ومعالج الأخطاء أخيرًا نيابةً عنك.

import express from 'express';
import { allstakExpress } from '@allstak/express';

const app = express();

allstakExpress(app, {
  apiKey: process.env.ALLSTAK_API_KEY,
  environment: process.env.NODE_ENV ?? 'production',
  release: process.env.ALLSTAK_RELEASE,
  serviceName: 'api',
});

مثال أساسي

ذلك النداء الواحد يربط كل شيء؛ عرّف مساراتك بعده.

التقاط الأخطاء

تُلتقط الأخطاء المرمية و next(err) عبر معالج الأخطاء المُثبَّت تلقائيًا. والتقط يدويًا عبر AllStak.captureException المُعاد تصديره.

import { AllStak } from '@allstak/express';

AllStak.captureException(new Error('checkout failed'));

تتبّع الطلبات

معالج الطلبات (يُثبَّت أولًا عبر allstakExpress) يسجّل كل طلب وارد عبر AllStak.captureRequest عند انتهاء الاستجابة ويفتح span من نوع http.server مُسمّى بنمط المسار.

أفضل الممارسات

• استدعِ allstakExpress(app, …) قبل تعريف المسارات.
• اضبط serviceName و release في الخيارات.
• استخدم init: false / mountErrorHandler: false للتحكّم اليدوي المتقدّم.