

# Viewing Amazon Q Business and Q App metrics in analytics dashboards
<a name="analytics-dashboard"></a>

The analytics dashboards in Amazon Q Business offer a comprehensive view of key usage metrics and trends about the Amazon Q application environment and Amazon Q Apps. This centralized hub presents the CloudWatch metrics as interactive charts and visualizations for you to review. There are two dashboards:
+ Amazon Q Business Analytics dashboard – Use this dashboard to learn how users are interacting with a specific Amazon Q Business application environment. For example, you can identify trends in usage, conversation, feedback, and queries.
+  Amazon Q App Analytics dashboard – Use this dashboard to learn how your users are interacting with Q Apps. For example, you can identify the average daily users creating, updating, or running Q Apps over a specific time period.

As an Amazon Q admin, you can view the dashboards with the Amazon Q Business console. You can view the metrics in these dashboards over different pre-selected time intervals. They are available at no additional charge in all Regions where the Amazon Q Business service is offered.

**Topics**
+ [

# Viewing the analytics dashboards
](analytics-dashboard-view.md)
+ [

# Amazon Q Business Analytics dashboard metrics
](analytics-dashboard-metrics.md)
+ [

# Amazon Q Apps Analytics dashboard metrics
](q-apps-analytics-dashboard-metrics.md)

# Viewing the analytics dashboards
<a name="analytics-dashboard-view"></a>

To view the Amazon Q Business Analytics dashboard or Amazon Q Apps Analytics dashboard with the Amazon Q Business console, you choose your application environment and navigate to the Analytics dashboard page. 

**To view the analytics dashboards**

1. Sign in to the Amazon Q Business console at [https://console.aws.amazon.com/amazonq/business/](https://console.aws.amazon.com/amazonq/business).

1. In the left navigation pane, choose **Applications**.

1. From the **Applications** section in the center pane, choose the *Name* of application environment that you want to see the Analytics for. 

1. In the left navigation pane, choose **Insights**.Choose between **Amazon Q Business** or **Amazon Q Apps** to view the relevant dashboard for your application environment. For information about the metrics that appear, see [Amazon Q Business Analytics dashboard metrics](analytics-dashboard-metrics.md) or[Amazon Q Apps Analytics dashboard metrics](q-apps-analytics-dashboard-metrics.md).

1. Use the date picker to specify the time interval for the graphs. You can choose from the following preset intervals.
   + Last week – This interval starts from the previous Sunday at 00:00 and goes until the following Sunday at 00:00 in the UTC time zone.
   + This week – This interval starts this Sunday at 00:00 and goes until 00:00 today in the UTC time zone.
   + Last month – This interval begins on the 1st day of the last month at 00:00 and ends on the first day of this month at 00:00 in the UTC time zone.
   + This month – This interval begins on the 1st day of this month at 00:00 and goes until 00:00 today in the UTC time zone.

# Amazon Q Business Analytics dashboard metrics
<a name="analytics-dashboard-metrics"></a>

The Amazon Q Business dashboard provides a comprehensive view of key metrics to help admins understand the performance and usage of every Amazon Q application environment from the Amazon Q Business console.

The following analytics are available in the dashboard for the specified time period.
+ **Average daily active users**

  This tile gives the average number of unique daily users for the application environment that participated in at least one chat session for the chosen period.
**Note**  
This metric is calculated using the *Maximum* statistic. For more information, see [CloudWatch statistics definitions](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html).
+ **Total users**

  All the users of this application environment.
+ **Weekly active users**

  This tile gives the total number of unique users for the application environment who participated in at least one chat session for the week in the chosen period.
+ **Monthly active users**

  This tile gives the total number of unique users for the application environment who participated in at least one chat session for the month in the chosen period.
+ **Total conversations**

  This tile gives the total number of chat conversations that have occurred in this application environment. Conversations are different from individual chat queries and represent a collection of related queries and responses over a relevant session or subject. 
+ **Total queries**

  This tile gives the total number of chat message queries received by this application environment.
+ **Average queries per user**

  This tile gives the average of daily chat queries for divided by the daily active unique users for that application environment for the chosen period. 
+ **Average queries per conversation**

  This tile gives the average of total chat queries to an application environment divided by the total individual conversations in the application environment. Conversations refer to new chat threads, which are listed on the left navigation pane of the web experience for the application environment.
+ **Total plugins**

  This tile shows the total number of plug-ins currently used by this application environment.
+ **Most frequently used plugin**

  This tile shows the plug-in most frequently used by this application environment.
+ The **Overview** trend

  This line chart displays two trend lines - one showing the daily active users for each day for the application environment, and another showing the total daily individual chat queries received by the application environment.
+ The **Customer feedback** trend

  This line chart displays three trend lines for the application environment.
  + The number of thumbs up feedback.
  + The number of thumbs down feedback.
  + The number of chat message responses that did not receive any feedback thumbs up or thumbs down).
