Atatus monitors Azure SQL Managed Instance by capturing query metrics, execution plans, and database events. This guide provides the steps needed to enable monitoring and configure your environment for complete observability of your managed SQL Server instances on Azure.

1. Grant the Agent Access

Create a read-only login to connect to your server and grant the required Azure SQL Roles:

For SQL Server versions 2014+

2. Configure the Atatus Agent

Step 1: Configure the SQL Server Integration

Edit the /etc/atatus-infra-agent/conf.d/sqlserver.d/sqlserver.yml configuration file in your Atatus Agent installation directory:

Step 2: Restart the Atatus Infra Agent


Enable Schema Collection for SQL Server 2017+ (Optional)

Atatus Agent can collect schema information from SQL Server 2017 and above.

Requirements

  • Agent v3.4.0 or higher
  • collect_database_info: true
  • collect_settings: true
  • Use auto_discovery: true to auto-detect all databases

Configuration Examples

  • Collect schemas from all logical databases

Collect Metrics Using Custom Queries (Optional)

You can collect custom metrics from SQL Server using the custom_queries option in your configuration.

Configuration Example