Logowanie i wskaźniki to ważne narzędzia do debugowania i monitorowania kodu. App Hosting zapewnia szybki dostęp do dzienników i danych dotyczących usług Google Cloud, które obsługują Twoją aplikację internetową: Cloud Run, Cloud Build i Cloud CDN.
Korzystając ze standardowej składni logowania, np. console.log
w Node.js, możesz zapisywać wpisy logowania w pliku Cloud Logging.
Wyświetlanie logów w konsoli
W menu kontekstowym konsoli Firebase (menu z 3 kropkami w prawym górnym rogu) możesz szybko wyświetlić szczegóły i błędy dotyczące wersji Cloud Run, a także dzienniki Cloud Build.
Te dzienniki zawierają przydatne informacje do debugowania wdrożeń App Hosting. Na przykład w pliku dziennika Cloud Run znajdziesz informacje o tym, że nie znaleziono wartości package.json
.
Dziennik Cloud Build zawiera informacje o wyniku kompilacji, dzięki czemu możesz określić, czy błędy wystąpiły w ramach konfiguracji frameworku czy App Hosting. Wyświetla też podstawowe ustawienia runConfig
oraz wskazuje, kiedy brakuje ustawień lub nie ma 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
Zapisywanie logów w pliku Cloud Logging
Jeśli chcesz rejestrować zdarzenia niestandardowe, możesz zapisać dane w narzędziu Cloud Logging z poziomu Cloud Run, gdzie działa Twój kod renderowany przez serwer. Używaj standardowych wywołań logowania JavaScript, takich jak console.log
i console.error
. Aby na przykład utworzyć niestandardowy wpis z kodu dla obsługi trasy Next.js, możesz wykonać te czynności:
- Polecenia
console.log()
mają poziom logu INFO. - Polecenia
console.info()
mają poziom rejestrowania INFO. - Polecenia
console.warn()
mają poziom logu ERROR. - Polecenia
console.error()
mają poziom logu ERROR. - Wewnętrzne wiadomości systemowe mają poziom logowania DEBUG.
Pamiętaj, że console.log
przekazuje potok do Cloud Logging w wyrenderowanym przez serwer kodzie aplikacji. Zdarzenia związane z renderowaniem statycznym są wysyłane do logów Cloud Build, a renderowanie serwera – do logów Cloud Run.
Wyświetlanie danych w konsoli
W konsoli Firebase możesz uzyskać dostęp do danych o ruchu i wykorzystaniu usługi Cloud Run, która obsługuje Twoją aplikację internetową.
W menu kontekstowym konsoli Firebase (menu z 3 kropkami w prawym górnym rogu) dotyczącego bieżącego wdrażania wybierz Wyświetl dane Cloud Run. Będziesz mieć możliwość monitorowania liczby żądań docierających do usługi Cloud Run, w tym podziału według kodu odpowiedzi, co pozwoli określić odsetek błędów aplikacji.
Znajdziesz tu też dane o opóźnieniu żądań i wykorzystaniu zasobów kontenera (np. o wykorzystaniu procesora i pamięci), które pomogą Ci zrozumieć wydajność i skalowalność aplikacji.
Wyświetlanie błędów serwera
Cloud Error Reporting konsoliduje błędy z instancji App Hosting Cloud Run. Opcjonalnie możesz skonfigurować Cloud Error Reporting tak, aby otrzymywać powiadomienia o pojawianiu się nowych błędów.