+ The **Thumbs down reasons** chart

  This pie chart represents the different feedback reasons that users choose when providing a thumbs down feedback, along with the count or percentage of times each reason was selected. You can also filter by feedback reasons to further see the top queries that resulted in the feedback or choose **view details to resolve issues** to see all the queries for further evaluation.
  + The **Thumbs-down feedback queries** 

    This page shows the list of queries that resulted in an unsuccessful response for further evaluation. You can choose any query to view details and see **Recommendations** on how to possibly resolve the issue.
**Note**  
A maximum of *5000* query responses will be loaded initially for evaluation. You can always search for specific queries.
The empty columns in some rows indicate that you need to update the **Vended log deliveries** configuration in **Admin-controls-guardrails page**.
+ The **Unsuccessful query responses** chart

  This pie chart represents the breakdown between unsuccessful query responses because the answer was not found or the answer was blocked due to your guardrails settings. You can also filter by response type further to see the top queries that resulted in the response or choose **view details to resolve** issues to see all the queries for further evaluation.
  + The **Unsuccessful response queries** 

    This page shows the list of queries that resulted in an unsuccessful response for further evaluation. You can choose any query to view details and see **Recommendations** on how to possibly resolve the issue.
**Note**  
A maximum of *5000* query responses will be loaded initially for evaluation. You can always search for specific queries.
The empty columns in some rows indicate that you need to update the **Vended log deliveries** configuration in **Admin-controls-guardrails page**.
+ The **Queries** trend

  This chart displays three trend lines.
  + The number of chat queries that included a file upload.
  + The number of instances where the chat queries was blocked by the guardrails set.
  + The number of instances where the application environment was unable to find a relevant answer to the user's query.
+ The **Plugins** chart

  This bar chart shows the number of times users have selected each of the available plugins per day. For example, *ServiceNow*, *Salesforce*, *JIRA*, *Zendesk*, *Custom*, etc. when sending a query to the application environment.
+ The **Conversations** chart

  This bar chart shows the total number of conversations per day for the specified date range. Conversations are different from individual chat queries, and represent a collection of related queries and responses over a relevant session.
+ The **Average queries per conversation** trend

  This bar chart calculates the average number of queries per conversation by dividing the total number of daily queries by the total number of conversations per day for the application environment. Conversations are listed on the left navigation pane of the web experience, and each conversation represents a collection of related chat messages. The chart indicates the average length of conversations, as measured by the total number of chat messages from the first to the last message in a given conversation thread.

# Amazon Q Apps Analytics dashboard metrics
<a name="q-apps-analytics-dashboard-metrics"></a>

The Amazon Q Apps dashboard provides a comprehensive view of key metrics to help admins understand the performance and usage of Q Apps.

If the metrics are not populated in the dashboard, it is likely due to the absence of a Q Apps service role or the role is not configured properly in the Amazon Q Business application environment. Usually a banner will be displayed on the Amazon Q Business console to prompt creating and registering the Q Apps service role.

Depending on how you set up the Amazon Q Business application environment prior to the introduction of analytics dashboard feature, the banner might not always appear. To resolve the issue, go to the **Admin controls and guardrails** page for the Amazon Q Business application environment, choose **Edit Global Control** and re-save the configuration without changes. The metrics should start populating in 10 minutes. 

The following analytics are available in the Amazon Q Apps Analytics dashboard for the specified time period.
+ **Active users**

  The average unique daily users creating, updating, or running Q Apps.
+ **Active creators**

  The average unique daily users creating or updating Q Apps.
+ **Total Q Apps**

  The average of the total Q Apps per day.
+ **Active Q Apps**

  The average number of daily Q Apps ran or updated.
+ **Q App Participants trend**

  A trend of the daily active users and the daily active creators.
+ **Q App trend**

  A trend of the total daily Q Apps created and the daily active Q Apps.
+ **Total Q Apps Runs trend**

  A trend of the total daily Q App runs.
+ **Published Q App trend**

  A trend of the total daily published Q Apps.