Vous pouvez accéder aux journaux des événements pour vos intégrations à partir de 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 > 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 pour Cloud Logging.
Les entrées de journal sont conservées pendant 30 jours conformément à la règle de conservation Cloud Logging, puis leur 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. |
|
Journaux des événements
Les projets Cloud-to-cloud sont compatibles avec les événements suivants dans Cloud Logging:
| Ressource Cloud Logging | Événement |
|---|---|
| Projet Google Assistant Action | Erreurs d'intent SYNC |
| Erreurs d'intent QUERY | |
| Erreurs d'intent EXECUTE | |
| Erreurs Notifications | |
| Erreurs d'association de comptes | |
| SDK Local Home HandlerError |
Synchroniser les journaux
Le tableau ci-dessous présente le schéma d'une entrée syncLog:
| Propriété | Description |
|---|---|
requestId |
ID de la demande d'intent de 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 présente 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 de l'utilisateur, par exemple QUERY ou EXECUTE.
Pour les actions EXECUTE, incluez la commande envoyée au traitement pour les traits compatibles, par exemple ONOFF_OFF.
|
trait |
Caractère facultatif associé à cette action de l'utilisateur. |
deviceTypes |
Liste des types d'appareils concernés par l'événement, par exemple LIGHT |
isSuccess |
Indique si la demande a reçu une réponse positive. |
fallbackToCloud |
Indique si la requête a été acheminée vers le traitement cloud après une erreur du traitement en local. |
statusType |
Indique l'état de la réponse d'intent, par exemple SUCCESS, PENDING ou OFFLINE. Pour les réponses ERROR, cette propriété contient le errorCode fourni par le traitement.
|
externalDebugString |
Message de débogage détaillé facultatif associé à cette action de l'utilisateur. |
locale |
Code de langue associé à la requête. |
Journaux de notifications
Le tableau ci-dessous présente 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 les journaux de réussite. Cela est particulièrement utile pendant 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:
Dans Actions on Google Console, accédez à la page "Projets".
Sélectionnez votre projet de maison connectée.
Sélectionnez l'onglet Develop (Développer), puis cliquez sur Actions dans la barre latérale.
Sélectionnez Tous dans la liste déroulante Ingestion de commande de 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 l'utiliser pour créer des requêtes.
Vous pouvez suivre la procédure pour créer des filtres d'exclusion dans ce guide (configurer 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. Il est également possible de créer des graphiques personnalisés et de 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 Créer des métriques basées sur les journaux de compteur.
Ressources associées
Pour en savoir plus sur l'utilisation de Cloud Logging dans votre projet, consultez la documentation suivante:
- Tarification : informations sur les attributions 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 sur l'utilisation des expressions avancées pour interroger et analyser les données de journaux.