Grafana와 MS SQL Server 시작하기
Grafana와 MS SQL Server 시작하기 (Get started with Grafana and MS SQL Server)
Microsoft SQL Server는 개발과 프로덕션 환경에서 널리 사용되는 인기 관계형 데이터베이스 관리 시스템이에요. 이 문서는 MS SQL Server 데이터베이스의 메트릭을 표시하기 위해 Grafana에서 일련의 대시보드를 만드는 단계를 안내합니다.
본문
MS SQL Server 다운로드 (Download MS SQL Server)
MS SQL Server는 Windows 또는 Linux 운영체제에, 그리고 Docker 컨테이너에도 설치할 수 있어요. 모든 옵션의 전체 목록은 MS SQL Server downloads page를 참고하세요.
MS SQL Server 설치 (Install MS SQL Server)
Grafana가 실행되는 호스트 또는 원격 서버에 MS SQL Server를 설치할 수 있어요. 다운로드 페이지에서 소프트웨어를 설치하려면 그들의 설정 프롬프트를 따르세요.
Windows 호스트에 있지만 Linux 환경에서 Grafana와 MS SQL 데이터 소스를 사용하고 싶다면, grafana/grafana GitHub 저장소의 리소스를 활용할 수 있는 WSL로 Grafana 개발 환경 설정 블로그 포스트를 참고하세요. 여기에서 MS SQL Server를 포함한 지원 데이터 소스 모음과 테스트 데이터, 미리 구성된 대시보드를 찾을 수 있어요.
MS SQL 데이터 소스 추가 (Add the MS SQL data source)
MSSQL에서는 여러 가지로 인증할 수 있어요.
- 왼쪽 메뉴에서 Connections을 클릭하고
mssql로 필터링해요. - Microsoft SQL Server 옵션을 선택해요.
- 오른쪽 상단의 Create a Microsoft SQL Server data source를 클릭해 구성 페이지를 열어요.
- 원하는 인증 방법을 선택하고 아래에 설명된 대로 올바른 정보를 채워요.
- Save & test를 클릭해요.
일반 구성 (General configuration):
| 이름 | 설명 |
|---|---|
| Name | 데이터 소스 이름. 패널과 쿼리에서 데이터 소스를 참조하는 이름이에요. |
| Host | MS SQL 인스턴스의 IP 주소/호스트네임과 선택적 포트. 포트를 생략하면 기본값 1433이 사용돼요. |
| Database | MS SQL 데이터베이스 이름. |
SQL Server Authentication:
| 이름 | 설명 |
|---|---|
| User | 데이터베이스 사용자의 로그인/사용자 이름. |
| Password | 데이터베이스 사용자의 비밀번호. |
Windows Active Directory (Kerberos):
Windows Active Directory/Kerberos로 인증하는 네 가지 방법이 있어요.
참고: Windows Active Directory (Kerberos) 인증은 현재 Grafana Cloud에서 지원되지 않아요.
| 방법 | 설명 |
|---|---|
| Username + password | 도메인 사용자와 비밀번호 입력 |
| Keytab file | 인증에 사용할 유효한 keytab 파일의 경로 지정 |
| Credential cache | 호스트에서 kinit으로 로그인하고 credential cache 경로를 전달. cache 경로는 해당 호스트에서 klist를 실행해 찾을 수 있어요. |
| Credential cache file | 여러 유효한 구성을 포함할 수 있으며 호스트, 데이터베이스, 사용자를 기준으로 매칭을 수행해요. 아래 표 다음의 예시 JSON을 참고하세요. |
[
{
"user": "[email protected]",
"database": "dbone",
"address": "mysql1.mydomain.com:3306",
"credentialCache": "/tmp/krb5cc_1000"
},
{
"user": "[email protected]",
"database": "dbtwo",
"address": "mysql2.gf.lab",
"credentialCache": "/tmp/krb5cc_1000"
}
]
grafana/grafana 저장소에서 설치한 경우 gdev-mssql 데이터 소스를 사용할 수 있어요. 이 데이터 소스를 추가하면 테스트 데이터베이스에서 생성된 메트릭을 보여 주는 3개 패널이 있는 Datasource tests - MSSQL 대시보드를 사용할 수 있어요. 선택적으로 이 대시보드를 실험하며 다음을 사용자 정의할 수 있어요.
- 다른 패널 만들기
- 패널 제목 변경
- 데이터 폴링 빈도 변경
- 데이터가 표시되는 기간 변경
- 패널 재배치·크기 조정
대시보드 만들기 시작 (Start building dashboards)
이제 미리 패키징된 MS SQL 데이터 소스와 테스트 데이터 사용에 대한 아이디어를 얻었으니, 다음 단계는 개발 또는 샌드박스 영역에 나만의 MS SQL Server 데이터베이스 인스턴스와 데이터를 설정하는 것이에요.
나만의 MS SQL Server 인스턴스에서 데이터를 가져오려면 이 문서의 4단계 지침을 사용해 데이터 소스를 추가해요. Grafana Explore에서 모니터링하려는 메트릭을 실험하며 쿼리를 만들어 보세요.
정리된 쿼리 목록을 만든 뒤에는 SQL Server 데이터베이스의 메트릭을 렌더링하는 대시보드를 만들어요. 트러블슈팅, 사용자 권한, 알려진 이슈, 쿼리 예시는 Grafana에서 Microsoft SQL Server 사용 문서를 참고하세요.