إعداد متقدم

يركز هذا الدليل على خيارات الضبط المتقدّمة للميزات المنشورة باستخدام مكوّن إضافي لقياس أداء Firebase. يمكنك العثور على أوصاف تفصيلية لكل خيار من خيارات الضبط في مستندات JS API المرجعية.

ستوضّح هذه المستندات كيفية ضبط بيانات القياس التي يتم جمعها، وعدد المرات التي يتم فيها جمعها، والبيئات التي يتم جمعها منها.

الإعدادات التلقائية

يوفّر المكوّن الإضافي لقياس أداء Firebase خيارات تلقائية، بدون الحاجة إلى أي إعدادات، لمساعدتك في بدء استخدام الميزة بسرعة. في ما يلي الإعدادات التلقائية المقدَّمة:

{
  autoInstrumentation: true,
  autoInstrumentationConfig: {
    '@opentelemetry/instrumentation-dns': { enabled: false },
  }
  disableMetrics: false,
  disableTraces: false,
  disableLoggingInputAndOutput: false,
  forceDevExport: false,
  // 5 minutes
  metricExportIntervalMillis: 300_000,
  // 5 minutes
  metricExportTimeoutMillis: 300_000,
  // See https://js.api.genkit.dev/interfaces/_genkit-ai_google-cloud.GcpTelemetryConfigOptions.html#sampler
  sampler: AlwaysOnSampler()
}

تصدير بيانات القياس المحلية

لتصدير بيانات القياس عند التشغيل على الجهاز، اضبط الخيار forceDevExport على true.

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({forceDevExport: true});

أثناء التطوير والاختبار، يمكنك تقليل وقت الاستجابة من خلال تعديل فاصل ملف التصدير ومهلة التصدير.

ملاحظة: قد يؤدي الشحن إلى قناة الإصدار العلني مع فترة تصدير متكرّرة إلى زيادة تكلفة البيانات الوصفية التي يتم تصديرها.

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({
  forceDevExport: true,
  metricExportIntervalMillis: 10_000, // 10 seconds
  metricExportTimeoutMillis: 10_000 // 10 seconds
});

ضبط الأدوات التلقائية

سيجمع المكوّن الإضافي لقياس الأداء في Firebase تلقائيًا عمليات التتبّع والمقاييس ل الإطارات العمل الشائعة باستخدام أدوات القياس بدون رموز في OpenTelemetry.

يمكن العثور على قائمة كاملة بالأدوات المتاحة في مستندات auto-instrumentations-node.

لإيقاف أو تفعيل عمليات القياس المؤهَّلة للقياس التلقائي بشكل انتقائي، عدِّل الحقل autoInstrumentationConfig:

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({
  autoInstrumentationConfig: {
    '@opentelemetry/instrumentation-fs': { enabled: false },
    '@opentelemetry/instrumentation-dns': { enabled: false },
    '@opentelemetry/instrumentation-net': { enabled: false },
  }
});

إيقاف ميزة "القياس عن بُعد"

تستفيد ميزة "مراقبة Genkit في Firebase" من مجموعة من عمليات التسجيل والتتبّع والقياسات للحصول على نظرة شاملة على تفاعلاتك مع Genkit، ومع ذلك، يمكنك أيضًا إيقاف كلّ عنصر من هذه العناصر بشكل مستقل إذا لزم الأمر.

إيقاف تسجيل الإدخال والإخراج

سيسجِّل المكوّن الإضافي لقياس أداء Firebase تلقائيًا المدخلات والمخرجات لكل ميزة أو خطوة في Genkit.

لمساعدتك في التحكّم في كيفية تخزين بيانات العملاء، يمكنك إيقاف تسجيل المدخلات والمخرجات من خلال إضافة ما يلي إلى الإعدادات:

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({
  disableLoggingInputAndOutput: true
});

عند ضبط هذا الخيار، ستتم إزالة سمات الإدخال والإخراج في أداة عرض عمليات التتبّع في مراقبة Firebase Genkit ولن تظهر في سجلّات Google Cloud.

إيقاف المقاييس

لإيقاف جمع المقاييس، أضِف ما يلي إلى الإعدادات:

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({
  disableMetrics: true
});

عند ضبط هذا الخيار، لن تظهر لك مقاييس الثبات في لوحة تحكم مراقبة Firebase Genkit ولن تظهر في قياسات Google Cloud.

إيقاف عمليات التتبُّع

لإيقاف جمع عمليات التتبّع، أضِف ما يلي إلى الإعدادات:

import { enableFirebaseTelemetry } from '@genkit-ai/firebase';

enableFirebaseTelemetry({
  disableTraces: true
});

عند ضبط هذا الخيار، لن تظهر لك عمليات التتبّع في صفحة ميزة "مراقبة" في Firebase Genkit ، ولن تتمكّن من الوصول إلى أداة عرض عمليات التتبّع أو الاطّلاع على عمليات التتبّع المتوفّرة في أداة "تتبّع Google Cloud".