Cloud Logging pour l'écosystème Google Home

<ph type="x-smartling-placeholder"></ph> Cloud à cloud    Litige

Vous pouvez accéder aux journaux d'événements de vos intégrations depuis Google Cloud Logging utiliser Cloud Logging pour explorer les journaux, et créer des métriques et des alertes ; exporter des journaux vers d'autres applications 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 à 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 les données de journalisation, consultez la page contrôle des accès.

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

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

Cloud Logging fournit les types de ressources suivants:

Type de ressource Nom à afficher Description Libellés
assistant_action_project Projet Google Assistant Action Conteneur du projet Google Cloud associé à un Assistant action.
  • project_id: identifiant de votre projet actuel associée à cette ressource, par exemple my-project

Journaux des événements

Les projets Cloud-to-cloud sont compatibles avec les événements suivants dans Cloud Journalisation:

Ressource Cloud Logging Événement
Projet Google Assistant Action Erreurs d'intent SYNC
Erreurs d'intent QUERY
Erreurs d'intent EXECUTE
Notifications erreurs
Association de comptes erreurs
SDK Local Home <ph type="x-smartling-placeholder"></ph> 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 requête d'intent pour la maison connectée.
httpLatencyMsec Délai avant réception d'une réponse.
status Indique l'état de la réponse de l'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 Le temps écoulé avant qu'une réponse ne soit reçue (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, la commande émise à fulfillment pour les caractéristiques acceptées, 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 à partir du traitement en local.
statusType Indique l'état de la réponse de l'intent, par exemple SUCCESS, PENDING ou OFFLINE. Pour ERROR des réponses, 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.

Journaux de notification

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, tel que "ObjectDetection".
status Indique le état de la notification.

Paramètre de niveau de journalisation

Cloud-to-cloud projets sont configurés pour recevoir des journaux d'erreurs par défaut. Les développeurs peuvent également choisir de recevoir des 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épasser le quota de journalisation.

Vous pouvez contrôler le niveau de journalisation de votre projet de différentes manières:

  1. Dans Actions on Google Console, accédez à la page "Projets".

    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 Tous dans la liste déroulante Ingestion du contrôle des journaux.

Entrées exclues des journaux

Les développeurs peuvent créer exclusions de journaux à l'aide d'une requête de journalisation langue pour personnaliser davantage leurs journaux de manière plus flexible. Langage de requête Logging est également utilisé par l'explorateur de journaux pour vous aider à créer requêtes.

Pour créer des filtres d'exclusion, suivez la procédure décrite sur la page ce guide (configurez le filtre d'exclusion pour le récepteur _Default).

Métriques basées sur les journaux

Les développeurs peuvent utiliser Métriques basées sur les journaux pour suivre et analyser des tendances dans leurs journaux. Il est également possible de créer des graphiques personnalisés et 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 Guide sur la création d'une métrique basée sur les journaux de compteur

Pour en savoir plus sur l'utilisation de Cloud Logging dans votre projet, consultez les ressources suivantes : documentation:

  • Pricing [Tarifs] : Détails sur les attributions et les coûts de dépassement.
  • Quotas et limites: Détails 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 des données de journaux.