|
| 1 | +--- |
| 2 | +title: 'Error logs - Azure Database for MySQL - Flexible Server' |
| 3 | +description: This article describes the error logs feature for Azure Database for MySQL - Flexible Server. |
| 4 | +ms.service: mysql |
| 5 | +ms.subservice: flexible-server |
| 6 | +ms.topic: conceptual |
| 7 | +author: code-sidd |
| 8 | +ms.author: sisawant |
| 9 | +--- |
| 10 | + |
| 11 | +# Error Logs in Azure Database for MySQL - Flexible Server (Preview) |
| 12 | + |
| 13 | +[!INCLUDE[applies-to-mysql-flexible-server](../includes/applies-to-mysql-flexible-server.md)] |
| 14 | + |
| 15 | +In Azure Database for MySQL - Flexible Server, the error log is available to users to configure and access. Error logs in MySQL gather diagnostic messages during server startup and shutdown, and while the server is running, information that can help proactive troubleshooting. For more information about the MySQL error log, see the [Error log](https://dev.mysql.com/doc/refman/8.0/en/error-log.html) section in the MySQL documentation. |
| 16 | +Under Preview phase, error logs are available under Server logs only, error logs **can't be emitted** to [Azure Diagnostic logs](./../../azure-monitor/essentials/platform-logs-overview.md). |
| 17 | + |
| 18 | +>[!Note] |
| 19 | +>The Error Log feature is accessible for new servers created after *1st December 2023*. For existing servers, this feature will become available following their scheduled maintenance in January 2024. To enable the Error Log feature on existing servers, before January 2024, kindly contact us via [support ticket](./../../azure-portal/supportability/how-to-manage-azure-support-request.md). |
| 20 | +
|
| 21 | +In Azure Database for MySQL - Flexible Server, enabling the error log under [Server logs](./concepts-monitoring#server-logs) in the Azure portal records details in multiple files named using the syntax *mysql-error-<servername>-<timestamp>.log*. In the file name, the timestamp (in GMT/UTC) associated with when the file was generated is appended, identifying the specific time that that log entries were recorded. For more information, see [Server logs retention.](./concepts-monitoring#server-logs) |
| 22 | + |
| 23 | +## Enabling Error logs (Preview) |
| 24 | + |
| 25 | +Users can access and configure the error logs in Azure Database for MySQL – Flexible Server via the Server logs feature, which can be enabled using the [Azure portal](./ how-to-server-logs-portal#enable-server-logs) or [Azure CLI](./how-to-server-logs-cli). |
| 26 | +After the feature is enabled, your MySQL flexible server starts capturing events and writes them to a series of files saved as activity occurs. |
| 27 | + |
| 28 | +To enable Error logs, perform the following steps. |
| 29 | +1. In the Azure portal, navigate to your flexible server, and then, under Monitoring, select Server logs. |
| 30 | +2. Under Server logs, select the Enable check box, which enables the server logs features |
| 31 | +3. Under Select logs to enable, select the Error logs check box. |
| 32 | + |
| 33 | + :::image type="content" source="./media/concepts-error-logs/1-concepts-errorlog.png" alt-text="Portal view showing Error Logs - Enable."::: |
| 34 | + |
| 35 | +4. Select Save to proceed with deployment. |
| 36 | + |
| 37 | + |
| 38 | +You can also enable Error logs on your Azure Database for MySQL flexible server by [enabling the server parameter](./how-to-configure-server-parameters-portal) named *“error_server_log_file”* via the Server parameters pane or via the [Azure CLI](./how-to-configure-server-parameters-cli). |
| 39 | + |
| 40 | +Ensure that the [Server logs feature](./how-to-server-logs-portal#enable-server-logs) is activated by selecting the *Enable* checkbox in the Server logs pane. Alternatively, set the server parameter "log_output" to FILE to enable server logs. Failure to perform either of these actions result in FILE logging not being enabled for your Azure Database for MySQL flexible server. |
| 41 | + |
| 42 | +## Accessing Error logs |
| 43 | +You can download the error logs for further analysis of your Azure Database for MySQL flexible server. To download the logs, in the Azure portal, navigate to the Server logs section, and then select the Error logs tab, as shown. |
| 44 | + - Under **Name**, select the log file you want to download, and then, under **Action**, select **Download**. |
| 45 | + |
| 46 | + :::image type="content" source="./media/concepts-error-logs/2-concepts-errorlog.png" alt-text="Portal view showing Error Logs - Download."::: |
| 47 | + |
| 48 | + - To download multiple log files at one time, under **Name**, select the files you want to download, select **Download**. |
| 49 | + |
| 50 | + :::image type="content" source="./media/concepts-error-logs/3-concepts-errorlog.png" alt-text="Portal view showing Error Logs - Multiple Downloads."::: |
| 51 | + |
| 52 | + |
| 53 | +### Access error logs using Azure CLI |
| 54 | +You can list the server logs from your flexible server by using the following command. |
| 55 | +```azurecli |
| 56 | +az mysql flexible-server server-logs list --resource-group <myresourcegroup> --server-name <server_name> --out table |
| 57 | +``` |
| 58 | + |
| 59 | +To download the mentioned server logs to your current directory, use the following command: |
| 60 | +```azurecli |
| 61 | +az mysql flexible-server server-logs download --resource-group <myresourcegroup> --server-name <server_name> --name <mysql-error-<server_name>-<timestamp>.log> |
| 62 | +``` |
| 63 | + |
| 64 | +For more information, see [how to download the server logs files](./how-to-server-logs-portal#download-server-logs) via the Azure portal or via the [Azure CLI](./how-to-server-logs-cli#downloading-server-logs-using-azure-cli). |
| 65 | + |
| 66 | + |
| 67 | +### Error logs under Server logs retention |
| 68 | +When logging is enabled for an Azure Database for MySQL - Flexible Server, logs are available up to seven days from their creation. If the total size of the available logs exceeds 7 GB, then the oldest files are deleted until space is available. The 7-GB storage limit for server logs is available free of cost and can't be extended. Logs are rotated every 24 hours or 500 MB, whichever comes first. |
| 69 | +Importantly, you can download the logs before rotation, ensuring they have access to valuable server logs at any point within the retention period. |
| 70 | +For more detailed information on log rotation schedules and storage limits for various log types, refer to the [documentation on Server log retention](./concepts-monitoring#server-logs). |
| 71 | + |
| 72 | + |
| 73 | +## Frequently asked questions |
| 74 | + |
| 75 | +*Question*: My error logs contain the note as shown, what does this mean? |
| 76 | + |
| 77 | +`[Note] [Server] Access denied for user ''@'xx.xx.xx.X' (using password: NO).` |
| 78 | + |
| 79 | +*Answer*: This note indicates that an attempt to connect to your MySQL server was unsuccessful due to incorrect or missing authentication details. Specifically, the username provided is empty(''@'xx.xx.xx.X') and no password was entered (using password: NO). This note could indicate an unauthorized attempt to access your database. |
| 80 | +If your server is publicly accessible, it remains exposed to the internet and can be a target for unauthorized access attempts. To enhance the security of your Azure Database for MySQL flexible server, [disable public access](./concepts-networking-private-link#deny-public-access) or [limit access using firewall rules.](./concepts-networking-public#firewall-rules). |
| 81 | + |
| 82 | +## Next steps |
| 83 | +- How to enable server logs feature via Azure portal. [Learn more](./how-to-server-logs-portal.md) |
| 84 | +- How to enable server logs feature via Azure CLI. [Learn more](./how-to-server-logs-cli.md) |
0 commit comments