Dzienniki zdarzeń integracji są dostępne w Google Cloud Logging. Używaj Cloud Logging do przeglądania logów, tworzenia wskaźników i alertów lub eksportowania logów do innych aplikacji za pomocą Google Cloud Pub/Sub.
Logowanie dostępu
Aby uzyskać dostęp do usługi Cloud Logging z Google Cloud Console, kliknij Wyświetl wszystkie produkty, a następnie wybierz Dostrzegalność > Logowanie.
Dostęp do danych logowania jest zarządzany przez Identity and Access Management (IAM) dla użytkowników Twojego projektu Actions. Więcej informacji o rolach i uprawnieniach do logowania danych znajdziesz w artykule o kontroli dostępu w Cloud Logging.
Wpisy logu są przechowywane przez 30 dni zgodnie z zasadami przechowywania Cloud Logging, a następnie są planowane 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 dotyczącej wyszukiwania logów w przewodniku po rozwiązywaniu 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 w chmurze Google powiązanego z akcją 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 zamiaru SYNC |
| Błędy intencji QUERY | |
| 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, który upłynął przed otrzymaniem odpowiedzi. |
status |
Wskazuje stan odpowiedzi intencji. |
Logi wykonania
W tabeli poniżej znajdziesz schemat wpisu executionLog:
| Właściwość | Opis |
|---|---|
requestId |
Unikalny identyfikator żądania, na przykład 5325511189174727525. |
latencyMsec |
Czas, który upłynął przed otrzymaniem odpowiedzi, np. 6000. |
executionType |
Transport używany do żądania, na przykład 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 realizacji obsługiwanych cech, 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 otrzymało odpowiedź o powodzeniu. |
fallbackToCloud |
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 tym działaniem użytkownika. |
locale |
Kod języka powiązanego z żądaniem. |
Logi 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 logowania
Projekty Cloud-to-cloud są domyślnie skonfigurowane tak, aby otrzymywać logi błędów. Deweloperzy mogą też wyrazić zgodę na otrzymywanie logów powodzenia. Jest to szczególnie przydatne na etapie programowania, gdy planujesz przechwytywać wszystkie logi z kilku agentów. Jeśli przekroczysz limit logowania, mogą zostać naliczone dodatkowe opłaty.
Poziom logowania w projekcie możesz kontrolować przez:
W Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Wybierz kartę Develop (Programowanie) i kliknij Actions (Działania) na pasku bocznym.
Na liście Pozyskiwanie danych kontroli logów wybierz Wszystkie.
Wykluczenia logów
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań dotyczących logów, aby dostosowywać logi w bardziej elastyczny sposób. 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 wykluczania, wykonaj czynności opisane w tym przewodniku (skonfiguruj filtr wykluczania dla ujścia _Default).
Wskaźniki oparte na logach
Deweloperzy mogą używać wskaźników opartych na logach do śledzenia i analizowania wzorców w logach. Możesz 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 przypadku inteligentnego 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 tej dokumentacji:
- Ceny: szczegółowe informacje o przydziałach i kosztach nadwyżki.
- Limity: szczegółowe informacje o limitach i zasadach przechowywania danych dotyczących korzystania z logowania.
- Zaawansowane zapytania do logów: przewodnik po używaniu zaawansowanych wyrażeń do wysyłania zapytań i analizowania danych logów.