Do logów zdarzeń dotyczących integracji możesz uzyskać dostęp na stronie Google Cloud Logging. Używaj Cloud Logging do przeglądania logów, tworzenia danych i alertów oraz eksportowania logów do innych aplikacji za pomocą Google Cloud Pub/Sub.
Access Logging
Aby uzyskać dostęp do Cloud Logging z poziomu Google Cloud Console, kliknij Wyświetl wszystkie usługi, a następnie Operacje > Rejestrowanie.
Dostęp do danych logowania jest zarządzany za pomocą usługi Identity and Access Management (IAM) w przypadku użytkowników projektu Actions. Więcej informacji o rolach i uprawnieniach dotyczących danych logowania znajdziesz w artykule o kontroli dostępu w Logowaniu w chmurze.
Wpisy w dzienniku są przechowywane przez 30 dni zgodnie z zasadami przechowywania Cloud Logging, a następnie zaplanowane do usunięcia. Możesz też usunąć wpisy na żądanie, korzystając z interfejsu Log Explorer.
Więcej informacji o skutecznym korzystaniu z logów znajdziesz w sekcji „Wyszukiwanie logów” w przewodniku Rozwiązywanie problemów.
Cloud Logging udostępnia te typy zasobów:
| Typ zasobu | Wyświetlana nazwa | Opis | Etykiety |
|---|---|---|---|
assistant_action_project |
Projekt akcji Asystenta Google | Kontenery projektu Google Cloud powiązanego z działaniem Asystenta. |
|
Dzienniki zdarzeń
Projekty Cloud-to-cloud obsługują te zdarzenia w Cloud Logging:
| 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 | |
| Local Home SDK HandlerError |
Dzienniki synchronizacji
Tabela poniżej zawiera schemat wpisu syncLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator żądania intencji inteligentnego domu. |
httpLatencyMsec |
Czas, jaki upłynął przed otrzymaniem odpowiedzi. |
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, jaki upłynął przed otrzymaniem odpowiedzi, na przykład:
6000. |
executionType |
Transport użyty do wysłania żądania, np. CLOUD lub MATTER, w zależności od integracji. |
actionType |
Opcjonalny wskaźnik działania podjętego przez użytkownika, np. QUERY lub EXECUTE.
W przypadku działań EXECUTE zawiera polecenie wydane do obsługi obsługiwanych atrybutów, na przykład ONOFF_OFF
|
trait |
Opcjonalna cecha powiązana z tym działaniem użytkownika. |
deviceTypes |
Lista typów urządzeń, których dotyczy zdarzenie, np.
LIGHT. |
isSuccess |
Czy żądanie zostało zrealizowane. |
fallbackToCloud |
Określa, czy żądanie zostało przekazane do realizacji w chmurze po wystąpieniu błędu podczas realizacji lokalnej. |
statusType |
Wskazuje stan odpowiedzi na intencję, np. SUCCESS,
PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera errorCode podany przez usługę realizacji.
|
externalDebugString |
Opcjonalny szczegółowy komunikat debugowania powiązany z tym działaniem użytkownika. |
locale |
Kod języka powiązany z żądaniem. |
Logi powiadomień
Tabela poniżej zawiera schemat wpisu notificationLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator prośby dotyczącej powiadomienia. |
structName |
Nazwa struktury powiadomienia, np. „ObjectDetection”. |
status |
Wskazuje stan powiadomienia. |
Ustawienie poziomu logowania
Domyślnie projekty Cloud-to-cloud otrzymują logi błędów. Programiści mogą też wyrazić zgodę na otrzymywanie logów powodzenia. Jest to szczególnie przydatne w fazie rozwoju, gdy planujesz rejestrować wszystkie dzienniki z kilku agentów. Jeśli przekroczysz limit logowania, w Twoim projekcie mogą zostać naliczone dodatkowe opłaty.
Poziom logowania w projekcie możesz kontrolować na 2 sposoby:
W Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Kliknij kartę Tworzenie i w panelu bocznym kliknij Działania.
Na liście Przetwarzanie kontroli logów kliknij Wszystkie.
Wykluczenia w logach
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań logowania, aby jeszcze bardziej elastycznie dostosowywać logi. Język zapytań usługi Logging jest też używany przez Eksploratora logów, więc możesz używać tego narzędzia 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 na podstawie logów do śledzenia i analizowania wzorów w logach. Możesz też tworzyć wykresy niestandardowe i konfigurować alerty na podstawie danych opartych na logach.
Aby zacząć korzystać ze wskaźników opartych na logach w inteligentnym domu, zapoznaj się z przewodnikiem po tworzeniu wskaźnika w postaci licznika na podstawie logów.
Przydatne materiały
Więcej informacji o korzystaniu z Cloud Logging w projekcie znajdziesz w tych dokumentacjach:
- Ceny: szczegółowe informacje o limitach i kosztach przekroczenia limitu.
- Kwoty i limity: informacje o limitach i zasadach przechowywania danych logowania.
- Zaawansowane zapytania dotyczące logów: przewodnik po tworzeniu zaawansowanych wyrażeń, które umożliwiają wysyłanie zapytań do danych logów i analizowanie ich.