Action Health Checks

Google monitors deployed Actions to verify they're available and responding to user requests.

Each Action's endpoint is required to respond to a default, no parameter, explicit invocation intent. This supports the scenario where the user asks to talk to the Action without providing any specific need (e.g. "I want to talk to invocation name").

Common questions

Do I need to implement anything specific to support the health checks? No, Action health checks will function like a standard request to talk to an Action.

How often will my Action's health be checked? Your Action may be monitored throughout the day.

How can I detect that a request is a health check? Google adds an argument to the request body so that you can detect a health check in your analytics. The launch intent request from Google will have an “is_health_check” argument passed to the intent, as the following example shows. This is found in the Input object of the webhook request:

{
  "rawInputs": [

    ...

  ],
  "intent": com.example.name.intent,
  "arguments": [
    {
      "name": "is_health_check",
      "text_value": "1"
    }
  ],
}

What happens if Google detects that an Action is unhealthy? If Google detects that the Action is experiencing an outage, the Action is suspended. Users requesting the unhealthy Action will hear “app is not available”.

How will I be notified if an Action is marked as unhealthy? Upon detecting an unhealthy Action, the account that was used to create or update the Action will receive an email from Google.

How can I check my Action's health status? You can check your developer console and see the status of your Action. Unhealthy Actions will have a status of Unhealthy. Healthy Actions will be marked as Deployed.

What’s the process for returning an app to the deployed state? You should review your deployment and address any issues that might be causing the Action to fail to respond to a launch intent.

Google will continue to periodically monitor the Action's health while it is unhealthy. When Google detects that the Action is responding as expected, the Action will return to the deployed state.