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 le Google Cloud Console, cliquez sur Afficher tous les produits, puis accédez à Observabilité > Journalisation.
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 les données de journalisation, consultez Contrôle des accès dans Cloud Logging.
Les entrées de journal sont conservées pendant 30 jours conformément aux règles de conservation de Cloud Logging, puis planifiées pour suppression. 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 dans les 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 d'une action de l'Assistant Google | Conteneur du projet Google Cloud associé à une action de l'Assistant. |
|
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, selon 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 compatibles, par exemple ONOFF_OFF.
|
trait |
Caractéristique facultative associée à cette action de l'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 à la suite d'une erreur du traitement local. |
statusType |
Indique l'état de la réponse de l'intent, par exemple SUCCESS, PENDING ou OFFLINE. Pour les réponses ERROR, cette propriété contient le errorCode fourni par le fulfillment.
|
externalDebugString |
Message de débogage détaillé facultatif associé à cette action utilisateur. |
locale |
Code de langue associé à la requête. |
Entrées exclues des journaux
Les développeurs peuvent créer des exclusions de journaux à l'aide du langage de requête Logging pour personnaliser davantage leurs journaux de manière plus flexible. Le langage de requête Logging est également utilisé par l'explorateur de journaux. Vous pouvez donc l'utiliser pour créer des requêtes.
Pour créer des filtres d'exclusion, suivez les étapes de 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 modèles présents 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 les 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 :
- 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 Logging.
- Requêtes de journaux avancées : guide d'utilisation des expressions avancées pour interroger et analyser les données de journaux.