NestJS — تتبّع الطلبات

​

مقدمة

​

التفعيل

LerixModule.forRoot({
  apiKey: process.env.LERIX_API_KEY!,
  projectId: process.env.LERIX_PROJECT_ID!,
  tracing: { enabled: true },
})

LerixModule.forRootAsync({
  tracing: true,
  useFactory: (config: ConfigService) => ({ ...config.get('lerix'), tracing: { enabled: true } }),
  inject: [ConfigService],
})

​

ما الذي يُسجَّل

• نطاق خادم واحد لكل طلب، ينشئه معترض عام ويُسمّى بحسب قالب المسار من مسارَي المتحكّم والمعالج (GET /users/:id) لا بحسب الرابط. البادئة العامة للتطبيق ليست جزءاً من الاسم. تُواصَل ترويسة traceparent الواردة.
• PostgreSQL — يُعدَّل مشغّل pg الخاص بالتطبيق (يُعثر عليه من مجلد العمل؛ لا يُضاف شيء إلى اعتمادياتك)، وهو ما يغطي Drizzle وTypeORM وKnex وpg المباشر. يصبح كل استعلام نطاق client باسم قالب SQL؛ لا تُسجَّل المعاملات ولا الصفوف أبداً.
• fetch الخارجي — يصبح كل استدعاء نطاق client باسم METHOD host ويحمل ترويسة traceparent. تُتجاهل الاستدعاءات إلى Lerix API نفسها.

tracing: { enabled: true, instrumentations: { pg: true, fetch: false } }

const handle = this.lerix.tracing?.tracer.startChild('cache get', 'client', { 'server.address': 'redis' });
try {
  await cache.get(key);
  handle?.end('ok');
} catch (error) {
  handle?.end('error', { 'error.type': (error as Error).name });
  throw error;
}

​

التتبّع الحالي

import { current } from '@lerix-dev/lerix-nestjs';

this.logger.log(`handling order, trace ${current()?.traceId}`);

​

أخذ العينات

​

الأخطاء والتتبّعات

​

عناوين العملاء

​

خيارات المصدّر

​

الحِمل الإضافي