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.
Journalisation des accès
Pour accéder à Cloud Logging depuis la 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é par Identity and Access Management (IAM) pour les utilisateurs de votre projet Actions. Pour en savoir plus sur les rôles et les autorisations concernant les données de journalisation, consultez 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 sont programmées pour être supprimées. Vous pouvez également supprimer des entrées à la demande à l'aide de l'interface de l'explorateur de journaux.
Pour savoir comment utiliser efficacement les 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 Assistant Google Action | Conteneur du projet Google Cloud associé à une action Assistant Action. |
|
Journaux des événements
Cloud-to-cloud projets sont compatibles avec les événements suivants dans Cloud Logging :
| Ressource Cloud Logging | Événement |
|---|---|
| Projet Assistant Google Action | SYNC erreurs d'intent |
| Erreurs d'intentQUERY | |
| EXECUTE Erreurs d'intent | |
| Notifications erreurs | |
| Erreurs d'association de compte | |
| SDK Local Home HandlerError |
Journaux de synchronisation
Le tableau ci-dessous répertorie le schéma d'une entrée syncLog :
| Propriété | Description |
|---|---|
requestId |
ID de la requête 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, selon votre intégration. |
actionType |
Indicateur facultatif de l'action utilisateur effectuée, par exemple
QUERY ou EXECUTE.
Pour les actions EXECUTE, inclut la commande émise pour le
traitement des caractéristiques compatibles, par exemple ONOFF_OFF
|
trait |
Caractéristique facultative associée à cette action utilisateur. |
deviceTypes |
Liste des types d'appareils concerné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 traitement cloud après une erreur de traitement 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 utilisateur. |
locale |
Code de langue associé à la requête. |
Journaux de notifications
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. |
Définition du niveau de journalisation
Cloud-to-cloud projets sont configurés pour recevoir les journaux d'erreurs par défaut, et les développeurs peuvent choisir de recevoir également les 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 procédant comme suit :
Dans la Actions on Google Console, accédez à la page Projets.
Sélectionnez votre projet de maison connectée.
Sélectionnez l'onglet Développer, puis cliquez sur Actions dans la barre latérale.
Sélectionnez Tout dans la liste déroulante Ingestion du contrôle des journaux.
Entrées exclues des journaux
Les développeurs peuvent créer des exclusions de journaux à l'aide du langage de requête de journalisation pour personnaliser davantage leurs journaux de manière plus flexible. Le langage de requête de journalisation est également utilisé par l'explorateur de journaux. Vous pouvez donc utiliser l'explorateur de journaux pour vous aider à créer des requêtes.
Vous pouvez suivre les étapes de création de 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 modèles dans leurs journaux. Il est également possible de créer des graphiques personnalisés et de configurer des alertes sur les métriques basées sur les journaux.
Pour commencer à utiliser des métriques basées sur les journaux pour la maison connectée, consultez le guide Créer une métrique de compteur basée sur les journaux.
Ressources associées
Pour en savoir plus sur l'utilisation de Cloud Logging dans votre projet, consultez la documentation suivante documentation :
- Tarifs: informations sur les quotas 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 journal.