You can access event logs for your integrations from Google Cloud Logging. Use Cloud Logging to explore logs, create metrics and alerts, or export logs to other applications using Google Cloud Pub/Sub.
Access Logging
To access Cloud Logging from the Google Cloud Console, click View all products, then go to Operations > Logging.
Access to logging data is managed through Identity and Access Management (IAM) for users of your Actions project. For more details on roles and permissions for logging data, see Cloud Logging access control.
Log entries are retained for 30 days per the Cloud Logging retention policy, then scheduled for deletion. You can also delete entries on demand by using the Logs Explorer interface.
You can learn more on how to use logs effectively in the Searching Logs section of the Troubleshooting guide.
Cloud Logging provides the following resource types:
Resource Type | Display Name | Description | Labels |
---|---|---|---|
assistant_action_project |
Google Assistant Action Project | A container for the Google Cloud Project associated with an Assistant Action. |
|
Execution logs
The table below lists the schema of an executionLog
entry:
Property | Description |
---|---|
requestId |
Unique request ID, for example 5325511189174727525 . |
latencyMsec |
Elapsed time before a response was received, for example,
6000 . |
executionType |
Transport used for the request, for example CLOUD or
MATTER , depending on your integration. |
actionType |
Optional indicator of the user action taken, for example
QUERY or EXECUTE .
For EXECUTE actions, includes the command issued to
fulfillment for supported traits, for example ONOFF_OFF
|
trait |
Optional trait associated with this user action. |
deviceTypes |
List of device types affected by the event, for example
LIGHT . |
isSuccess |
Whether the request received a successful response. |
fallbackToCloud |
Whether the request routed to cloud fulfillment following an error from local fulfillment. |
statusType |
Indicates the status of the intent response, such as SUCCESS ,
PENDING , or OFFLINE . For ERROR
responses, this property contains
the errorCode provided by the fulfillment.
|
externalDebugString |
Optional detailed debugging message associated with this user action. |
locale |
Language code associated with the request. |
Log exclusions
Developers can create log exclusions using logging query language to further customize their logs in a more flexible way. Logging query language is also used by Logs Explorer so you can use Logs Explorer to help create queries.
You can follow the steps for creating exclusion filters at
this guide
(configure the exclusion filter for the _Default
sink).
Log-based metrics
Developers can use Log-based metrics to track and analyze patterns within their logs. It is also possible to create custom charts and set up alerts on log-based metrics.
To start using log-based metrics for smart home, check out creating a counter log-based metric guide.
Related resources
To learn more about using Cloud Logging in your project, see the following documentation:
- Pricing: Details on allotments and overage costs.
- Quotas and limits: Details on limits and retention policies for logging usage.
- Advanced logs queries: Guide to using advanced expressions to query and analyze log data.