Genkit İzleme: Sorun giderme

Aşağıdaki bölümlerde, geliştiricilerin Firebase Genkit İzleme'yi kullanırken karşılaştığı yaygın sorunların çözümleri ayrıntılı olarak açıklanmıştır.

Firebase Genkit Monitoring'de iz veya metrik göremiyorum

  1. Temel Google Cloud projeniz için aşağıdaki API'lerin etkinleştirildiğinden emin olun:
  2. Cloud IAM'da, kodunuzu çalıştıran hizmet hesabına (veya eklenti seçenekleri kapsamında yapılandırılmış hizmet hesabına) aşağıdaki rollerin uygulandığından emin olun.
    • Monitoring Metriği Yazıcısı (roles/monitoring.metricWriter)
    • Cloud Trace Aracısı (roles/cloudtrace.agent)
    • Günlük Yazıcı (roles/logging.logWriter)
  3. Cloud Logging, Cloud Trace ve Cloud Monitoring'e yazılan hatalar için uygulama günlüklerini inceleyin. Firebase Functions ve Cloud Run gibi Google Cloud altyapılarında, telemetri yanlış yapılandırılmış olsa bile stdout/stderr günlükleri Cloud Logging aracısı tarafından otomatik olarak alınır. Bu sayede, sorunları Cloud Logging Console'da teşhis edebilirsiniz.

  4. Yerel olarak hata ayıklama:

    Geliştirici dışa aktarma özelliğini etkinleştirme:

    enableFirebaseTelemetry({
      forceDevExport: true
    });
    

    Kişisel kullanıcı kimlik bilgilerinizle test etmek için Google Cloud ile kimlik doğrulaması yapmak üzere gcloud KSA'yı kullanın. Bu işlem, etkin veya devre dışı API'leri teşhis etmenize yardımcı olabilir ancak gcloud auth uygulama varsayılan girişini test etmez.

    Alternatif olarak, hizmet hesabının kimliğine bürünerek üretime benzer erişimi test edebilirsiniz. Hizmet hesaplarının kimliğine bürünmek için kullanıcı hesabınıza roles/iam. serviceAccountTokenCreator IAM rolü uygulanmış olmalıdır:

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

    Daha fazla bilgi için ADC dokümanlarını inceleyin.

Firebase Functions / Cloud Run'da telemetri yükleme güvenilirliği

Genkit, Google Cloud Run'da barındırıldığında (Firebase için Cloud Functions dahil), kapsayıcı "boş" yaşam döngüsü durumuna geçtiğinden telemetri verisi yükleme işlemi daha az güvenilir olabilir. Daha yüksek güvenilirlik sizin için önemliyse Google Cloud Console'da CPU ayırma seçeneğini her zaman ayrılmış olarak değiştirebilirsiniz.