Günlük kaydı ve metrikler, kodda hata ayıklama ve kodu izleme için önemli araçlardır. App Hosting, web uygulamanıza güç veren Google Cloud hizmetlerinin günlüklerini ve metriklerini görüntülemek için hızlı erişim sağlar:Cloud Run, Cloud Build ve Cloud CDN.
Node.js' console.log gibi standart günlük kaydı söz dizimini kullanarak Cloud Logging'ye günlük girişleri yazabilirsiniz.
Kullanımı konsolda görüntüleme
Her arka uçta, uygulamanızın son yedi gündeki trafiğinin (istek sayısı) ve hata oranının özetini içeren bir Genel Bakış sekmesi bulunur.
Bir arka uç için Günlükler sekmesi, "Derleme günlüklerini" (Cloud Build) ve "Çalışma zamanı günlüklerini" (Cloud Run ve Cloud CDN'den) görüntülemenize ve filtrelemenize olanak tanır.
Her arka uçta, uygulamanızın etkinliği ve kullanımıyla ilgili çeşitli kullanım grafiklerinin bulunduğu bir Kullanım sekmesi de vardır. Gösterilen veriler arasında CDN bant genişliği ve istekleri, Cloud Run CPU ve bellek kullanımı gibi bilgiler yer alır.
Cloud Run için ek kullanım metriklerini (ör. CPU kullanımı ve bellek kullanımı) Google Cloud konsolunda bulabilirsiniz.
Konsoldaki günlükleri görüntüleme
Bir dağıtım için Firebase konsol bağlam menüsünden (sağ üstteki 3 noktalı menü) Cloud Run düzeltme ayrıntılarını ve hatalarını görüntülemenin yanı sıra derleme günlüklerine hızlı erişim sağlayabilirsiniz.
Bu günlükler, dağıtımlarınızda App Hosting
hata ayıklama için yararlı bilgiler içerir. Örneğin, Cloud Run, package.json bulunamadığında günlük notları oluşturur.
Derleme günlüğünde derleme çıktınız gösterilir. Bu sayede, çerçeve yapılandırmanızda veya App Hosting yapılandırmasında hatalar oluşup oluşmadığını önceliklendirebilirsiniz. Ayrıca temel runConfig ayarlarınızı gösterir, ayarların eksik olduğu veya apphosting.yaml'ın mevcut olmadığı zamanları 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 konumuna yazma
Özel etkinlikleri günlüğe kaydetmek istiyorsanız sunucu tarafında oluşturulan kodunuzun çalıştığı Cloud Logging konumundan Cloud Run adresine yazabilirsiniz. console.log ve console.error gibi standart JavaScript günlük kaydı çağrılarını kullanın. Örneğin, bir Next.js rota işleyicisi için koddan özel bir giriş yazmak istiyorsanız 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 iletileri DEBUG günlük düzeyine sahiptir.
Sunucu tarafında oluşturulan uygulama kodunuzda console.log karakterinin Cloud Logging karakterine yönlendirildiğini unutmayın. Statik oluşturmayla ilgili etkinlikler Cloud Build günlüklerine, sunucu tarafında oluşturmayla ilgili etkinlikler 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.