Bienvenue dans le Centre des développeurs Google Home, la nouvelle destination pour apprendre à développer des actions pour la maison connectée. Remarque : Vous continuerez à créer des actions dans la console Actions.

Accéder aux journaux d'événements avec Cloud Logging

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous pouvez accéder aux journaux d'événements de vos intégrations depuis Google Cloud Logging. Utilisez Cloud Logging pour explorer les journaux, créer des métriques et des alertes, ou exporter des journaux vers d'autres applications à l'aide de Google Cloud Pub/Sub.

Journaux d'accès

Pour accéder à Cloud Logging à partir de Google Cloud Console, cliquez sur Afficher tous les produits, puis accédez à Opérations > Journalisation.

Accéder à Cloud Logging

L'accès aux données de journalisation est géré via Identity and Access Management (IAM) pour les utilisateurs de votre projet Actions. Pour en savoir plus sur les rôles et les autorisations pour la journalisation des données, consultez la page Contrôle des accès de Cloud Logging.

Les entrées de journal sont conservées pendant 30 jours conformément à la règle de conservation de Cloud Logging, puis sa suppression est planifiée. Vous pouvez également supprimer des entrées à la demande à l'aide de l'interface de l'explorateur de journaux.

Pour en savoir plus sur l'utilisation efficace des journaux, consultez la section "Rechercher des journaux" du guide de dépannage.

Cloud Logging fournit les types de ressources suivants:

Type de ressource Nom à afficher Description Étiquettes
assistant_action_project Projet Google Assistant Action Conteneur pour le projet Google Cloud associé à une action de l'Assistant.
  • project_id: identifiant de votre projet actuel associé à cette ressource, par exemple my-project.

Journaux des événements

Cloud-to-cloud projects support the following events in Cloud Logging:

Ressource Cloud Logging Événement
Projet Google Assistant Action Erreurs d'intent SYNC
Erreurs d'intent QUERY
Erreurs d'intent EXECUTE
Erreurs de notifications
Erreurs d'association de comptes
SDK Local Home HandlerError

Synchroniser les journaux

Le tableau ci-dessous répertorie le schéma d'une entrée syncLog:

Propriété Description
requestId ID de la demande d'intent pour la maison connectée.
httpLatencyMsec Temps écoulé avant la réception d'une réponse.
status Indique l'état de la réponse d'intent.

Journaux d'exécution

Le tableau ci-dessous répertorie le schéma d'une entrée executionLog:

Propriété Description
requestId ID de requête unique, par exemple 5325511189174727525.
latencyMsec Temps écoulé avant la réception d'une réponse, par exemple 6000.
executionType Transport utilisé pour la requête, par exemple CLOUD ou MATTER, en fonction de votre intégration
actionType Indicateur facultatif de l'action effectuée par l'utilisateur, par exemple QUERY ou EXECUTE. Pour les actions EXECUTE, inclut la commande envoyée au fulfillment pour les caractéristiques acceptées, par exemple ONOFF_OFF.
trait Attribut facultatif associé à cette action de l'utilisateur.
deviceTypes Liste des types d'appareils affectés par l'événement, par exemple LIGHT.
isSuccess Indique si la requête a reçu une réponse positive.
fallbackToCloud Indique si la requête a été acheminée vers le fulfillment cloud après une erreur du fulfillment local.
statusType Indique l'état de la réponse d'intent, tel que SUCCESS, PENDING ou OFFLINE. Pour les réponses ERROR, cette propriété contient l'identifiant errorCode fourni par le fulfillment.
externalDebugString Message de débogage détaillé (en option) associé à cette action de l'utilisateur.
locale Code de langue associé à la requête.

Journaux de notification

Le tableau ci-dessous répertorie le schéma d'une entrée notificationLog:

Propriété Description
requestId ID de la demande de notification.
structName Nom de la structure de notification, par exemple "ObjectDetection".
status Indique l'état de la notification.

Paramètre de niveau de journalisation

Les projets Cloud-to-cloud sont configurés pour recevoir les journaux d'erreurs par défaut. Les développeurs peuvent également choisir de recevoir des journaux de réussite. Cela est particulièrement utile lors de la phase de développement, lorsque vous prévoyez de capturer tous les journaux de quelques agents. Des frais supplémentaires peuvent s'appliquer à votre projet si vous dépassez le quota de journalisation.

Vous pouvez contrôler le niveau de journalisation de votre projet en:

  1. Dans Actions on Google Console, go to the Projects page.

    Accéder à la console Actions on Google

  2. Sélectionnez votre projet de maison connectée.

  3. Sélectionnez l'onglet Develop (Développer), puis cliquez sur Actions dans la barre latérale.

  4. Sélectionnez All (Tous) dans la liste déroulante Log control ingestion (Ingestion de contrôle des journaux).

Exclusions de journaux

Les développeurs peuvent créer des exclusions de journaux à l'aide du langage de requête de journalisation afin de personnaliser davantage leurs journaux de manière plus flexible. Le langage de requête Logging est également utilisé par l'explorateur de journaux, ce qui vous permet de créer des requêtes à l'aide de l'explorateur de journaux.

Vous pouvez suivre la procédure de création de filtres d'exclusion dans ce guide (configurez le filtre d'exclusion pour le récepteur _Default).

Métriques basées sur les journaux

Les développeurs peuvent utiliser des métriques basées sur les journaux pour suivre et analyser les tendances dans leurs journaux. Vous pouvez également créer des graphiques personnalisés et configurer des alertes pour les métriques basées sur les journaux.

Pour commencer à utiliser les métriques basées sur les journaux pour la maison connectée, consultez le guide de création de métriques de compteur basées sur les journaux.

Pour en savoir plus sur l'utilisation de Cloud Logging dans votre projet, consultez la documentation suivante:

  • Tarifs : informations sur les quotas d'attribution et les coûts de dépassement.
  • Quotas et limites : informations sur les limites et les règles de conservation pour l'utilisation de la journalisation.
  • Requêtes de journaux avancées : guide d'utilisation des expressions avancées pour interroger et analyser les données de journaux