Genkit 모니터링 시작하기

이 빠른 시작 가이드에서는 실시간 원격 분석 데이터를 수집하고 볼 수 있도록 배포된 Genkit 기능에 Firebase Genkit Monitoring을 설정하는 방법을 설명합니다. Firebase Genkit 모니터링을 사용하면 프로덕션에서 Genkit 기능이 실행되는 방식을 확인할 수 있습니다.

Firebase Genkit 모니터링의 주요 기능은 다음과 같습니다.

• Genkit 기능 지연 시간, 오류, 토큰 사용량과 같은 정량적 측정항목 보기
• 디버깅 및 품질 개선에 도움이 되도록 트레이스를 검사하여 Genkit의 기능 단계, 입력, 출력을 확인합니다.
• 프로덕션 트레이스를 내보내 Genkit 내에서 평가를 실행합니다.

Genkit 모니터링을 설정하려면 코드베이스와 Google Cloud 콘솔에서 모두 태스크를 완료해야 합니다.

시작하기 전에

1. 아직 Firebase 프로젝트가 없는 경우 프로젝트를 만드세요.

   Firebase Console에서 프로젝트 추가를 클릭한 후 화면에 표시된 안내를 따릅니다. 새 프로젝트를 만들거나 기존 Google Cloud 프로젝트에 Firebase 서비스를 추가할 수 있습니다.

2. 프로젝트가 Blaze 요금제를 사용하는지 확인합니다.

   Genkit Monitoring은 유료 서비스인 Google Cloud Logging, Metrics, Trace에 작성된 원격 분석 데이터를 사용합니다. 가격 책정 세부정보와 무료 등급 한도에 대해 알아보려면 Google Cloud Observability 가격 책정 페이지를 참고하세요.

3. 시작 가이드에 따라 Genkit 기능을 작성하고 다음 가이드 중 하나를 사용하여 배포할 코드를 준비합니다.

   1. Firebase용 Cloud Functions를 사용하여 흐름 배포
   2. Cloud Run을 사용하여 흐름 배포
   3. 모든 Node.js 플랫폼에 흐름 배포

1단계: Firebase 플러그인 추가

프로젝트에 @genkit-ai/firebase 플러그인을 설치합니다.

npm i –save @genkit-ai/firebase

enableFirebaseTelemetry를 Genkit 구성 파일 (genkit(...)가 초기화되는 파일)로 가져와 호출합니다.

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

enableFirebaseTelemetry();

2단계: 필요한 API 사용 설정

GCP 프로젝트에 다음 API가 사용 설정되어 있는지 확인합니다.

• Cloud Logging API
• Cloud Trace API
• Cloud Monitoring API

이러한 API는 프로젝트의 API 대시보드에 표시되어야 합니다.

3단계: 권한 설정

Firebase 플러그인은 서비스 계정을 사용하여 Google Cloud Logging, Metrics, Trace 서비스에 인증해야 합니다.

Google Cloud IAM 콘솔에서 코드를 실행하도록 구성된 서비스 계정에 다음 역할을 부여합니다. Firebase용 Cloud Functions 또는 Cloud Run의 경우 일반적으로 기본 컴퓨팅 서비스 계정입니다.

• 모니터링 측정항목 작성자 (roles/monitoring.metricWriter)
• Cloud Trace 에이전트 (roles/cloudtrace.agent)
• 로그 작성자 (roles/logging.logWriter)

4단계: (선택사항) 로컬에서 구성 테스트

배포하기 전에 Genkit 코드를 로컬에서 실행하여 원격 분석 데이터가 수집되고 Genkit 모니터링 대시보드에서 볼 수 있는지 확인할 수 있습니다.

1. Genkit 코드에서 forceDevExport를 true로 설정하여 로컬 환경에서 원격 분석을 전송합니다.

2. 서비스 계정을 사용하여 구성을 인증하고 테스트합니다.

   도움말: 서비스 계정을 가장하려면 사용자 계정에 roles/iam.serviceAccountTokenCreator IAM 역할이 적용되어 있어야 합니다.

   Google Cloud CLI 도구를 사용하여 서비스 계정으로 인증합니다.

   gcloud auth application-default login --impersonate-service-account <SERVICE_ACCT_EMAIL>
   

3. Genkit 기능을 실행하고 호출한 다음 Genkit 모니터링 대시보드에서 측정항목을 확인합니다. 첫 번째 측정항목을 수집하는 데 최대 5분이 걸릴 수 있습니다. 원격 분석 구성에서 metricExportIntervalMillis를 설정하여 이 지연을 줄일 수 있습니다.

4. Genkit 모니터링 대시보드에 측정항목이 표시되지 않으면 디버그 단계에 관한 문제 해결 가이드를 참고하세요.

5단계: 코드 다시 빌드 및 배포

Genkit 기능을 다시 빌드하고 배포 및 호출하여 데이터 수집을 시작하세요. Genkit Monitoring에서 측정항목을 수신하면 Genkit Monitoring 대시보드를 방문하여 측정항목을 확인할 수 있습니다.

참고: 첫 번째 측정항목을 수집하는 데 최대 5분이 걸릴 수 있습니다 (원격 분석 구성의 기본 metricExportIntervalMillis 설정에 따라).