احراز هویت و مجوز

افزونه تله متری Firebase به شناسه پروژه Google Cloud یا Firebase و اعتبار برنامه نیاز دارد.

اگر پروژه و حساب Google Cloud ندارید، می‌توانید آن را در Firebase Console یا Google Cloud Console راه‌اندازی کنید. همه شناسه‌های پروژه Firebase، شناسه‌های پروژه Google Cloud هستند.

API ها را فعال کنید

قبل از افزودن افزونه، مطمئن شوید که API های زیر برای پروژه شما فعال هستند:

این APIها باید در داشبورد API پروژه شما فهرست شوند. برای کسب اطلاعات بیشتر درباره نحوه فعال کردن و غیرفعال کردن APIها کلیک کنید.

احراز هویت کاربر

برای صادرات تله متری از محیط توسعه محلی خود به Firebase Genkit Monitoring، باید خود را با Google Cloud احراز هویت کنید.

ساده‌ترین راه برای احراز هویت، استفاده از gcloud CLI است که به‌طور خودکار اعتبار شما را از طریق Application Default Credentials (ADC) در اختیار چارچوب قرار می‌دهد.

اگر gcloud CLI را نصب نکرده‌اید، ابتدا دستورالعمل‌های نصب را دنبال کنید.

  1. با استفاده از gcloud CLI احراز هویت:

    gcloud auth application-default login

  2. شناسه پروژه خود را تنظیم کنید

    gcloud config set project PROJECT_ID

در Google Cloud مستقر شوید

در صورت استقرار کد خود در محیط Google Cloud یا Firebase (توابع Cloud، Cloud Run، میزبانی برنامه و غیره)، شناسه پروژه و اعتبارنامه ها به طور خودکار با Application Default Credentials کشف می شوند.

شما باید نقش‌های زیر را به حساب سرویسی که کد شما را اجرا می‌کند (یعنی «حساب سرویس پیوست شده») با استفاده از کنسول IAM اعمال کنید:

  • roles/monitoring.metricWriter
  • roles/cloudtrace.agent
  • roles/logging.logWriter

مطمئن نیستید کدام حساب سرویس مناسب است؟ بخش Find or create your service account را ببینید.

استقرار خارج از Google Cloud (با ADC)

در صورت امکان، از Application Default Credentials استفاده کنید تا اعتبارنامه ها را در دسترس افزونه قرار دهید.

معمولاً این شامل ایجاد یک کلید حساب سرویس و استقرار آن اعتبارنامه ها در محیط تولید شما است.

  1. دستورالعمل ها را برای تنظیم کلید حساب سرویس دنبال کنید.

  2. مطمئن شوید که حساب سرویس دارای نقش های زیر است:

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. استقرار فایل اعتبارنامه برای تولید (در کد منبع بررسی نکنید )

  4. متغیر محیطی GOOGLE_APPLICATION_CREDENTIALS به عنوان مسیر فایل اعتبارنامه تنظیم کنید.

    GOOGLE_APPLICATION_CREDENTIALS = "path/to/your/key/file"

مطمئن نیستید کدام حساب سرویس مناسب است؟ بخش Find or create your service account را ببینید.

استقرار خارج از Google Cloud (بدون ADC)

در برخی از محیط‌های بدون سرور، ممکن است نتوانید یک فایل اعتباری را مستقر کنید.

  1. دستورالعمل ها را برای تنظیم کلید حساب سرویس دنبال کنید.

  2. مطمئن شوید که حساب سرویس دارای نقش های زیر است:

    • roles/monitoring.metricWriter
    • roles/cloudtrace.agent
    • roles/logging.logWriter

  3. فایل اعتبارنامه را دانلود کنید.

  4. محتویات فایل اعتبارنامه را به صورت زیر به متغیر محیطی GCLOUD_SERVICE_ACCOUNT_CREDS اختصاص دهید: 

GCLOUD_SERVICE_ACCOUNT_CREDS='{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "client_id": "your-client-id",
  "auth_uri": "https://accounts.google.com/o/oauth2/auth",
  "token_uri": "https://accounts.google.com/o/oauth2/token",
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
  "client_x509_cert_url": "your-cert-url"
}'

مطمئن نیستید کدام حساب سرویس مناسب است؟ بخش Find or create your service account را ببینید.

حساب سرویس خود را پیدا یا ایجاد کنید

برای یافتن حساب سرویس مناسب:

  1. به صفحه حساب‌های سرویس در Google Cloud Console بروید
  2. پروژه خود را انتخاب کنید
  3. حساب سرویس مناسب را پیدا کنید. حساب های خدمات پیش فرض رایج به شرح زیر است:

  • توابع Firebase و Cloud Run

    PROJECT ID -compute@developer.gserviceaccount.com

  • موتور برنامه

    PROJECT ID @appspot.gserviceaccount.com

  • میزبانی برنامه

    firebase-app-hosting-compute@ PROJECT ID .iam.gserviceaccount.com

اگر خارج از اکوسیستم Google مستقر می شوید یا نمی خواهید از یک حساب سرویس پیش فرض استفاده کنید، می توانید یک حساب سرویس در کنسول Google Cloud ایجاد کنید .