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 wyświetlania logów i wskaźników dotyczących usług Google Cloud, które zasilają Twoją aplikację internetową: Cloud Run, Cloud Build i Cloud CDN.

Korzystając ze standardowej składni logowania, takiej jak console.log w Node.js, możesz zapisywać wpisy logów w Cloud Logging.

Wyświetl logi w konsoli

W menu kontekstowym konsoli Firebase (menu z 3 kropkami w prawym górnym rogu) możesz szybko uzyskać dostęp do szczegółów wersji Cloud Run i błędów, a także logów Cloud Build.

Te logi zawierają przydatne informacje przy debugowaniu wdrożeń App Hosting. Na przykład dziennik Cloud Run odnotowuje, że nie można znaleźć obiektu package.json.

Log Cloud Build wyświetla dane wyjściowe kompilacji, co pozwala sprawdzić, czy wystąpiły błędy w konfiguracji platformy czy w konfiguracji App Hosting. Wyświetla też podstawowe ustawienia runConfig i wskazuje, kiedy brakuje ustawień lub gdy apphosting.yaml nie istnieje:

> 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 Cloud Logging

Jeśli chcesz rejestrować zdarzenia niestandardowe, możesz zapisywać w Cloud Logging z Cloud Run, gdzie uruchamiany jest kod renderowany przez serwer. Używaj standardowych wywołań JavaScriptu, np. console.log i console.error. Aby na przykład napisać niestandardowy wpis z kodu dla modułu obsługi trasy Next.js, wykonaj te czynności:

  • Polecenia console.log() mają poziom logu INFO.
  • Polecenia console.info() mają poziom logu INFO.
  • Polecenia console.warn() mają poziom logu ERROR.
  • Polecenia console.error() mają poziom logu ERROR.
  • Wewnętrzne komunikaty systemowe mają poziom logu 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 z serwera – do logów Cloud Run.

Wyświetlanie danych w konsoli

W konsoli Firebase możesz uzyskać dostęp do wskaźników ruchu i wykorzystania dla 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) dla bieżącego wdrożenia 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 też wskaźniki czasu oczekiwania na żądania i kontenera (np. wykorzystanie procesora i pamięci), dzięki którym poznasz wydajność i skalowalność aplikacji.

Wyświetl błędy serwera

Cloud Error Reporting konsoliduje błędy z instancji Cloud Run App Hosting. Opcjonalnie możesz skonfigurować usługę Cloud Error Reporting tak, aby powiadomiła Cię o pojawieniu się nowych błędów.