Dostęp do dzienników zdarzeń dotyczących integracji możesz uzyskać z poziomu Google Cloud Logging. Użyj Cloud Logging, aby przeglądać logi, tworzyć wskaźniki i alerty lub eksportować logi do innych aplikacji za pomocą Google Cloud Pub/Sub.
Logowanie dostępu
Aby uzyskać dostęp do Cloud Logging, w Google Cloud Console kliknij Wyświetl wszystkie usługi, a potem wybierz Operacje > Rejestrowanie.
Dostęp do danych logów jest zarządzany za pomocą usługi Identity and Access Management (IAM) w przypadku użytkowników projektu działania. Więcej informacji o rolach i uprawnieniach dotyczących danych logowania znajdziesz w artykule Kontrola dostępu w Cloud Logging.
Wpisy w dzienniku są przechowywane przez 30 dni zgodnie z zasadami przechowywania usługi Cloud Logging, a następnie są usuwane. Możesz też usuwać wpisy na żądanie za pomocą interfejsu Eksploratora logów.
Więcej informacji o skutecznym korzystaniu z logów znajdziesz w sekcji Wyszukiwanie w logach w przewodniku rozwiązywania problemów.
Cloud Logging udostępnia te typy zasobów:
| Typ zasobu | Wyświetlana nazwa | Opis | Etykiety |
|---|---|---|---|
assistant_action_project |
Projekt akcji Asystenta Google | Kontener projektu Google Cloud powiązanego z działaniem Asystenta. |
|
Dzienniki zdarzeń
Projekty Cloud-to-cloud obsługują w Cloud Logging te zdarzenia:
| Zasób Cloud Logging | Zdarzenie |
|---|---|
| Projekt akcji Asystenta Google | Błędy intencji SYNC |
| Błędy intencji QUERY | |
| Błędy intencji EXECUTE | |
| Powiadomienia błędy | |
| Błędy łączenia kont | |
| Lokalny zestaw SDK Home HandlerError |
Synchronizuj dzienniki
Tabela poniżej zawiera schemat wpisu syncLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator żądania intencji inteligentnego domu. |
httpLatencyMsec |
Czas, który upłynął, zanim otrzymano odpowiedź. |
status |
Wskazuje stan odpowiedzi na intencję. |
Logi wykonania
Tabela poniżej zawiera schemat wpisu executionLog:
| Właściwość | Opis |
|---|---|
requestId |
Unikalny identyfikator żądania, np. 5325511189174727525. |
latencyMsec |
Czas, który upłynął, zanim otrzymano odpowiedź, np. 6000. |
executionType |
Rodzaj transportu użytego w żądaniu, np. CLOUD lub MATTER, w zależności od integracji. |
actionType |
Opcjonalny wskaźnik podjętego działania użytkownika, np. QUERY lub EXECUTE.
W przypadku EXECUTE działań zawiera polecenie wydane w celu realizacji obsługiwanych cech, np. ONOFF_OFF
|
trait |
Cecha opcjonalna powiązana z tą czynnością użytkownika. |
deviceTypes |
Lista typów urządzeń, których dotyczy zdarzenie, np.
LIGHT. |
isSuccess |
Czy żądanie otrzymało odpowiedź. |
fallbackToCloud |
Czy żądanie zostało skierowane do realizacji w chmurze po wystąpieniu błędu w realizacji lokalnej. |
statusType |
Wskazuje status odpowiedzi intencji, np. SUCCESS, PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera errorCode dostarczone przez realizację.
|
externalDebugString |
Opcjonalny, szczegółowy komunikat debugowania powiązany z tą czynnością użytkownika. |
locale |
Kod języka powiązany z żądaniem. |
Dzienniki powiadomień
Tabela poniżej zawiera schemat wpisu notificationLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator prośby o powiadomienie. |
structName |
Nazwa struktury powiadomień, np. „ObjectDetection”. |
status |
Wskazuje status powiadomienia. |
Ustawienie poziomu dziennika
Projekty Cloud-to-cloud są domyślnie skonfigurowane do otrzymywania dzienników błędów, a deweloperzy mogą również włączyć opcję otrzymywania dzienników sukcesów. Jest to szczególnie przydatne w fazie rozwoju, gdy planujesz rejestrować wszystkie logi z kilku agentów. Jeśli przekroczysz limit rejestrowania danych, mogą zostać naliczone dodatkowe opłaty za Twój projekt.
Możesz kontrolować poziom rejestrowania zdarzeń dla swojego projektu poprzez:
W Actions on Google Console przejdź do strony Projekty.
Wybierz projekt swojego inteligentnego domu.
Wybierz kartę Rozwój i kliknij Akcje na pasku bocznym.
Wybierz opcję Wszystkie z listy rozwijanej Pobieranie kontroli dziennika.
Wykluczenia logów
Programiści mogą tworzyć wykluczenia dzienników, korzystając z języka zapytań dotyczących dzienników, aby jeszcze bardziej elastycznie dostosowywać dzienniki. Język zapytań do rejestrowania jest również używany przez Logs Explorer, dzięki czemu można używać Logs Explorer do tworzenia zapytań.
Aby utworzyć filtry wykluczeń, wykonaj czynności opisane w tym przewodniku (skonfiguruj filtr wykluczeń dla ujścia _Default).
Wskaźniki oparte na logach
Deweloperzy mogą używać danych opartych na logach do śledzenia i analizowania wzorców w logach. Możesz też tworzyć wykresy niestandardowe i konfigurować alerty dotyczące wskaźników opartych na logach.
Aby zacząć używać wskaźników opartych na logach w inteligentnym domu, zapoznaj się z przewodnikiem po tworzeniu wskaźnika opartego na logach w postaci licznika.
Przydatne materiały
Więcej informacji o korzystaniu z Cloud Logging w projekcie znajdziesz w tych dokumentach:
- Ceny: szczegółowe informacje o limitach i kosztach przekroczenia limitu.
- Limity: szczegółowe informacje o limitach i zasadach przechowywania dotyczące korzystania z logowania.
- Zaawansowane zapytania dotyczące logów: przewodnik po używaniu zaawansowanych wyrażeń do wykonywania zapytań o dane logów i ich analizowania.