Merge pull request #77889 from ajlam/iperf-preview

MySQL iPerf preview

Author: v-albemi

articles/mysql/TOC.yml

@@ -89,14 +89,20 @@
       href: concepts-business-continuity.md
     - name: Backup and restore
       href: concepts-backup.md
-  - name: Monitor
+  - name: Monitor and tune
     items:
-    - name: Monitor
+    - name: Monitor and tune
       href: concepts-monitoring.md
     - name: Slow query logs
       href: concepts-server-logs.md
     - name: Audit logs
       href: concepts-audit-logs.md
+    - name: Query Store
+      href: concepts-query-store.md
+    - name: Query Performance Insight
+      href: concepts-query-performance-insight.md
+    - name: Performance Recommendations
+      href: concepts-performance-recommendations.md
   - name: Development
     items:
     - name: Drivers and tools compatibility

articles/mysql/concepts-monitoring.md

@@ -1,11 +1,11 @@
 ---
 title: Monitoring in Azure Database for MySQL
 description: This article describes the metrics for monitoring and alerting for Azure Database for MySQL, including CPU, storage, and connection statistics.
-author: rachel-msft
-ms.author: raagyema
+author: ajlam
+ms.author: andrela
 ms.service: mysql
 ms.topic: conceptual
-ms.date: 11/05/2018
+ms.date: 06/05/2019
 ---
 # Monitoring in Azure Database for MySQL
 Monitoring data about your servers helps you troubleshoot and optimize for your workload. Azure Database for MySQL provides various metrics that give insight into the behavior of your server.
@@ -37,6 +37,15 @@ These metrics are available for Azure Database for MySQL:
 ## Server logs
 You can enable slow query and audit logging on your server. These logs are also available through Azure Diagnostic Logs in Azure Monitor logs, Event Hubs, and Storage Account. To learn more about logging, visit the [audit logs](concepts-audit-logs.md) and [slow query logs](concepts-server-logs.md) articles.
 
+## Query Store
+[Query Store](concepts-query-store.md) is a public preview feature that keeps track of query performance over time including query runtime statistics and wait events. The feature persists query runtime performance information in the **mysql** schema. You can control the collection and storage of data via various configuration knobs.
+
+## Query Performance Insight
+[Query Performance Insight](concepts-query-performance-insight.md) works in conjunction with Query Store to provide visualizations accessible from the Azure portal. These charts enable you to identify key queries that impact performance. Query Performance Insight is in public preview and is accessible in the **Intelligent Performance** section of your Azure Database for MySQL server's portal page.
+
+## Performance Recommendations
+The [Performance Recommendations](concepts-performance-recommendations.md) feature identifies opportunities to improve workload performance. The public preview release of Performance Recommendations provides you with recommendations for creating new indexes that have the potential to improve the performance of your workloads. To produce index recommendations, the feature takes into consideration various database characteristics, including its schema and the workload as reported by Query Store. After implementing any performance recommendation, customers should test performance to evaluate the impact of those changes.
+
 ## Next steps
 - See [How to set up alerts](howto-alert-on-metric.md) for guidance on creating an alert on a metric.
 - For more information on how to access and export metrics using the Azure portal, REST API, or CLI, see the [Azure Metrics Overview](../monitoring-and-diagnostics/monitoring-overview-metrics.md).

articles/mysql/concepts-performance-recommendations.md

