Dostęp do logów zdarzeń dotyczących integracji możesz uzyskać w 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 z Google Cloud Console, kliknij Wyświetl wszystkie produkty, a potem Operacje > Logowanie.
Dostęp do danych logowania jest zarządzany za pomocą Identity and Access Management (IAM) dla użytkowników projektu Actions. Więcej informacji o rolach i uprawnieniach dotyczących danych logowania znajdziesz w artykule Kontrola dostępu do Cloud Logging access control.
Wpisy w logach są przechowywane przez 30 dni zgodnie z zasadami przechowywania Cloud Logging retention policy, a następnie są planowane do usunięcia. 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 logów 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 akcją Asystenta Action. |
|
Dzienniki zdarzeń
Cloud-to-cloud projekty obsługują te zdarzenia w Cloud Logging:
| Zasób Cloud Logging | Zdarzenie |
|---|---|
| Projekt akcji Asystenta Google | SYNC |
| Błędy intencji QUERY | |
| EXECUTE | |
| Powiadomienia błędy | |
| Błędy łączenia kont | |
| Local Home SDK HandlerError |
Logi synchronizacji
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 |
Transport używany do żądania, np. 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 obejmuje polecenie wydane do
realizacji w przypadku obsługiwanych cech, np. 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 otrzymało odpowiedź. |
fallbackToCloud |
Czy żądanie zostało przekierowane do realizacji w chmurze po wystąpieniu błędu w 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 realizację.
|
externalDebugString |
Opcjonalna szczegółowa wiadomość debugowania powiązana 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 żądania powiadomienia. |
structName |
Nazwa struktury powiadomienia, np. „ObjectDetection”. |
status |
Wskazuje stan powiadomienia. |
Ustawienie poziomu logu
Cloud-to-cloud projekty są domyślnie skonfigurowane tak, aby otrzymywać logi błędów, a programiści mogą też włączyć otrzymywanie logów powodzenia. Jest to szczególnie przydatne w fazie rozwoju, gdy planujesz rejestrować wszystkie logi z kilku agentów. Jeśli przekroczysz limit logowania, w projekcie mogą zostać naliczone dodatkowe opłaty.
Poziom logu w projekcie możesz kontrolować w ten sposób:
W Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Kliknij kartę Tworzenie, a potem na pasku bocznym kliknij Działania.
Na liście Kontrola logów wybierz Wszystkie.
Wykluczenia logów
Programiści mogą tworzyć wykluczenia logów za pomocą języka zapytań dotyczących logów aby w bardziej elastyczny sposób dostosowywać logi. Język zapytań dotyczących logów jest też używany przez eksplorator logów, więc możesz go używać do tworzenia zapytań.
W tym przewodniku znajdziesz instrukcje tworzenia filtrów wykluczających
(skonfiguruj filtr wykluczający dla ujścia _Default).
Wskaźniki oparte na logach
Programiści mogą używać wskaźników opartych na logach do śledzenia i analizowania wzorców w logach. Można też tworzyć niestandardowe wykresy i konfigurować alerty na podstawie wskaźników opartych na logach.
Aby zacząć korzystać ze wskaźników opartych na logach w inteligentnym domu, zapoznaj się z przewodnikiem tworzenia licznika opartego na logach.
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 i limity: szczegółowe informacje o limitach i zasadach przechowywania danych dotyczących wykorzystania logowania.
- Zaawansowane zapytania dotyczące logów: przewodnik po używaniu zaawansowanych wyrażeń do wysyłania zapytań i analizowania danych logów.