mirror of https://github.com/grafana/grafana.git
59 lines
4.2 KiB
Markdown
59 lines
4.2 KiB
Markdown
---
|
|
aliases:
|
|
- ../guides/getting_started/
|
|
- ../guides/gettingstarted/
|
|
- getting-started-sql/
|
|
description: Learn how to build your first MS SQL Server dashboard in Grafana.
|
|
title: Get started with Grafana and MS SQL Server
|
|
weight: 500
|
|
---
|
|
|
|
# Get started with Grafana and MS SQL Server
|
|
|
|
Microsoft SQL Server is a popular relational database management system that is widely used in development and production environments. This topic walks you through the steps to create a series of dashboards in Grafana to display metrics from a MS SQL Server database.
|
|
|
|
#### Download MS SQL Server
|
|
|
|
MS SQL Server can be installed on Windows or Linux operating systems and also on Docker containers. Refer to the [MS SQL Server downloads page](https://www.microsoft.com/en-us/sql-server/sql-server-downloads), for a complete list of all available options.
|
|
|
|
#### Install MS SQL Server
|
|
|
|
You can install MS SQL Server on the host running Grafana or on a remote server. To install the software from the [downloads page](https://www.microsoft.com/en-us/sql-server/sql-server-downloads), follow their setup prompts.
|
|
|
|
If you are on a Windows host but want to use Grafana and MS SQL data source on a Linux environment, refer to the [WSL to set up your Grafana development environment](https://grafana.com/blog/2021/03/03/.how-to-set-up-a-grafana-development-environment-on-a-windows-pc-using-wsl). This will allow you to leverage the resources available in [grafana/grafana](https://github.com/grafana/grafana) GitHub repository. Here you will find a collection of supported data sources, including MS SQL Server, along with test data and pre-configured dashboards for use.
|
|
|
|
#### Add the MS SQL data source
|
|
|
|
1. Click **Connections** in the left-side menu and filter by `mssql`.
|
|
1. Select the **Microsoft SQL Server** option.
|
|
1. Click **Create a Microsoft SQL Server data source** in the top right corner to open the configuration page.
|
|
1. Enter the information specified in the table below, then click **Save & test**.
|
|
|
|
| Name | Description |
|
|
| ---------- | --------------------------------------------------------------------------------------------------------------------- |
|
|
| `Name` | The data source name. This is how you refer to the data source in panels and queries. |
|
|
| `Host` | The IP address/hostname and optional port of your MS SQL instance. If port is omitted, the default 1433 will be used. |
|
|
| `Database` | Name of your MS SQL database. |
|
|
| `User` | Database user's login/username. |
|
|
| `Password` | Database user's password. |
|
|
|
|
For installations from the [grafana/grafana](https://github.com/grafana/grafana/tree/main) repository, `gdev-mssql` data source is available. Once you add this data source, you can use the `Datasource tests - MSSQL` dashboard with three panels showing metrics generated from a test database.
|
|
|
|
|
|
|
|
Optionally, play around this dashboard and customize it to:
|
|
|
|
- Create different panels.
|
|
- Change titles for panels.
|
|
- Change frequency of data polling.
|
|
- Change the period for which the data is displayed.
|
|
- Rearrange and resize panels.
|
|
|
|
#### Start building dashboards
|
|
|
|
Now that you have gained some idea of using the pre-packaged MS SQL data source and some test data, the next step is to setup your own instance of MS SQL Server database and data your development or sandbox area.
|
|
|
|
To fetch data from your own instance of MS SQL Server, add the data source using instructions in Step 4 of this topic. In Grafana [Explore]({{< relref "../explore/" >}}) build queries to experiment with the metrics you want to monitor.
|
|
|
|
Once you have a curated list of queries, create [dashboards]({{< relref "../dashboards/" >}}) to render metrics from the SQL Server database. For troubleshooting, user permissions, known issues, and query examples, refer to [Using Microsoft SQL Server in Grafana]({{< relref "../datasources/mssql/" >}}).
|