@@ -0,0 +1,48 @@
+---
+title: Performance recommendations in Azure Database for MySQL
+description: This article describes the Performance Recommendation feature in Azure Database for MySQL
+author: ajlam
+ms.author: andrela
+ms.service: mysql
+ms.topic: conceptual
+ms.date: 05/23/2019
+---
+# Performance Recommendations in Azure Database for MySQL
+
+**Applies to:** Azure Database for MySQL 5.7
+
+> [!NOTE]
+> Performance Recommendations is in preview. Support for Performance Recommendations in the Azure portal is being rolled out and may not yet be available in your region.
+
+The Performance Recommendations feature analyzes your databases to create customized suggestions for improved performance. To produce the recommendations, the analysis looks at various database characteristics including schema. Enable [Query Store](concepts-query-store.md) on your server to fully utilize the Performance Recommendations feature. If performance schema is OFF, turning on Query Store enables performance_schema and a subset of performance schema instruments required for the feature. After implementing any performance recommendation, you should test performance to evaluate the impact of those changes.
+
+## Permissions
+
+**Owner** or **Contributor** permissions required to run analysis using the Performance Recommendations feature.
+
+## Performance recommendations
+
+The [Performance Recommendations](concepts-performance-recommendations.md) feature analyzes workloads across your server to identify indexes with the potential to improve performance.
+
+Open **Performance Recommendations** from the **Intelligent Performance** section of the menu bar on the Azure portal page for your MySQL server.
+
+![Performance Recommendations landing page](./media/concepts-performance-recommendations/performance-recommendations-page.png)
+
+Select **Analyze** and choose a database, which will begin the analysis. Depending on your workload, the analysis may take several minutes to complete. Once the analysis is done, there will be a notification in the portal. Analysis performs a deep examination of your database. We recommend you perform analysis during off-peak periods.
+
+The **Recommendations** window will show a list of recommendations if any were found and the related query ID that generated this recommendation. With the query ID, you can use the [mysql.query_store](concepts-query-store.md#mysqlquery_store) view to learn more about the query.
+
+![Performance Recommendations new page](./media/concepts-performance-recommendations/performance-recommendations-result.png)
+
+Recommendations are not automatically applied. To apply the recommendation, copy the query text and run it from your client of choice. Remember to test and monitor to evaluate the recommendation.
+
+## Recommendation types
+
+Currently, only *Create Index* recommendations are supported.
+
+### Create Index recommendations
+
+*Create Index* recommendations suggest new indexes to speed up the most frequently run or time-consuming queries in the workload. This recommendation type requires [Query Store](concepts-query-store.md) to be enabled. Query Store collects query information and provides the detailed query runtime and frequency statistics that the analysis uses to make the recommendation.
+
+## Next steps
+- Learn more about [monitoring and tuning](concepts-monitoring.md) in Azure Database for MySQL.

articles/mysql/concepts-query-performance-insight.md

@@ -0,0 +1,47 @@
+---
+title: Query Performance Insight in Azure Database for MySQL
+description: This article describes the Query Performance Insight feature in Azure Database for MySQL
+author: ajlam
+ms.author: andrela
+ms.service: MySQL
+ms.topic: conceptual
+ms.date: 06/05/2019
+---
+# Query Performance Insight in Azure Database for MySQL
+
+**Applies to:** Azure Database for MySQL 5.7
+
+> [!NOTE]
+> Query Performance Insight is in preview. Support for Query Performance Insight in the Azure portal is being rolled out and may not yet be available in your region.
+
+Query Performance Insight helps you to quickly identify what your longest running queries are, how they change over time, and what waits are affecting them.
+
+## Permissions
+
+**Owner** or **Contributor** permissions required to view the text of the queries in Query Performance Insight. **Reader** can view charts and tables but not query text.
+
+## Prerequisites
+
+For Query Performance Insight to function, data must exist in the [Query Store](concepts-query-store.md).
+
+## Viewing performance insights
+
+The [Query Performance Insight](concepts-query-performance-insight.md) view in the Azure portal will surface visualizations on key information from Query Store.
+
+In the portal page of your Azure Database for MySQL server, select **Query Performance Insight** under the **Intelligent Performance** section of the menu bar.
+
+![Query Performance Insight long running queries](./media/concepts-query-performance-insight/query-performance-insight-landing-page.png) 
+
+The **Long running queries** tab shows the top 5 queries by average duration per execution, aggregated in 15-minute intervals. You can view more queries by selecting from  the **Number of Queries** drop down. The chart colors may change for a specific Query ID when you do this.
+
+You can click and drag in the chart to narrow down to a specific time window. Alternatively, use the zoom in and out icons to view a smaller or larger time period respectively.
+
+Select the **Wait Statistics** tab to view the corresponding visualizations on waits in the server.
+
+Queries displayed in the wait statistics view are grouped by the queries that exhibit the largest waits during the specified time interval.
+
+![Query Performance Insight waits statistics](./media/concepts-query-performance-insight/query-performance-insight-wait-statistics.png)
+
+## Next steps
+
+- Learn more about [monitoring and tuning](concepts-monitoring.md) in Azure Database for MySQL.