مشاهده گزارش‌ها و سنجه‌ها

گزارش‌گیری و سنجه‌ها ابزارهای مهمی برای اشکال‌زدایی و نظارت بر کد هستند. App Hosting دسترسی سریع برای مشاهده گزارش‌ها و سنجه‌های Google Cloud سرویس‌هایی که برنامه وب شما را تقویت می‌کنند فراهم می‌کند: Cloud Run، Cloud Build و Cloud CDN.

بااستفاده از نحو ثبت استاندارد مانند console.log در Node.js، می‌توانید ورودی‌های ثبت را در Cloud Logging بنویسید.

مشاهده میزان استفاده در کنسول

هر باطن دارای یک برگه نمای کلی است، با خلاصه‌ای از ترافیک برنامه شما (تعداد درخواست) و نرخ خطا در هفت روز گذشته.

برگه گزارش‌ها برای پس‌بک به شما امکان می‌دهد «گزارش‌های ساخت» (از Cloud Build) و «گزارش‌های زمان اجرا» (از Cloud Run و Cloud CDN) را مشاهده و فیلتر کنید.

هر باطن همچنین دارای برگه استفاده با چندین نمودار استفاده برای فعالیت و استفاده از برنامه شما است. داده‌های نمایش داده‌شده شامل پهنای باند و درخواست‌های CDN، استفاده از واحد پردازش مرکزی و حافظه Cloud Run، و موارد دیگر است.

می‌توانید سنجه‌های استفاده اضافی برای Cloud Run (مانند استفاده از CPU و استفاده از حافظه) را در کنسول Google Cloud پیدا کنید.

مشاهده گزارش‌ها در کنسول

از منوِ بافت کنسول Firebase (منوِ ۳نقطه‌ای در بالا سمت چپ) برای عرضه، می‌توانید دسترسی سریع به مشاهده جزئیات و خطاهای بازبینی Cloud Run و همچنین گزارش‌های ساخت داشته باشید.

این گزارش‌ها حاوی اطلاعات مفیدی برای اشکال‌زدایی از استقرارهای App Hosting شما است. برای مثال، گزارش Cloud Run زمانی را که package.json پیدا نمی‌شود ثبت می‌کند.

گزارش ساخت، خروجی ساخت شما را نمایش می‌دهد و به شما امکان می‌دهد بررسی کنید که آیا خطاها در پیکربندی چارچوب شما رخ داده‌اند یا در پیکربندی App Hosting. همچنین تنظیمات اصلی runConfig شما را نمایش می‌دهد، و نشان می‌دهد چه زمانی تنظیمات وجود ندارند یا چه زمانی apphosting.yaml وجود ندارد:

> next build

   ▲ Next.js 14.1.4
   -   Environments: .env

   ...

Route (app)                              Size     First Load JS
┌ λ /                                    4.79 kB         214 kB
├ λ /_not-found                          882 B          85.3 kB
└ λ /restaurant/[id]                     5.28 kB         207 kB
+   First Load JS shared by all            84.4 kB
  ├ chunks/69-6678c81190a8fe82.js        29 kB
  ├ chunks/fd9d1056-51920e345d2966e8.js  53.4 kB
  └ other shared chunks (total)          1.98 kB

نوشتن گزارش‌ها در Cloud Logging

اگر می‌خواهید رویدادهای سفارشی را ثبت کنید، می‌توانید از Cloud Run، جایی که کد ارائه‌شده توسط سرور شما اجرا می‌شود، به Cloud Logging بنویسید. از تماس‌های استاندارد ثبت گزارش جاوا اسکریپت مانند console.log و console.error استفاده کنید. برای مثال، برای نوشتن ورودی سفارشی از کد برای گرداننده مسیر Next.js، می‌توانید کاری شبیه به این انجام دهید:

export async function GET(request) {
  console.log("Handling GET request");
  return Response.json({ message: "Hello, world!" });
}

• console.log() فرمان دارای سطح گزارش INFO است.
• console.info() فرمان دارای سطح گزارش INFO است.
• ‫console.warn() فرمان سطح گزارش ERROR دارند.
• ‫console.error() فرمان سطح گزارش ERROR دارند.
• پیام‌های سیستم داخلی دارای سطح گزارش اشکال‌زدایی هستند.

توجه داشته باشید که console.log در کد ارائه‌شده توسط سرور برای برنامه شما به Cloud Logging منتقل می‌شود. رویدادهای مربوط به ارائه ایستا به گزارش‌های Cloud Build ارسال می‌شوند، درحالی‌که ارائه سرور به گزارش‌های Cloud Run ارسال می‌شود.

مشاهده خطاهای سرور

Cloud Error Reporting خطاهای نمونه App Hosting Cloud Run شما را ادغام می‌کند. می‌توانید به‌طور اختیاری Cloud Error Reporting را پیکربندی کنید تا هنگام بروز خطاهای جدید به شما اطلاع دهد.