Merge pull request #57662 from ajlam/master

MariaDB CLI docs and concepts monitor - retry PR

Author: TrishaMc

articles/mariadb/TOC.yml

@@ -21,6 +21,8 @@
     items:
     - name: Azure portal
       href: tutorial-design-database-using-portal.md
+    - name: Azure CLI
+      href: tutorial-design-database-cli.md
 - name: Concepts
   items:
   - name: DB & Servers
@@ -29,8 +31,6 @@
       href: concepts-servers.md
     - name: Supported versions
       href: concepts-supported-versions.md
-    - name: Server logs
-      href: concepts-server-logs.md
     - name: High availability
       href: concepts-high-availability.md
   - name: Resources
@@ -51,6 +51,12 @@
       href: concepts-business-continuity.md
     - name: Backup and restore
       href: concepts-backup.md
+  - name: Monitor
+    items:
+    - name: Monitor
+      href: concepts-monitoring.md
+    - name: Server logs
+      href: concepts-server-logs.md
   - name: Development
     items:
     - name: Connection resiliency
@@ -65,10 +71,14 @@
     items:
     - name: Azure portal
       href: howto-manage-firewall-portal.md
+    - name: Azure CLI
+      href: howto-manage-firewall-cli.md
   - name: Restore a server
     items:
     - name: Azure portal
       href: howto-restore-server-portal.md
+    - name: Azure CLI
+      href: howto-restore-server-cli.md
   - name: Migrate a database
     items:
     - name: Dump & restore
@@ -85,10 +95,14 @@
     items:
     - name: Azure portal
       href: howto-server-parameters.md
+    - name: Azure CLI
+      href: howto-configure-server-parameters-cli.md
   - name: Access server logs
     items:
     - name: Azure portal
       href: howto-configure-server-logs-portal.md
+    - name: Azure CLI
+      href: howto-configure-server-logs-cli.md
   - name: Replication
     items:
     - name: Configure data-in replication

articles/mariadb/concepts-monitoring.md

@@ -0,0 +1,47 @@
+---
+title: Monitoring in Azure Database for MariaDB
+description: This article describes the metrics for monitoring and alerting for Azure Database for MariaDB, including CPU, storage, and connection statistics.
+services: mariadb
+author: rachel-msft
+ms.author: raagyema
+manager: kfile
+editor: jasonwhowell
+ms.service: mariadb
+ms.topic: article
+ms.date: 11/10/2018
+---
+# Monitoring in Azure Database for MariaDB
+Monitoring data about your servers helps you troubleshoot and optimize for your workload. Azure Database for MariaDB provides various metrics that give insight into the behavior of your server.
+
+## Metrics
+All Azure metrics have a one-minute frequency, and each metric provides 30 days of history. You can configure alerts on the metrics. Other tasks include setting up automated actions, performing advanced analytics, and archiving history. For more information, see the [Azure Metrics Overview]
+(../monitoring-and-diagnostics/monitoring-overview-metrics.md).
+
+<!--For step by step guidance, see [How to set up alerts](howto-alert-on-metric.md). -->
+
+### List of metrics
+These metrics are available for Azure Database for MariaDB:
+
+|Metric|Metric Display Name|Unit|Description|
+|---|---|---|---|---|
+|cpu_percent|CPU percent|Percent|The percentage of CPU in use.|
+|memory_percent|Memory percent|Percent|The percentage of memory in use.|
+|io_consumption_percent|IO percent|Percent|The percentage of IO in use.|
+|storage_percent|Storage percentage|Percent|The percentage of storage used out of the server's maximum.|
+|storage_used|Storage used|Bytes|The amount of storage in use. The storage used by the service may include the database files, transaction logs, and the server logs.|
+|serverlog_storage_percent|Server Log storage percent|Percent|The percentage of server log storage used out of the server's maximum server log storage.|
+|serverlog_storage_usage|Server Log storage used|Bytes|The amount of server log storage in use.|
+|serverlog_storage_limit|Server Log storage limit|Bytes|The maximum server log storage for this server.|
+|storage_limit|Storage limit|Bytes|The maximum storage for this server.|
+|active_connections|Active Connections|Count|The number of active connections to the server.|
+|connections_failed|Failed Connections|Count|The number of failed connections to the server.|
+|network_bytes_egress|Network Out|Bytes|Network Out across active connections.|
+|network_bytes_ingress|Network In|Bytes|Network In across active connections.|
+
+## Server logs
+You can enable slow query logging on your server. To learn more about logging, visit the [server logs](concepts-server-logs.md) page.
+
+## Next steps
+- 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).
+
+<!-- - See [How to set up alerts](howto-alert-on-metric.md) for guidance on creating an alert on a metric.-->

