Do logów zdarzeń dotyczących integracji możesz uzyskać dostęp na stronie Google Cloud Logging. Użyj Cloud Logging, aby przeglądać logi, tworzyć dane i alerty lub eksportować logi do innych aplikacji za pomocą Google Cloud Pub/Sub.
Access Logging
Aby uzyskać dostęp do Cloud Logging z poziomu strony Google Cloud Console, kliknij Wyświetl wszystkie produkty, a następnie Operacje > Rejestrowanie.
Dostępem do danych logowania zarządza usługa 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 Kontrola dostępu do logowania w usłudze Cloud Logging.
Wpisy w dzienniku są przechowywane przez 30 dni zgodnie z zasadami przechowywania usługi Cloud Logging, a następnie są zaplanowane do usunięcia. Możesz też usuwać wpisy na żądanie za pomocą 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 | Kontener 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 | |
| Pakiet SDK Local Home 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, na przykład CLOUD lub MATTER, w zależności od integracji. |
actionType |
Opcjonalny wskaźnik działania 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 rejestrowania
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 kont 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 oknie 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.
- Limity: szczegółowe informacje o ograniczeniach 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.