Logi zdarzeń integracji znajdziesz w Google Cloud Logging. Użyj usługi Cloud Logging, aby przeglądać logi, tworzyć wskaźniki i alerty oraz eksportować logi do innych aplikacji za pomocą Google Cloud Pub/Sub.
Dostęp do logowania
Aby uzyskać dostęp do usługi Cloud Logging w klastrze Google Cloud Console, kliknij Wyświetl wszystkie usługi, a następnie otwórz Operacje > Logowanie.
Dostępem do danych logów użytkowników projektu Actions zarządza się za pomocą Identity and Access Management (IAM). Więcej informacji o rolach i uprawnieniach dotyczących danych logowania znajdziesz w artykule o kontroli dostępu do Cloud Logging.
Wpisy logu są przechowywane przez 30 dni zgodnie z zasadą przechowywania Cloud Logging, a następnie zaplanowane do usunięcia. Wpisy możesz też usuwać na żądanie za pomocą interfejsu eksploratora logów.
Więcej informacji o skutecznym korzystaniu z logów znajdziesz w sekcji Wyszukiwanie logów w przewodniku dotyczącym 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ą 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 | |
| Błędy powiadomień | |
| Błędy łączenia kont | |
| Local Home SDK HandlerError |
Synchronizuj dzienniki
Tabela poniżej zawiera schemat wpisu syncLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator prośby o zgodę na intencję inteligentnego domu. |
httpLatencyMsec |
Czas, który upłynął do otrzymania odpowiedzi. |
status |
Wskazuje stan odpowiedzi intencji. |
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ął przed otrzymaniem odpowiedzi, np. 6000. |
executionType |
Transport użyty w żądaniu, na przykład CLOUD lub MATTER, w zależności od integracji. |
actionType |
Opcjonalny wskaźnik podjętego działania użytkownika, na przykład QUERY lub EXECUTE.
W przypadku działań EXECUTE obejmuje polecenie wydane w celu realizacji dla obsługiwanych cech, np. ONOFF_OFF
|
trait |
Opcjonalna cecha powiązana z tym działaniem użytkownika. |
deviceTypes |
Lista typów urządzeń, na które zdarzenie ma wpływ, np. LIGHT. |
isSuccess |
Określa, czy żądanie otrzymało pomyślną odpowiedź. |
fallbackToCloud |
Określa, czy żądanie zostało skierowane do realizacji w chmurze po wystąpieniu błędu z lokalnej realizacji. |
statusType |
Wskazuje stan odpowiedzi intencji, np. SUCCESS, PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera element errorCode udostępniony w ramach realizacji.
|
externalDebugString |
Opcjonalna szczegółowy komunikat debugowania powiązany z tym działaniem 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ń, na przykład „ObjectDetection”. |
status |
Wskazuje stan powiadomienia. |
Ustawienie poziomu rejestrowania
Projekty w Cloud-to-cloud są domyślnie ustawione na otrzymywanie logów błędów. Deweloperzy mogą też wyrazić zgodę na ich otrzymywanie. Jest to szczególnie przydatne na etapie programowania, gdy planujesz przechwytywać wszystkie logi kilku agentów. Jeśli przekroczysz limit logowania, w projekcie mogą zostać naliczone dodatkowe opłaty.
Poziom logowania w projekcie możesz kontrolować przez:
W aplikacji Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Wybierz kartę Programowanie i kliknij Działania na pasku bocznym.
Na liście Przetwarzanie kontroli logów wybierz Wszystkie.
Wykluczenia logów
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań logowania, aby jeszcze bardziej dostosowywać logi. Język zapytań usługi Logging jest też używany przez eksplorator logów, więc możesz używać eksploratora logów do tworzenia zapytań.
Instrukcje tworzenia filtrów wykluczania znajdziesz w tym przewodniku (skonfiguruj filtr wykluczania dla ujścia _Default).
Wskaźniki oparte na logach
Programiści mogą używać wskaźników opartych na logach, aby śledzić i analizować wzorce w logach. Możesz też tworzyć wykresy niestandardowe i konfigurować alerty wskaźników opartych na logach.
Aby zacząć korzystać ze wskaźników opartych na logach w przypadku inteligentnego domu, zapoznaj się z przewodnikiem tworzenia wskaźników opartych na logach.
Przydatne materiały
Aby dowiedzieć się więcej o korzystaniu z Cloud Logging w projekcie, zapoznaj się z tą dokumentacją:
- Ceny: szczegółowe informacje o przydziałach i kosztach nadwyżki.
- Limity i ograniczenia: szczegółowe informacje o limitach i zasadach przechowywania danych związanych z logowaniem.
- Zaawansowane zapytania dotyczące logów: przewodnik po użyciu zaawansowanych wyrażeń do wykonywania zapytań i analizowania danych logów.