Günlükleri ve metrikleri görüntüleme

Günlük kaydı ve metrikler, kodda hata ayıklama ve izleme için önemli araçlardır. App Hosting, web uygulamanızı destekleyen Google Cloud hizmetlerinin (Cloud Run, Cloud Build ve Cloud CDN) günlüklerini ve metriklerini görüntülemeye hızlı erişim sağlar.

Node.js'in console.log gibi standart günlük kaydı söz dizimini kullanarak Cloud Logging'e günlük girişleri yazabilirsiniz.

Kullanımı konsolda görüntüleme

Her arka uçta, uygulamanızın son yedi gün içindeki trafiğinin (istek sayısı) ve hata oranının özetini içeren bir Genel Bakış sekmesi bulunur.

Her arka uçta, uygulamanızın etkinliği ve kullanımıyla ilgili çeşitli kullanım grafiklerinin yer aldığı bir Kullanım sekmesi de bulunur. Gösterilen veriler arasında CDN bant genişliği ve istekleri, Cloud Run CPU ve bellek kullanımı gibi bilgiler yer alır.

Google Cloud Console'da Cloud Run için ek kullanım metriklerini (ör. CPU kullanımı ve bellek kullanımı) bulabilirsiniz.

Günlükleri konsolda görüntüleme

Bir kullanıma sunma işlemi için Firebase konsol içerik menüsünden (sağ üstteki 3 noktalı menü) Cloud Run düzeltme ayrıntılarını ve hatalarını, ayrıca derleme günlüklerini görüntülemek üzere hızlıca erişebilirsiniz.

Bu günlükler, App Hosting dağıtımlarınızın hatalarını ayıklamanıza yardımcı olacak bilgiler içerir. Örneğin, Cloud Run günlük, package.json bulunamadığında not alır.

Derleme günlüğü, derleme çıkışınızı gösterir. Bu sayede, hataların çerçevenizdeki yapılandırmada mı yoksa App Hosting yapılandırmasında mı oluştuğunu belirleyebilirsiniz. Ayrıca temel runConfig ayarlarınızı gösterir ve ayarların eksik olduğu veya apphosting.yaml'ın bulunmadığı durumları belirtir:

> 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

Günlükleri Cloud Logging'e yazma

Özel etkinlikleri günlüğe kaydetmek istiyorsanız sunucu tarafından oluşturulan kodunuzun çalıştığı Cloud Run yerine Cloud Logging'e yazabilirsiniz. console.log ve console.error gibi standart JavaScript günlük kaydı çağrılarını kullanın. Örneğin, Next.js rota işleyicisi için koddan özel giriş yazmak isterseniz aşağıdaki gibi bir işlem yaparsınız:

  • console.log() komutları INFO günlük düzeyine sahiptir.
  • console.info() komutları INFO günlük düzeyine sahiptir.
  • console.warn() komutları ERROR günlük düzeyine sahiptir.
  • console.error() komutları ERROR günlük düzeyine sahiptir.
  • Dahili sistem mesajları DEBUG günlük düzeyine sahiptir.

console.log, uygulamanızın sunucu tarafından oluşturulan kodunda Cloud Logging'e aktarılır. Statik oluşturmayla ilgili etkinlikler Cloud Build günlüklerine, sunucu oluşturma ise Cloud Run günlüklerine gönderilir.

Sunucu hatalarını görüntüleme

Cloud Error Reporting, App Hosting Cloud Run örneğinizdeki hataları birleştirir. İsteğe bağlı olarak Cloud Error Reporting'i yeni hatalar oluştuğunda sizi bilgilendirecek şekilde yapılandırabilirsiniz.