Logi zdarzeń integracji znajdziesz w narzędziu 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.
Dostęp do logowania
Aby uzyskać dostęp do Cloud Logging z poziomu Google Cloud Console, kliknij Wyświetl wszystkie usługi, a następnie kliknij Operacje > Logowanie.
Dostępem do danych logów zarządza się za pomocą Identity and Access Management (IAM) w przypadku użytkowników projektu Actions. Więcej informacji o rolach i uprawnieniach do danych logowania znajdziesz w sekcji Kontrola dostępu w 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 na temat efektywnego korzystania 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 | SYNCHRONIZUJ błędy intencji |
| błędy intencji QUERY | |
| błędy intencji EXECUTE | |
| Błędy powiadomień | |
| Błędy łączenia kont | |
| 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, który 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 wykonanych działań użytkownika, np. QUERY lub EXECUTE.
W przypadku działań EXECUTE zawiera polecenie wydane w celu realizacji dla obsługiwanych cech, np. ONOFF_OFF
|
trait |
Cecha opcjonalna powiązana z tym działaniem użytkownika. |
deviceTypes |
Lista typów urządzeń, których dotyczy zdarzenie, np. LIGHT. |
isSuccess |
Wskazuje, czy żądanie odebrało prawidłową odpowiedź. |
fallbackToCloud |
Określa, czy po wystąpieniu błędu lokalnej realizacji żądanie zostało przekierowane do realizacji w chmurze. |
statusType |
Wskazuje stan odpowiedzi intencji, np. SUCCESS, PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera element errorCode podany 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 powiadomienia, na przykład „ObjectDetection”. |
status |
Wskazuje stan powiadomienia. |
Ustawienie poziomu logu
Cloud-to-cloud projekty są domyślnie ustawione tak, aby domyślnie odbierały logi błędów. Deweloperzy mogą też wyrazić zgodę na otrzymywanie logów sukcesu. 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 sekcji 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 ustawień logu wybierz Wszystko.
Wykluczenia logów
Deweloperzy mogą tworzyć wykluczenia logów za pomocą języka zapytań dotyczących logów, aby jeszcze bardziej elastycznie dostosowywać swoje logi. 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ń.
Instrukcje tworzenia filtrów wykluczeń znajdziesz 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, aby śledzić i analizować wzorce w 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 i limity: szczegółowe informacje o limitach i zasadach przechowywania dotyczących wykorzystania logów.
- Zaawansowane zapytania o logi: przewodnik po korzystaniu z zaawansowanych wyrażeń do wykonywania zapytań i analizowania danych logów.