Witamy w Google Home Developer Center – nowym miejscu, gdzie możesz dowiedzieć się, jak tworzyć inteligentne działania domowe. Uwaga: nadal będziesz tworzyć działania w konsoli Actions.

Uzyskiwanie dostępu do dzienników zdarzeń za pomocą Cloud Logging

Logi zdarzeń integracji znajdziesz w Google Cloud Logging. Cloud Logging umożliwia eksplorowanie logów, tworzenie wskaźników i alertów oraz eksportowanie logów do innych aplikacji za pomocą Google Cloud Pub/Sub.

Logowanie dostępu

Aby uzyskać dostęp do Cloud Logging w: Google Cloud Console, kliknij Wyświetl wszystkie usługi, a następnie Operacje > Logowanie.

Otwórz stronę Cloud Logging

Dostępem do danych logowania zarządza użytkownik w projekcie Identity and Access Management (IAM). Więcej informacji o rolach i uprawnieniach do logowania danych znajdziesz w artykule na temat kontroli dostępu do Cloud Logging.

Zgodnie z zasadami przechowywania w Cloud Logging wpisy logu są przechowywane przez 30 dni, a następnie przeznaczone do usunięcia. Wpisy na żądanie możesz też usuwać za pomocą interfejsu eksploratora logów.

Więcej informacji o efektywnym korzystaniu z logów znajdziesz w sekcji Przeszukiwanie dzienników 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.
  • project_id: identyfikator bieżącego projektu powiązanego z tym zasobem, na przykład my-project.

Dzienniki zdarzeń

Projekty Cloud-to-cloud obsługują te zdarzenia w Cloud Logging:

Zasób Cloud Logging Zdarzenie
Projekt akcji Asystenta Google Błędy SYNC
Błędy intencji QUERY
EXECUTE – błędy intencji
Błędy powiadomień
Błędy związane z łączeniem kont
Pakiet SDK do domu lokalnego HandlerError

Synchronizuj logi

Tabela poniżej zawiera schemat wpisu syncLog:

Usługa Opis
requestId Identyfikator żądania intencji inteligentnego domu.
httpLatencyMsec Czas, który upłynął od otrzymania odpowiedzi.
status Wskazuje stan odpowiedzi na zamiar.

Logi wykonania

Tabela poniżej zawiera schemat wpisu executionLog:

Usługa Opis
requestId Unikalny identyfikator żądania, np. 5325511189174727525.
latencyMsec Czas, który upłynął od otrzymania odpowiedzi, np. 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 dotyczące realizacji cech wspólnych, na przykład ONOFF_OFF.
trait Atrybut opcjonalny powiązany z tym działaniem użytkownika.
deviceTypes Lista typów urządzeń, na które wpływa zdarzenie, np. LIGHT.
isSuccess Określa, czy żądanie otrzymało odpowiedź.
fallbackToCloud Określa, czy żądanie było kierowane do realizacji w chmurze po błędzie lokalnym.
statusType Wskazuje stan odpowiedzi intencji, np. SUCCESS, PENDING lub OFFLINE. W przypadku odpowiedzi ERROR ta właściwość zawiera pole errorCode podane przez realizację.
externalDebugString Opcjonalny szczegółowy komunikat debugowania powiązany z tym działaniem użytkownika.
locale Kod języka powiązany z żądaniem.

Logi powiadomień

Tabela poniżej zawiera schemat wpisu notificationLog:

Usługa Opis
requestId Identyfikator żądania powiadomienia.
structName Nazwa struktury powiadomień, na przykład „ObjectDetection”.
status Wskazuje stan powiadomienia.

Ustawienie poziomu logowania

Projekty Cloud-to-cloud są domyślnie ustawione na otrzymywanie logów błędów, a deweloperzy mogą wyrazić zgodę na otrzymywanie logów sukcesu. Jest to szczególnie przydatne na etapie tworzenia, gdy planujesz przechwytywanie wszystkich logów z kilku agentów. Jeśli przekroczysz limit logowania, w Twoim projekcie mogą zostać naliczone dodatkowe opłaty.

Poziom kontroli projektu możesz kontrolować za pomocą:

  1. W Actions on Google Console otwórz stronę Projekty.

    Otwórz konsolę Actions on Google

  2. Wybierz projekt inteligentnego domu.

  3. Wybierz kartę Programowanie i na pasku bocznym kliknij Działania.

  4. Na liście Przetwarzanie logów wybierz Wszystkie.

Wykluczenia logów

Deweloperzy mogą tworzyć wykluczenia logów, korzystając z języka zapytań dotyczących logów, który pozwoli na bardziej elastyczne dostosowywanie logów. Język zapytań logów jest też używany w eksploratorze logów, dzięki czemu możesz tworzyć zapytania za pomocą eksploratora logów.

Postępuj zgodnie z instrukcjami tworzenia filtrów wykluczeń w tym przewodniku (aby skonfigurować ten filtr 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ąć używać wskaźników opartych na logach na potrzeby inteligentnego domu, przeczytaj przewodnik po tworzeniu wskaźników opartych na licznikach.

Aby dowiedzieć się więcej o korzystaniu z Cloud Logging w projekcie, zapoznaj się z tą dokumentacją:

  • Cena: szczegółowe informacje o przydziałach i kosztach nadwyżki.
  • Limity i limity: szczegółowe informacje o limitach i zasadach przechowywania obowiązujących w przypadku logowania.
  • Zapytania dotyczące logów zaawansowanych: przewodnik dotyczący używania wyrażeń zaawansowanych do wykonywania zapytań na danych i analizowania ich.