Dostęp do dzienników zdarzeń dotyczących integracji możesz uzyskać w sekcji 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 poziomu 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ą 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 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ą 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 połą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, który upłynął do otrzymania 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, 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 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 |
Opcjonalny atrybut powiązany z działaniem użytkownika. |
deviceTypes |
Lista typów urządzeń, których dotyczy zdarzenie, np.LIGHT. |
isSuccess |
Czy żądanie otrzymało odpowiedź. |
fallbackToCloud |
Określa, czy żądanie zostało przekierowane 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 realizację.
|
externalDebugString |
Opcjonalny szczegółowy komunikat debugowania powiązany z 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 powiadomienia, np. „ObjectDetection”. |
status |
Wskazuje stan powiadomienia. |
Ustawienie poziomu rejestrowania
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 logowania w projekcie możesz kontrolować w ten sposób:
W oknie Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Wybierz kartę Tworzenie i na pasku bocznym kliknij Działania.
Na liście Przetwarzanie kontroli logów kliknij Wszystkie.
Wykluczenia logów
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań usługi Logging, aby w bardziej elastyczny sposób dostosowywać logi. Język zapytań usługi Logging jest też używany przez eksplorator logów, więc możesz go używać 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ń i analizowania danych logów.