Wyświetlanie logów i wskaźników

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 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 w konfiguracji 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 wywoływać funkcję Cloud Logging z poziomu Cloud Run, gdzie działa Twój kod renderowany na serwerze. Używaj standardowych wywołań logowania JavaScript, takich jak console.logconsole.error. Aby na przykład utworzyć niestandardowy wpis z kodu dla handlera trasy Next.js, wykonaj te czynności:

  • Polecenia console.log() mają poziom rejestrowania INFO.
  • Polecenia console.info() mają poziom rejestrowania INFO.
  • Polecenia console.warn() mają poziom logowania ERROR.
  • Polecenia console.error() mają poziom logowania ERROR.
  • Wewnętrzne wiadomości systemowe mają poziom logowania DEBUG.

Pamiętaj, że console.log jest przekazywane do Cloud Logging w kodzie renderowania po stronie serwera Twojej aplikacji. Zdarzenia związane z renderowaniem statycznym są wysyłane do dzienników Cloud Build, a zdarzenia związane z renderowaniem po stronie serwera – do dziennikó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, aby poznać odsetek błędów 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 agreguje błędy z Twojej instancji App Hosting Cloud Run. Opcjonalnie możesz skonfigurować Cloud Error Reporting tak, aby otrzymywać powiadomienia o pojawianiu się nowych błędów.