articles/mariadb/howto-configure-server-logs-cli.md

@@ -0,0 +1,53 @@
+---
+title: Access server logs in Azure Database for MariaDB by using Azure CLI
+description: This article describes how to access the server logs in Azure Database for MariaDB by using the Azure CLI command-line utility.
+services: mariadb
+author: rachel-msft
+ms.author: raagyema
+manager: kfile
+editor: jasonwhowell
+ms.service: mariadb
+ms.devlang: azure-cli
+ms.topic: article
+ms.date: 11/10/2018
+---
+# Configure and access server logs by using Azure CLI
+You can download the Azure Database for MariaDB server logs by using Azure CLI, the Azure command-line utility.
+
+## Prerequisites
+To step through this how-to guide, you need:
+- [Azure Database for MariaDB server](quickstart-create-mariadb-server-database-using-azure-cli.md)
+- The [Azure CLI](/cli/azure/install-azure-cli) or Azure Cloud Shell in the browser
+
+## Configure logging for Azure Database for MariaDB
+You can configure the server to access the MariaDB slow query log by taking the following steps:
+1. Turn on logging by setting the **slow\_query\_log** parameter to ON.
+2. Adjust other parameters, such as **long\_query\_time** and **log\_slow\_admin\_statements**.
+
+To learn how to set the value of these parameters through Azure CLI, see [How to configure server parameters](howto-configure-server-parameters-cli.md).
+
+For example, the following CLI command turns on the slow query log, sets the long query time to 10 seconds, and then turns off the logging of the slow admin statement. Finally, it lists the configuration options for your review.
+```azurecli-interactive
+az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver --value ON
+az mariadb server configuration set --name long_query_time --resource-group myresourcegroup --server mydemoserver --value 10
+az mariadb server configuration set --name log_slow_admin_statements --resource-group myresourcegroup --server mydemoserver --value OFF
+az mariadb server configuration list --resource-group myresourcegroup --server mydemoserver
+```
+
+## List logs for Azure Database for MariaDB server
+To list the available log files for your server, run the [az mariadb server-logs list](/cli/azure/mariadb/server-logs#az-mariadb-server-logs-list) command.
+
+You can list the log files for server **mydemoserver.mariadb.database.azure.com** under the resource group **myresourcegroup**. Then direct the list of log files to a text file called **log\_files\_list.txt**.
+```azurecli-interactive
+az mariadb server-logs list --resource-group myresourcegroup --server mydemoserver > log_files_list.txt
+```
+## Download logs from the server
+With the [az mariadb server-logs download](/cli/azure/mariadb/server-logs#az-mariadb-server-logs-download) command, you can download individual log files for your server.
+
+Use the following example to download the specific log file for the server **mydemoserver.mariadb.database.azure.com** under the resource group **myresourcegroup** to your local environment.
+```azurecli-interactive
+az mariadb server-logs download --name mysql-slow-mydemoserver-2018110800.log --resource-group myresourcegroup --server mydemoserver
+```
+
+## Next steps
+- Learn about [server logs in Azure Database for MariaDB](concepts-server-logs.md).

articles/mariadb/howto-configure-server-parameters-cli.md

@@ -0,0 +1,96 @@
+---
+title: Configure the service parameters in Azure Database for MariaDB
+description: This article describes how to configure the service parameters in Azure Database for MariaDB using the Azure CLI command line utility.
+services: mariadb
+author: ajlam
+ms.author: andrela
+manager: kfile
+editor: jasonwhowell
+ms.service: mariadb
+ms.devlang: azure-cli
+ms.topic: article
+ms.date: 11/09/2018
+---
+# Customize server configuration parameters by using Azure CLI
+You can list, show, and update configuration parameters for an Azure Database for MariaDB server by using Azure CLI, the Azure command-line utility. A subset of engine configurations is exposed at the server-level and can be modified.
+
+## Prerequisites
+To step through this how-to guide, you need:
+- [An Azure Database for MariaDB server](quickstart-create-mariadb-server-database-using-azure-cli.md)
+- [Azure CLI](/cli/azure/install-azure-cli) command-line utility or use the Azure Cloud Shell in the browser.
+
+## List server configuration parameters for Azure Database for MariaDB server
+To list all modifiable parameters in a server and their values, run the [az mariadb server configuration list](/cli/azure/mariadb/server/configuration#az-mariadb-server-configuration-list) command.
+
+You can list the server configuration parameters for the server **mydemoserver.mariadb.database.azure.com** under resource group **myresourcegroup**.
+```azurecli-interactive
+az mariadb server configuration list --resource-group myresourcegroup --server mydemoserver
+```
+
+For the definition of each of the listed parameters, see the MariaDB reference section on [Server System Variables](https://mariadb.com/kb/en/library/server-system-variables/).
+
+## Show server configuration parameter details
+To show details about a particular configuration parameter for a server, run the [az mariadb server configuration show](/cli/azure/mariadb/server/configuration#az-mariadb-server-configuration-show) command.
+
+This example shows details of the **slow\_query\_log** server configuration parameter for server **mydemoserver.mariadb.database.azure.com** under resource group **myresourcegroup.**
+```azurecli-interactive
+az mariadb server configuration show --name slow_query_log --resource-group myresourcegroup --server mydemoserver
+```
+
+## Modify a server configuration parameter value
+You can also modify the value of a certain server configuration parameter, which updates the underlying configuration value for the MariaDB server engine. To update the configuration, use the [az mariadb server configuration set](/cli/azure/mariadb/server/configuration#az-mariadb-server-configuration-set) command. 
+
+To update the **slow\_query\_log** server configuration parameter of server **mydemoserver.mariadb.database.azure.com** under resource group **myresourcegroup.**
+```azurecli-interactive
+az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver --value ON
+```
+
+If you want to reset the value of a configuration parameter, omit the optional `--value` parameter, and the service applies the default value. For the example above, it would look like:
+```azurecli-interactive
+az mariadb server configuration set --name slow_query_log --resource-group myresourcegroup --server mydemoserver
+```
+
+This code resets the **slow\_query\_log** configuration to the default value **OFF**. 
+
+## Working with the time zone parameter
+
+### Populating the time zone tables
+
+The time zone tables on your server can be populated by calling the `az_load_timezone` stored procedure from a tool like the MariaDB command line or MariaDB Workbench.
+
+> [!NOTE]
+> If you are running the `az_load_timezone` command from MariaDB Workbench, you may need to turn off safe update mode first using `SET SQL_SAFE_UPDATES=0;`.
+
+```sql
+CALL mysql.az_load_timezone();
+```
+
+To view available time zone values, run the following command:
+
+```sql
+SELECT name FROM mysql.time_zone_name;
+```
+
+### Setting the global level time zone
+
+The global level time zone can be set using the [az mariadb server configuration set](/cli/azure/mariadb/server/configuration#az-mariadb-server-configuration-set) command.
+
+The following command updates the **time\_zone** server configuration parameter of server **mydemoserver.mariadb.database.azure.com** under resource group **myresourcegroup** to **US/Pacific**.
+
+```azurecli-interactive
+az mariadb server configuration set --name time_zone --resource-group myresourcegroup --server mydemoserver --value "US/Pacific"
+```
+
+### Setting the session level time zone
+
+The session level time zone can be set by running the `SET time_zone` command from a tool like the MariaDB command line or MariaDB Workbench. The example below sets the time zone to the **US/Pacific** time zone.  
+
+```sql
+SET time_zone = 'US/Pacific';
+```
+
+Refer to the MariaDB documentation for [Date and Time Functions](https://mariadb.com/kb/en/library/date-time-functions/).
+
+## Next steps
+
+- How to configure [server parameters in Azure portal](howto-server-parameters.md)