دليل Angular مع AllStak

التثبيت

ثبّت من npm.

npm install @allstak/angular

الإعداد

استدعِ init في main.ts قبل إقلاع التطبيق.

import { init } from '@allstak/angular';
import { bootstrapApplication } from '@angular/platform-browser';
import { AppComponent } from './app/app.component';
import { appConfig } from './app/app.config';

init({ apiKey: 'your-ingest-key', environment: 'production' });

bootstrapApplication(AppComponent, appConfig);

مثال أساسي

سجّل المزوّدات (واجهة standalone).

import {
  provideAllStak,
  provideAllStakErrorHandler,
  provideAllStakRouterInstrumentation,
  allStakHttpInterceptor,
} from '@allstak/angular';

export const appConfig = {
  providers: [
    provideRouter(routes),
    provideAllStak({ apiKey: 'your-ingest-key', environment: 'production' }),
    provideAllStakErrorHandler(),
    provideAllStakRouterInstrumentation(),
    provideHttpClient(withInterceptors([allStakHttpInterceptor])),
  ],
};

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

استخدم provideAllStakErrorHandler() (أو createErrorHandler) لتمرير الأخطاء غير الملتقطة؛ والتقط يدويًا عبر AllStak.captureException.

import { ErrorHandler } from '@angular/core';
import { createErrorHandler } from '@allstak/angular';

providers: [
  { provide: ErrorHandler, useValue: createErrorHandler({ logErrors: true }) },
];

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

أضف معترض HTTP لتسجيل كل طلب صادر وفتح span من نوع http.client — استخدم allStakHttpInterceptor الوظيفي مع withInterceptors، أو الصنف AllStakHttpInterceptor مع HTTP_INTERCEPTORS.

provideHttpClient(withInterceptors([allStakHttpInterceptor]))

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

• استدعِ init() قبل bootstrapApplication.
• أضف معترض HTTP لتتبّع النداءات الصادرة.
• اضبط release للتجميع لكل نشر.