دليل Fastify مع AllStak

التثبيت

ثبّت الحزمة و Fastify.

npm install @allstak/fastify fastify

الإعداد

سجّل الإضافة قبل مساراتك.

import Fastify from 'fastify';
import allstakFastify from '@allstak/fastify';

const app = Fastify();

await app.register(allstakFastify, {
  apiKey: process.env.ALLSTAK_API_KEY,
  environment: process.env.NODE_ENV ?? 'production',
  release: process.env.ALLSTAK_RELEASE,
  serviceName: 'checkout-api',
  captureRequestHeaders: true,
});

مثال أساسي

يتضمّن الريبو مثالًا قابلًا للتشغيل في examples/fastify-demo/server.ts.

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

تُلتقط الأخطاء تلقائيًا عبر خطّاف onError للإضافة. والتقط يدويًا عبر captureException المُصدَّر.

import { captureException } from '@allstak/fastify';

captureException(new Error('checkout failed'), { level: 'error' });

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

تستخدم الإضافة خطّافات onRequest/onResponse/onError في Fastify لالتقاط الطريقة والمسار والحالة والمدّة وspans الخادم، وتحقن ترويسات الانتشار في الاستجابة (traceparent، baggage). تلقائي — لا حاجة لخطّاف يدوي.

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

• سجّل الإضافة قبل تعريف المسارات.
• اضبط serviceName و release.
• يضيف captureRequestHeaders سياق ترويسات الطلب عند الحاجة.