Troubleshooting your Actions

In the event that your Actions project fails or seems to be working poorly, the cause of the issue may not be obvious. From the Actions console, you can view detailed logs for your project that can give you more insight into what's going on.

View your project's logs

Your project's logs can be accessed via the Actions Console under Analytics:

  1. On your project in the Actions console, select Analytics in the top menu.
  2. Select the Health tab near the top of the page.
  3. Under Errors, select the View Logs link on the upper-right corner:

This link will take you to your project's logs in the Google Cloud Platform, where you can filter, expand, and analyze the log data that has been collected.

If you're using the Actions Simulator to test your Actions, you can quickly access logs specific to your tests by clicking the View Logs link on the upper-right corner of the Actions Simulator page.

Troubleshooting

Log entries are marked with levels that indicate urgency. If you're troubleshooting a problem with your Actions project, you will probably want to start by filtering for Critical, Error, and Warning events:

Every log entry has a summary that includes a timestamp and short description of the event. You can correlate your project's behavior with these log timestamps to determine if they are related, and reference the description to narrow down the cause.

In the example below, an UnparseableJsonResponse error was returned, likely as the result of a syntax or timeout error when recieving this JSON response from the webhook:

You may also want to look for Debug events with a similar timestamp, as they can include additional information about other events. By expanding an error log and filtering by the trace field, the resulting list will show you all events associated with the initial error:

In the example below, the debug messages associated with the original error give us additional information about the issue, including a detailed error description and the specific JSON response that caused the issue:

Disabling log types

Since the logs for your project are comprehensive, you may find it valuable to exclude certain event types from appearing in your logs by default (such as events with PII or events that you deem to be clutter). You can create exclusions on your project's log page by navigating to Resource usage on the left navigation bar and selecting the Exclusions tab:

You can learn more about excluding different log events at Excluding Logs on the Stackdriver documentation.