Files
grafana/docs/sources/datasources/mssql/_index.md
T
Larissa Wandzura 880bc23c85 Docs: Added a troubleshooting guide for MSSQL, plus some updates (#116088)
* added troubleshooting guide

* cleaned up the intro doc

* cleaned up the before you begin section in the configure doc

* changed a note to a tip

* changed to troubleshooting for cohesion

* final edits

* minor clean up item

* added note about Kerberos not being supported in Cloud

* punctuation fixes
2026-01-12 14:57:45 +00:00

7.5 KiB

aliases, description, keywords, labels, menuTitle, title, weight, refs
aliases description keywords labels menuTitle title weight refs
../data-sources/mssql/
../features/datasources/mssql/
Guide for using Microsoft SQL Server in Grafana
grafana
MSSQL
Microsoft
SQL
guide
Azure SQL Database
products
cloud
enterprise
oss
Microsoft SQL Server Microsoft SQL Server data source 900
data-source-management add-template-variables-interval-ms build-dashboards add-template-variables-interval explore provisioning-data-sources transformations alerting visualizations variables annotate-visualizations set-up-grafana-monitoring configure-mssql-data-source mssql-query-editor mssql-template-variables query-caching mssql-troubleshoot postgres mysql
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/add-template-variables/#__interval_ms
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/add-template-variables/#__interval_ms
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/add-template-variables/#__interval
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/add-template-variables/#__interval
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/explore/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/explore/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/provisioning/#data-sources
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/provisioning/#data-sources
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/query-transform-data/transform-data/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/query-transform-data/transform-data/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/alerting/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/alerting-and-irm/alerting/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/panels-visualizations/visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/panels-visualizations/visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/variables/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/variables/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana-cloud/ /docs/grafana-cloud/visualizations/dashboards/build-dashboards/annotate-visualizations/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/set-up-grafana-monitoring/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/setup-grafana/set-up-grafana-monitoring/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/configure
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/configure
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/query-editor/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/query-editor/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/template-variables/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/template-variables/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/#query-and-resource-caching
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/administration/data-source-management/#query-and-resource-caching
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/troubleshooting/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/mssql/troubleshooting/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/postgres/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/postgres/
pattern destination
/docs/grafana/ /docs/grafana/<GRAFANA_VERSION>/datasources/mysql/
pattern destination
/docs/grafana-cloud/ /docs/grafana/<GRAFANA_VERSION>/datasources/mysql/

Microsoft SQL Server (MSSQL) data source

Grafana ships with built-in support for Microsoft SQL Server (MSSQL). You can query and visualize data from any Microsoft SQL Server 2005 or newer, including Microsoft Azure SQL Database.

Use this data source to create dashboards, explore SQL data, and monitor MSSQL-based workloads in real time.

The following documentation helps you get started working with the Microsoft SQL Server (MSSQL) data source:

Supported versions

This data source supports the following Microsoft SQL Server versions:

  • Microsoft SQL Server 2005 and newer
  • Microsoft Azure SQL Database
  • Azure SQL Managed Instance

Grafana recommends using the latest available service pack for your SQL Server version for optimal compatibility.

Key capabilities

The Microsoft SQL Server data source supports:

  • Time series queries: Visualize metrics over time using the built-in time grouping macros.
  • Table queries: Display query results in table format for any valid SQL query.
  • Template variables: Create dynamic dashboards with variable-driven queries.
  • Annotations: Overlay events from SQL Server on your dashboard graphs.
  • Alerting: Create alerts based on SQL Server query results.
  • Stored procedures: Execute stored procedures and visualize results.
  • Macros: Simplify queries with built-in macros for time filtering and grouping.

Additional resources

After configuring the Microsoft SQL Server data source, you can:

  • PostgreSQL - For PostgreSQL databases.
  • MySQL - For MySQL and MariaDB databases.