پیکربندی پیشرفته

این راهنما بر روی گزینه‌های پیکربندی پیشرفته برای ویژگی‌های مستقر شده با استفاده از پلاگین تله متری 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 جمع آوری می کند.

فهرست کامل ابزار دقیق موجود را می توان در مستندات خودکار ابزار دقیق گره یافت.

برای غیرفعال کردن یا فعال کردن انتخابی ابزار دقیقی که برای ابزار دقیق خودکار واجد شرایط هستند، فیلد autoInstrumentationConfig را به روز کنید:

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

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

غیرفعال کردن تله متری

Firebase Genkit Monitoring از ترکیبی از گزارش‌گیری، ردیابی و معیارها استفاده می‌کند تا یک نمای کلی از تعاملات Genkit شما را به تصویر بکشد، با این حال، در صورت نیاز می‌توانید هر یک از این عناصر را به‌طور مستقل غیرفعال کنید.

غیرفعال کردن گزارش ورودی و خروجی

به طور پیش فرض، پلاگین تله متری Firebase ورودی ها و خروجی ها را برای هر ویژگی یا مرحله Genkit می گیرد.

برای کمک به کنترل نحوه ذخیره داده های مشتری، می توانید با افزودن موارد زیر به پیکربندی خود، ثبت ورودی و خروجی را غیرفعال کنید:

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

enableFirebaseTelemetry({
  disableLoggingInputAndOutput: true
});

با تنظیم این گزینه، ویژگی‌های ورودی و خروجی در نمایشگر ردیابی Firebase Genkit Monitoring ویرایش می‌شوند و در گزارش Google Cloud وجود ندارند.

معیارها را غیرفعال کنید

برای غیرفعال کردن مجموعه معیارها، موارد زیر را به پیکربندی خود اضافه کنید:

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

enableFirebaseTelemetry({
  disableMetrics: true
});

با تنظیم این گزینه، دیگر معیارهای ثبات را در داشبورد مانیتورینگ Firebase Genkit نخواهید دید و در Google Cloud Metrics غایب خواهید بود.

ردیابی را غیرفعال کنید

برای غیرفعال کردن مجموعه ردیابی، موارد زیر را به پیکربندی خود اضافه کنید:

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

enableFirebaseTelemetry({
  disableTraces: true
});

با تنظیم این گزینه، دیگر ردپایی را در صفحه ویژگی Firebase Genkit Monitoring نخواهید دید، به نمایشگر ردیابی دسترسی نخواهید داشت، یا ردیابی های موجود در Google Cloud Tracing را مشاهده نخواهید کرد.