고급 구성

이 가이드에서는 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 제로 코드 계측을 사용하여 인기 있는 프레임워크의 trace 및 측정항목을 자동으로 수집합니다.

사용 가능한 계측의 전체 목록은 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 },
  }
});

원격 분석 사용 중지

Firebase Genkit 모니터링은 로깅, 추적, 측정항목을 조합하여 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 Tracing에 있는 트레이스를 볼 수 없습니다.