Monitor SQL Data Sync with Azure Monitor logs
To check the SQL Data Sync activity log and detect errors and warnings, you previously had to check SQL Data Sync manually in the Azure portal, or use PowerShell or the REST API. Follow the steps in this article to configure a custom solution that improves the Data Sync monitoring experience. You can customize this solution to fit your scenario.
This article was recently updated to use the term Azure Monitor logs instead of Log Analytics. Log data is still stored in a Log Analytics workspace and is still collected and analyzed by the same Log Analytics service. We are updating the terminology to better reflect the role of logs in Azure Monitor. See Azure Monitor terminology changes for details.
For an overview of SQL Data Sync, see Sync data across multiple cloud and on-premises databases with SQL Data Sync in Azure.
SQL Data Sync does not support Azure SQL Managed Instance at this time.
Monitoring Dashboard for all your sync groups
You no longer need to look through the logs of each sync group individually to look for issues. You can monitor all your sync groups from any of your subscriptions in one place by using a custom Azure Monitor view. This view surfaces the information that matters to SQL Data Sync customers.
Automated Email notifications
You no longer need to check the log manually in the Azure portal or through PowerShell or the REST API. With Azure Monitor logs, you can create alerts that go directly to the email addresses of the people that need to see them when an error occurs.
How do you set up these monitoring features?
Implement a custom Azure Monitor logs monitoring solution for SQL Data Sync in less than an hour by doing the following things:
You need to configure three components:
A PowerShell runbook to feed SQL Data Sync log data to Azure Monitor logs.
An Azure Monitor alert for email notifications.
An Azure Monitor View for monitoring.
Samples to download
Download the following two samples:
Make sure you have set up the following things:
An Azure Automation account
Log Analytics workspace
PowerShell Runbook to get SQL Data Sync Log
Use a PowerShell runbook hosted in Azure Automation to pull the SQL Data Sync log data and send it to Azure Monitor logs. A sample script is included. As a prerequisite, you need to have an Azure Automation account. Then you need to create a runbook and schedule it to run.
Create a runbook
For more info about creating a runbook, see My first PowerShell runbook.
Under your Azure Automation account, select the Runbooks tab under Process Automation.
Select Add a Runbook at the top-left corner of the Runbooks page.
Select Import an existing Runbook.
Under Runbook file, use the given
DataSyncLogPowerShellRunbookfile. Set the Runbook type as
PowerShell. Give the runbook a name.
Select Create. You now have a runbook.
Under your Azure Automation Account, select the Variables tab under Shared Resources.
Select Add a variable on the Variables page. Create a variable to store the last execution time for the runbook. If you have multiple runbooks, you need one variable for each runbook.
Set the variable name as
DataSyncLogLastUpdatedTimeand set its Type as DateTime.
Select the runbook and click the edit button at the top of the page.
Make the changes required for your account and your SQL Data Sync configuration. (For more detailed information, see the sample script.)
sync group information.
Azure Monitor logs information. Find this information in Azure portal | Settings | Connected Sources. For more information about sending data to Azure Monitor logs, see Send data to Azure Monitor logs with the HTTP Data Collector API (preview).
Run the runbook in the Test pane. Check to make sure it was successful.
If you have errors, make sure you have the latest PowerShell module installed. You can install the latest PowerShell module in the Modules Gallery in your Automation Account.
Schedule the runbook
To schedule the runbook:
Under the runbook, select the Schedules tab under Resources.
Select Add a Schedule on the Schedules page.
Select Link a Schedule to your runbook.
Select Create a new schedule.
Set Recurrence to Recurring and set the interval you want. Use the same interval here, in the script, and in Azure Monitor logs.
Check the automation
To monitor whether your automation is running as expected, under Overview for your automation account, find the Job Statistics view under Monitoring. Pin this view to your dashboard for easy viewing. Successful runs of the runbook show as "Completed" and Failed runs show as "Failed."
Create an Azure Monitor Reader Alert for Email Notifications
To create an alert that uses Azure Monitor logs, do the following things. As a prerequisite, you need to have Azure Monitor logs linked with a Log Analytics workspace.
In the Azure portal, select Log Search.
Create a query to select the errors and warnings by sync group within the interval you selected. For example:
DataSyncLog_CL | where LogLevel_s != "Success" | summarize AggregatedValue = count() by bin(TimeGenerated,60m),SyncGroupName_s
After running the query, select the bell that says Alert.
Under Generate alert based on, select Metric Measurement.
Set the Aggregate Value to Greater than.
After Greater than, enter the threshold to elapse before you receive notifications. Transient errors are expected in Data Sync. To reduce noise, set the threshold to 5.
Under Actions, set Email notification to "Yes." Enter the desired email recipients.
Click Save. The specified recipients now receive email notifications when errors occur.
Create an Azure Monitor View for Monitoring
This step creates an Azure Monitor view to visually monitor all the specified sync groups. The view includes several components:
An overview tile, which shows how many errors, successes, and warnings all the sync groups have.
A tile for all sync groups, which shows the count of errors and warnings per sync group. Groups with no issues don't appear on this tile.
A tile for each sync group, which shows the number of errors, successes, and warnings, and the recent error messages.
To configure the Azure Monitor view, do the following things:
On the Log Analytics workspace home page, select the plus on the left to open the view designer.
Select Import on the top bar of the view designer. Then select the "DataSyncLogOMSView" sample file.
The sample view is for managing two sync groups. Edit this view to fit your scenario. Click edit and make the following changes:
Create new "Donut & List" objects from the Gallery as needed.
In each tile, update the queries with your information.
On each tile, change the TimeStamp_t interval as desired.
On the tiles for each sync group, update the sync group names.
On each tile, update the title as needed.
Click Save and the view is ready.
Cost of this solution
In most cases, this solution is free.
Azure Automation: There may be a cost incurred with the Azure Automation account, depending on your usage. The first 500 minutes of job run time per month are free. In most cases, this solution is expected to use less than 500 minutes per month. To avoid charges, schedule the runbook to run at an interval of two hours or more. For more info, see Automation pricing.
Azure Monitor logs: There may be a cost associated with Azure Monitor logs depending on your usage. The free tier includes 500 MB of ingested data per day. In most cases, this solution is expected to ingest less than 500 MB per day. To decrease the usage, use the failure-only filtering included in the runbook. If you're using more than 500 MB per day, upgrade to the paid tier to avoid the risk of analytics stopping when the limitation is reached. For more info, see Azure Monitor logs pricing.
Download the code samples described in this article from the following locations:
For more info about SQL Data Sync, see:
- Overview - Sync data across multiple cloud and on-premises databases with SQL Data Sync in Azure
- Set up Data Sync
- Data Sync Agent - Data Sync Agent for SQL Data Sync in Azure
- Best practices - Best practices for SQL Data Sync in Azure
- Troubleshoot - Troubleshoot issues with SQL Data Sync in Azure
- Update the sync schema
- With Transact-SQL - Automate the replication of schema changes in SQL Data Sync in Azure
- With PowerShell - Use PowerShell to update the sync schema in an existing sync group
For more info about SQL Database, see: