Logi zdarzeń integracji znajdziesz w Google Cloud Logging. Cloud Logging umożliwia przeglądanie logów, tworzenie wskaźników i alertów oraz eksportowanie logów do innych aplikacji przy użyciu Google Cloud Pub/Sub.
Logowanie dostępu
Aby uzyskać dostęp do usługi Cloud Logging z poziomu Google Cloud Console, kliknij Wyświetl wszystkie usługi, a następnie otwórz Operacje > Logowanie.
Dostępem do danych logów zarządza się za pomocą Identity and Access Management (IAM) w przypadku użytkowników projektu w Actions. Więcej informacji o rolach i uprawnieniach do danych logowania znajdziesz w artykule o kontroli dostępu w Cloud Logging.
Wpisy logu są przechowywane przez 30 dni zgodnie z zasadą przechowywania Cloud Logging, a następnie są zaplanowane do usunięcia. Wpisy możesz też usuwać na żądanie za pomocą interfejsu Eksploratora logów.
Więcej informacji o tym, jak skutecznie korzystać z logów, znajdziesz w sekcji Wyszukiwanie logów w przewodniku rozwiązywania problemów.
Cloud Logging udostępnia następujące typy zasobów:
| Typ zasobu | Wyświetlana nazwa | Opis | Etykiety |
|---|---|---|---|
assistant_action_project |
Projekt akcji Asystenta Google | Kontener na projekt Google Cloud powiązany z akcją Asystenta. |
|
Dzienniki zdarzeń
Cloud-to-cloud projektów obsługuje 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 związane z łączeniem kont | |
| Local Home SDK HandlerError |
Synchronizuj dzienniki
Tabela poniżej zawiera schemat wpisu syncLog:
| Właściwość | Opis |
|---|---|
requestId |
Identyfikator żądania intencji inteligentnego domu. |
httpLatencyMsec |
Czas, jaki 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, jaki upłynął do otrzymania odpowiedzi, na przykład 6000. |
executionType |
Transport używany w żądaniu, na przykład CLOUD lub MATTER (w zależności od integracji). |
actionType |
Opcjonalny wskaźnik podjętego działania użytkownika, np. QUERY lub EXECUTE.
W przypadku działań EXECUTE zawiera polecenie wydane do realizacji w przypadku obsługiwanych cech, np. ONOFF_OFF
|
trait |
Cecha opcjonalna powiązana z tym działaniem użytkownika. |
deviceTypes |
Lista typów urządzeń, na które ma wpływ zdarzenie, np. LIGHT. |
isSuccess |
Wskazuje, czy żądanie odebrało odpowiedź. |
fallbackToCloud |
Określa, czy w wyniku błędu związanego z realizacją lokalną żądanie przekierowało je do realizacji w chmurze. |
statusType |
Wskazuje stan odpowiedzi intencji, np. SUCCESS, PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera wartość errorCode podaną przez realizację.
|
externalDebugString |
Opcjonalny szczegółowy komunikat na potrzeby 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 logu
Projekty w Cloud-to-cloud domyślnie otrzymują logi błędów. Deweloperzy mogą też wyrazić zgodę na ich otrzymywanie. Jest to szczególnie przydatne na etapie programowania, gdy planujesz przechwytywać wszystkie logi od kilku agentów. Jeśli przekroczysz limit logowania, projekt może zostać obciążony dodatkowymi opłatami.
Poziom rejestrowania projektu możesz kontrolować przez:
W Actions on Google Console otwórz stronę Projekty.
Wybierz projekt inteligentnego domu.
Wybierz kartę Programowanie i na pasku bocznym kliknij Działania.
Na liście Przetwarzanie kontroli logu wybierz Wszystkie.
Wykluczenia logów
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań dotyczących logów, aby dalej dostosowywać logi w bardziej elastyczny sposób. Język zapytań usługi Logging jest też używany przez eksplorator logów, dzięki czemu możesz używać eksploratora logów do tworzenia zapytań.
Wykonaj czynności tworzenia filtrów wykluczania opisane w tym przewodniku (skonfiguruj filtr wykluczania dla ujścia _Default).
Wskaźniki oparte na logach
Deweloperzy mogą śledzić i analizować wzorce w swoich logach za pomocą wskaźników opartych na logach. Możesz też tworzyć wykresy niestandardowe i konfigurować alerty dotyczące wskaźników opartych na logach.
Aby zacząć korzystać ze wskaźników opartych na logach w inteligentnym domu, zapoznaj się z przewodnikiem po wskaźnikach opartych na logach 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żek.
- Limity: szczegółowe informacje o limitach i zasadach przechowywania dotyczących logowania.
- Zaawansowane zapytania o logi: przewodnik po korzystaniu z zaawansowanych wyrażeń do wysyłania zapytań i analizowania danych logów.