Hướng dẫn này tập trung vào các tuỳ chọn cấu hình nâng cao cho các tính năng đã triển khai bằng cách sử dụng trình bổ trợ đo từ xa Firebase. Bạn có thể xem nội dung mô tả chi tiết về từng tuỳ chọn cấu hình trong tài liệu tham khảo về API JS của chúng tôi.
Tài liệu này sẽ mô tả cách điều chỉnh thông tin đo từ xa được thu thập, tần suất thu thập và từ những môi trường nào.
Cấu hình mặc định
Trình bổ trợ đo từ xa Firebase cung cấp các tuỳ chọn mặc định ngay từ đầu để giúp bạn nhanh chóng bắt đầu sử dụng. Dưới đây là các giá trị mặc định được cung cấp:
{
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()
}
Xuất dữ liệu đo từ xa cục bộ
Để xuất dữ liệu đo từ xa khi chạy cục bộ, hãy đặt tuỳ chọn forceDevExport thành
true.
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({forceDevExport: true});
Trong quá trình phát triển và kiểm thử, bạn có thể giảm độ trễ bằng cách điều chỉnh khoảng thời gian xuất và thời gian chờ.
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({
forceDevExport: true,
metricExportIntervalMillis: 10_000, // 10 seconds
metricExportTimeoutMillis: 10_000 // 10 seconds
});
Điều chỉnh tính năng đo lường tự động
Trình bổ trợ đo từ xa Firebase sẽ tự động thu thập dấu vết và chỉ số cho các khung phổ biến bằng cách sử dụng công cụ đo lường không mã OpenTelemetry.
Bạn có thể xem danh sách đầy đủ các công cụ đo lường có sẵn trong tài liệu về auto-instrumentations-node.
Để chọn tắt hoặc bật các hoạt động đo lường đủ điều kiện cho hoạt động đo lường tự động, hãy cập nhật trường autoInstrumentationConfig:
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({
autoInstrumentationConfig: {
'@opentelemetry/instrumentation-fs': { enabled: false },
'@opentelemetry/instrumentation-dns': { enabled: false },
'@opentelemetry/instrumentation-net': { enabled: false },
}
});
Tắt tính năng đo từ xa
Tính năng Theo dõi Genkit của Firebase tận dụng kết hợp tính năng ghi nhật ký, theo dõi và đo lường để nắm bắt thông tin tổng quan về các hoạt động tương tác của bạn với Genkit. Tuy nhiên, bạn cũng có thể tắt từng phần tử này một cách độc lập nếu cần.
Tắt tính năng ghi nhật ký đầu vào và đầu ra
Theo mặc định, trình bổ trợ đo từ xa Firebase sẽ ghi lại dữ liệu đầu vào và đầu ra cho từng tính năng hoặc bước Genkit.
Để giúp bạn kiểm soát cách lưu trữ dữ liệu khách hàng, bạn có thể tắt tính năng ghi nhật ký đầu vào và đầu ra bằng cách thêm nội dung sau vào cấu hình:
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({
disableLoggingInputAndOutput: true
});
Khi bạn đặt tuỳ chọn này, các thuộc tính đầu vào và đầu ra sẽ bị loại bỏ trong trình xem dấu vết theo dõi Firebase Genkit và sẽ bị thiếu trong nhật ký Google Cloud.
Tắt chỉ số
Để tắt tính năng thu thập chỉ số, hãy thêm nội dung sau vào cấu hình:
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({
disableMetrics: true
});
Khi đặt tuỳ chọn này, bạn sẽ không còn thấy các chỉ số về độ ổn định trong trang tổng quan của công cụ Giám sát Genkit của Firebase và các chỉ số này sẽ biến mất khỏi Google Cloud Metrics.
Tắt dấu vết
Để tắt tính năng thu thập dấu vết, hãy thêm nội dung sau vào cấu hình:
import { enableFirebaseTelemetry } from '@genkit-ai/firebase';
enableFirebaseTelemetry({
disableTraces: true
});
Khi đặt tuỳ chọn này, bạn sẽ không còn thấy dấu vết trong trang tính năng Theo dõi Genkit của Firebase, không có quyền truy cập vào trình xem dấu vết hoặc không thấy dấu vết trong tính năng Theo dõi trên Google Cloud.