Local Analytics for Smart Home Endpoints (Beta)

---

The Local Analytics page in the Alexa developer console provides business adoption metrics for smart home devices that connect to your Alexa smart home add-on. You can view and analyze these metrics in the Local Analytics dashboard in the Alexa developer console. You can access this dashboard through a custom smart home URL that you receive from your Amazon Business Development representative.

About your local analytics metrics

The Local Analytics dashboard displays business adoption metrics for your smart home add-on, such as the following:

• Total number of unique appliances or other smart home devices registered with the add-on over the selected time interval.
• Total number of unique customers registered with the add-on over the selected time interval.
• Actions on the add-on.

You can select the time interval to view the metrics. Options include Last 7 Days, Last 30 Days, Custom Range.

Access your local analytics dashboard

To access your Local Analytics dashboard

1. Sign in to the Alexa developer console.
2. Navigate to that Alexa smart home custom analytics URL that you received from your business representative.

3. In the Summary page, you can see a high-level view of your devices, customers, and actions.

   

4. In the left pane, to view details about customer engagement, click Customers.

   

5. In the left pane, to view details about unique registered devices, click Devices.

   

6. In the left pane, to view details about add-on actions, click Actions.

   

7. To select the time interval, under Time Interval (UTC), click the Last 7 Days, Last 30 Days, or Custom Range button.
   If you select the custom range, on the calendar, click the start date, and then click the end date.
8. In the Aggregation Period drop-down, choose the aggregation period for the time interval.
   Options include Hourly, Daily, Weekly. Available aggregation periods depend on the selected time interval.

Interpret metrics

The Summary section of the Local Analytics dashboard displays an overview of the metrics available for the add-on:

• Registered Unique Devices – Total number of unique smart home appliances registered with the add-on during the selected time interval.

• Registered Unique Customers – Total number of unique customers registered with the add-on during the selected time interval.

• CapabilityDirective – Total number of directives that Alexa sends to your add-on to trigger a capability, such as turning on a light, when a customer asks Alexa to control their smart device. For the directives that this metric represents, see the documentation for each interface that your add-on supports.

• Discovery – Total number of Discovery requests that Alexa sends to your add-on or to the customer's local network to discover your customer's smart devices.

  This metric is a sum of the following discover options:

  • Local route discovery – This flow enables local route adoption.
  • Smart home adoption – This feature uses local detection to discover Alexa-capable smart home appliances on a customer's local network. Local detection runs every few hours on all customer Echo devices.
  • Silent discovery – If any CapabilityDirective or Query request to the add-on fails, Alexa triggers silent discovery, or rediscovery of already discovered appliances, to account for changes in properties, such as IP address.

• Query – Total number of ReportState requests and endpoint health checks that Alexa sends to your add-on to request the state of an endpoint.

  Most of the volume that you see comes from endpoint health check. Echo devices have a predetermined algorithm that checks periodically to see whether the Echo can reach the endpoint. The check determines if the local route to each smart home device is healthy.

Related topics

• Troubleshoot Smart Home and Video Endpoints with Message IDs
• Skill Metrics FAQ
• View Metrics

---

---

Last updated: Oct 30, 2025