دليل Astro مع AllStak

التثبيت

ثبّت من npm (يتطلّب astro@>=3.5).

npm install @allstak/astro

الإعداد

أضف التكامل في astro.config.mjs.

import { defineConfig } from 'astro/config';
import allstak from '@allstak/astro';

export default defineConfig({
  integrations: [
    allstak({
      apiKey: process.env.ALLSTAK_API_KEY,
      environment: process.env.NODE_ENV,
      release: process.env.npm_package_version,
    }),
  ],
});

مثال أساسي

التقط الأخطاء في الـ frontmatter أو شيفرة الخادم عبر مساحة الاسم AllStak.

---
import { AllStak } from '@allstak/astro';

try {
  await loadDashboard();
} catch (err) {
  AllStak.captureException(err, { page: 'dashboard' });
  throw err;
}
---

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

في مخرجات SSR، تُلتقط أخطاء عرض الخادم تلقائيًا عبر وسيط التكامل؛ والتقط يدويًا عبر AllStak.captureException.

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

في مخرجات الخادم (SSR)، يغلّف الوسيط كل طلب في span من نوع http.server يسجّل الطريقة والمسار والحالة. أما المخرجات الثابتة فلا خطّ طلبات فيها لتجهيزه.

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

• اضبط ALLSTAK_API_KEY في البيئة.
• يغطّي autoInstrumentServer (الافتراضي true) مراقبة طلبات SSR.
• اضبط release لتجميع الأخطاء لكل نشر.