Genkit Monitoring'i kullanmaya başlama

Bu hızlı başlangıç kılavuzunda, dağıtılan Genkit özellikleriniz için Firebase Genkit İzleme'nin nasıl ayarlanacağı açıklanmaktadır. Böylece gerçek zamanlı telemetri verilerini toplayabilir ve görüntüleyebilirsiniz. Firebase Genkit İzleme ile Genkit özelliklerinizin üretimde nasıl performans gösterdiğini görebilirsiniz.

Firebase Genkit Monitoring'in temel özellikleri şunlardır:

  • Genkit özelliği gecikme süresi, hatalar ve jeton kullanımı gibi nicel metrikleri görüntüleme.
  • Hata ayıklama ve kalite iyileştirmeye yardımcı olmak için Genkit'inizin özellik adımlarını, girişlerini ve çıkışlarını görmek üzere izlemleri inceleme
  • Genkit'te değerlendirme çalıştırmak için üretim izlemelerini dışa aktarma.

Genkit Monitoring'i ayarlamak için hem kod tabanınızdaki hem de Google Cloud Console'daki görevleri tamamlamanız gerekir.

Başlamadan önce

  1. Henüz oluşturmadıysanız bir Firebase projesi oluşturun.

    Firebase konsolunda Proje ekle'yi tıklayın ve ekrandaki talimatları uygulayın. Yeni bir proje oluşturabilir veya Firebase hizmetlerini mevcut bir Google Cloud projesine ekleyebilirsiniz.

  2. Projenizin Blaze fiyatlandırma planında olduğundan emin olun.

    Genkit İzleme, ücretli hizmetler olan Google Cloud Logging, Metrics ve Trace'e yazılan telemetri verilerini kullanır. Fiyatlandırma ayrıntıları ve ücretsiz katman sınırlamaları hakkında bilgi edinmek için Google Cloud Gözlenebilirlik fiyatlandırması sayfasını inceleyin.

  3. Başlangıç Kılavuzu'nu izleyerek bir Genkit özelliği yazın ve aşağıdaki kılavuzlardan birini kullanarak kodunuzu dağıtıma hazırlayın:

    1. Cloud Functions for Firebase'i kullanarak akışları dağıtma
    2. Cloud Run'u kullanarak akışları dağıtma
    3. Akışları herhangi bir Node.js platformuna dağıtma

1. Adım. Firebase eklentisini ekleme

Projenize @genkit-ai/firebase eklentisini yükleyin:

npm i –save @genkit-ai/firebase

enableFirebaseTelemetry dosyasını Genkit yapılandırma dosyanıza (genkit(...)'ın ilkleştirildiği dosya) aktarın ve şu şekilde adlandırın:

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

enableFirebaseTelemetry();

2. Adım. Gerekli API'leri etkinleştirme

GCP projeniz için aşağıdaki API'lerin etkinleştirildiğinden emin olun:

Bu API'ler, projenizin API kontrol panelinde listelenmelidir.

3. Adım: İzinleri ayarlama

Firebase eklentisinin, Google Cloud Günlük, Metrikler ve İzleme hizmetleriyle kimlik doğrulamak için bir hizmet hesabı kullanması gerekir.

Google Cloud IAM Konsolu'nda, kodunuzu çalıştıracak şekilde yapılandırılmış olan hizmet hesabına aşağıdaki rolleri verin. Cloud Functions for Firebase ve/veya Cloud Run için bu genellikle varsayılan bilgi işlem hizmet hesabıdır.

  • Monitoring Metriği Yazıcısı (roles/monitoring.metricWriter)
  • Cloud Trace Aracısı (roles/cloudtrace.agent)
  • Günlük Yazıcı (roles/logging.logWriter)

4. Adım. (İsteğe bağlı) Yapılandırmanızı yerel olarak test etme

Uygulamadan önce, telemetri verilerinin toplanıp Genkit İzleme kontrol panelinde görüntülendiğini onaylamak için Genkit kodunuzu yerel olarak çalıştırabilirsiniz.

  1. Yerel ortamınızdan telemetri göndermek için Genkit kodunuzda forceDevExport değerini true olarak ayarlayın.

  2. Yapılandırmanızın kimliğini doğrulamak ve test etmek için hizmet hesabınızı kullanın.

    Google Cloud CLI aracı ile hizmet hesabını kullanarak kimlik doğrulayın:

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

  3. Genkit özelliğinizi çalıştırın ve çağırın, ardından Genkit İzleme kontrol panelinde metrikleri görüntüleyin. İlk metriğin toplanması 5 dakikayı bulabilir. Telemetri yapılandırmasında metricExportIntervalMillis değerini ayarlayarak bu gecikmeyi azaltabilirsiniz.

  4. Genkit İzleme kontrol panelinde metrikler görünmüyorsa hata ayıklama adımları için Sorun giderme kılavuzunu inceleyin.

5. Adım: Kodu yeniden derleyip dağıtma

Veri toplamaya başlamak için Genkit özelliğinizi yeniden oluşturun, dağıtın ve çağırın. Genkit Monitoring, metriklerinizi aldıktan sonra Genkit Monitoring kontrol panelini ziyaret ederek bunları görüntüleyebilirsiniz.