Microsoft SQL Server

Microsoft SQL Server 통합은 SQL Server 인스턴스에서 트랜잭션, 연결, 기타 측정항목을 수집합니다.

SQL Server에 대한 자세한 내용은 SQL Server 문서를 참조하세요.

시작하기 전에

운영 에이전트 버전 2.15.0은 workload.googleapis.com/ 프리픽스를 사용하여 새로운 SQL Server 측정항목 집합을 지원합니다. 구성 예시에 설명된 대로 이러한 측정항목을 수집하도록 에이전트를 구성해야 합니다.

운영 에이전트는 항상 제한된 SQL Server 측정항목을 지원합니다. 이러한 측정항목은 agent.googleapis.com/mssql/ 프리픽스를 사용합니다. Windows VM에서 이러한 측정항목을 수집하는 데 추가 구성은 필요하지 않습니다.

이 문서에서는 agent가 프리픽스로 추가된 측정항목을 v1 측정항목이라고 부르고 workload가 프리픽스로 추가된 측정항목을 v2 측정항목이라고 부릅니다.

v1 측정항목에는 트랜잭션 요율 및 연결 수 정보가 포함됩니다.
v2 측정항목에는 인스턴스 수준의 배치, 잠금, 페이지, 사용자 연결 수 정보와 데이터베이스 수준의 트랜잭션 및 트랜잭션 로그 정보가 포함됩니다.

이러한 측정항목 표는 모니터링 대상을 참조하세요.

운영 에이전트 버전 2.15.0부터 v1 측정항목, v2 측정항목 또는 둘 다 수집하도록 에이전트를 구성할 수 있습니다.

참고: v1 측정항목을 기반으로 하는 알림 또는 기타 구성이 있는 경우 v2 측정항목으로 전환하면 구성도 마이그레이션해야 합니다. v1 측정항목 수집을 중지하면 해당 측정항목의 알림 및 기타 모니터링도 중단됩니다. 다음 표에서는 v1 측정항목과 v2 측정항목의 매핑을 보여줍니다.

v1 측정항목(`agent.googleapis.com/mssql/`)	v2 측정항목(`workload.googleapis.com/`)
`connections_user`	`sqlserver.user.connection.count`
`transaction_rate`	`sqlserver.transaction.rate`
`write_transaction_rate`	`sqlserver.transaction.write.rate`

기본 요건

SQL Server 원격 분석을 수집하려면 운영 에이전트를 설치해야 합니다.

측정항목 v1의 경우 버전 1.0.0 이상을 설치합니다.
측정항목 v2의 경우 버전 2.15.0 이상을 설치합니다.

이 통합은 SQL Server 버전 11.x, 12.x, 13.x, 14.x, 15.x를 지원합니다.

SQL Server용 운영 에이전트 구성

Microsoft Windows VM에서 운영 에이전트를 사용하면 에이전트가 SQL Server v1 측정항목을 자동으로 수집합니다. 추가 구성은 필요하지 않습니다.

운영 에이전트 구성 가이드에 따라 SQL Server 인스턴스에서 원격 분석을 수집하는 데 필요한 요소를 추가하고 에이전트를 다시 시작합니다.

새 SQL Server 인스턴스를 설정한 후 측정항목 탐색기에 측정항목이 즉시 표시되지 않을 수 있습니다. 운영 에이전트는 보고할 데이터베이스 활동이 있는 경우에만 SQL Server 측정항목 수집을 시작합니다.

구성 예시

다음 명령어는 SQL Server용 원격 분석을 수집하고 처리하는 구성을 만들고 운영 에이전트를 다시 시작합니다.

$ErrorActionPreference = 'Stop'

# This config gets merged with the built-in Ops Agent config, which already
# includes the v1 receiver in the default pipeline.
# Because the v2 receiver here uses a unique ID, it does not overwrite
# the default receiver and so both receivers will be active simultaneously
# during the test.

# Create a back up of the existing file so existing configurations are not lost.
Copy-Item -Path 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' -Destination 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml.bak'

# Configure the Ops Agent.
Add-Content 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml' "
metrics:
  receivers:
    mssql_v2:
      type: mssql
      receiver_version: 2
  service:
    pipelines:
      mssql_v2:
        receivers:
        - mssql_v2
"

# Stop-Service may fail if the service isn't in a Running state yet.
(Get-Service google-cloud-ops-agent*).WaitForStatus('Running', '00:03:00')
Stop-Service google-cloud-ops-agent -Force
Start-Service google-cloud-ops-agent*

v1 측정항목 수집 구성

Microsoft Windows VM의 운영 에이전트는 SQL Server v1 측정항목을 자동으로 수집합니다. 추가 구성은 필요하지 않습니다. v2 측정항목만 수집하는 방법에 대한 자세한 내용은 v2 측정항목 수집 구성을 참조하세요.

새 SQL Server 인스턴스를 설정하면 SQL Server가 즉시 측정항목을 보고하지 않을 수 있습니다. 운영 에이전트는 보고할 데이터베이스 활동이 있으면 SQL Server 측정항목 수집을 시작합니다.

v2 측정항목 수집 구성

SQL Server에서 v2 측정항목을 수집하려면 SQL Server에서 생성하는 측정항목의 수신자를 만든 후 새 수신자의 파이프라인을 만들어야 합니다.

이 수신자는 구성에서 여러 인스턴스 모니터링과 같은 여러 인스턴스의 사용을 지원하지 않습니다. 이러한 모든 인스턴스는 동일한 시계열에 기록되며, Cloud Monitoring은 이를 구분할 수 있는 방법이 없습니다. 운영 에이전트는 SQL Server 이름 지정 인스턴스를 지원하지 않습니다.

mssql 측정항목의 수신자를 구성하려면 다음 필드를 지정합니다.

필드	기본값	설명
`collection_interval`	`60s`	time.Duration 값(예: `30s` 또는 `5m`)입니다.
`receiver_version`		수집된 측정항목의 버전입니다. `2`를 사용하여 v2 측정항목을 수집합니다.
`type`		값은 `mssql`여야 합니다.

기본적으로 v1 측정항목은 자동으로 수집됩니다. v2 측정항목을 추가로 수집하여 v1 측정항목을 보강하거나 v2 측정항목만 수집하도록 v1 측정항목을 재정의할 수 있습니다.

v2 측정항목만 수집하려면 다음 안내를 따르세요.
- 수신자 mssql 이름을 지정합니다.
- type 필드를 mssql로 설정합니다.
- receiver_version 필드를 2로 설정합니다.
- default_pipeline 파이프라인에서 이 수신자를 사용합니다. 이 구성은 mssql 수신자의 기본 제공 구성을 재정의합니다.
v1 및 v2 측정항목을 모두 수집하려면 다음 안내를 따르세요.
- 수신자에 mssql가 아닌 이름(예: mssql_v2)을 지정합니다.
- type 필드를 mssql로 설정합니다.
- receiver_version를 2로 설정합니다.
- 새 파이프라인에서 이 수신자를 사용합니다. 이 구성은 기본 제공 수신자를 재정의하는 대신 v2 수신자를 추가합니다. 구성 예시의 스크립트에서 이 방법이 사용됩니다.

모니터링 대상

버전 2.15.0부터 운영 에이전트는 2개의 서로 다른 측정항목 집합을 수집할 수 있습니다.

v1 측정항목: agent.googleapis.com/mssql/.
v2 측정항목: workload.googleapis.com/.

V1 측정항목

다음 표에는 운영 에이전트가 SQL Server 인스턴스에서 수집하는 v1 측정항목 목록이 나와 있습니다.

이 표의 '측정항목 유형' 문자열 앞에 agent.googleapis.com/mssql/가 포함된 프리픽스를 붙여야 합니다. 표의 항목에서는 이 프리픽스가 생략되었습니다. 라벨을 쿼리할 때 metric.labels. 프리픽스를 사용합니다(예: metric.labels.LABEL="VALUE").

측정항목 유형 ^{시작 단계} 표시 이름
종류, 유형, 단위 모니터링 리소스	설명 라벨
`connections/user` ^GA SQL 서버 열린 연결
`GAUGE`, `DOUBLE`, `1` aws_ec2_instance gce_instance	SQL 서버에 대해 현재 열린 연결입니다. 60초마다 샘플링됩니다.
`transaction_rate` ^GA SQL 서버 트랜잭션 속도
`GAUGE`, `DOUBLE`, `1/s` aws_ec2_instance gce_instance	SQL 서버의 초당 트랜잭션 수입니다. 60초마다 샘플링됩니다.
`write_transaction_rate` ^GA SQL 서버 쓰기 트랜잭션 속도
`GAUGE`, `DOUBLE`, `1/s` aws_ec2_instance gce_instance	SQL 서버의 초당 쓰기 트랜잭션 수입니다. 60초마다 샘플링됩니다.

2024년 6월 27일 18:22:22(UTC)에 생성된 표입니다.

V2 측정항목

다음 표에는 운영 에이전트가 SQL Server 인스턴스에서 수집하는 v2 측정항목 목록이 나와 있습니다.

측정항목 유형
종류, 유형 모니터링 리소스	라벨
`workload.googleapis.com/sqlserver.batch.request.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.batch.sql_compilation.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.batch.sql_recompilation.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.lock.wait.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.lock.wait_time.avg`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.page.buffer_cache.hit_ratio`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.page.checkpoint.flush.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.page.lazy_write.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.page.life_expectancy`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/sqlserver.page.operation.rate`
`GAUGE`, `DOUBLE` gce_instance	`type`
`workload.googleapis.com/sqlserver.page.split.rate`
`GAUGE`, `DOUBLE` gce_instance
`workload.googleapis.com/sqlserver.transaction.rate`
`GAUGE`, `DOUBLE` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction.write.rate`
`GAUGE`, `DOUBLE` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.flush.data.rate`
`GAUGE`, `DOUBLE` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.flush.rate`
`GAUGE`, `DOUBLE` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.flush.wait.rate`
`GAUGE`, `DOUBLE` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.growth.count`
`CUMULATIVE`, `INT64` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.percent_used`
`GAUGE`, `INT64` gce_instance	`database`
`workload.googleapis.com/sqlserver.transaction_log.shrink.count`
`CUMULATIVE`, `INT64` gce_instance	`database`
`workload.googleapis.com/sqlserver.user.connection.count`
`GAUGE`, `INT64` gce_instance

구성 확인

이 섹션에서는 SQL Server 수신자를 올바르게 구성했는지 확인하는 방법에 대해 설명합니다. 운영 에이전트에서 원격 분석 수집을 시작하려면 1~2분 정도 걸릴 수 있습니다.

SQL Server 측정항목이 Cloud Monitoring으로 전송되고 있는지 확인하려면 다음을 수행합니다.

Google Cloud 콘솔에서 측정항목 탐색기 페이지로 이동합니다.
측정항목 탐색기로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
쿼리 빌더 창의 툴바에서 이름이 MQL 또는 PromQL인 버튼을 선택합니다.
언어 전환 버튼에 MQL이 선택되어 있는지 확인합니다. 언어 전환 버튼은 쿼리 형식을 지정할 수 있는 동일한 툴바에 있습니다.

v1 측정항목의 경우 편집기에 다음 쿼리를 입력한 후 쿼리 실행을 클릭합니다.
```
fetch gce_instance
| metric 'agent.googleapis.com/mssql/connections/user'
| every 1m
```

v2 측정항목의 경우 편집기에 다음 쿼리를 입력한 후 실행을 클릭합니다.

fetch gce_instance
| metric 'workload.googleapis.com/sqlserver.user.connection.count'
| every 1m

대시보드 보기

SQL Server 측정항목을 보려면 차트 또는 대시보드가 구성되어 있어야 합니다. SQL Server 통합에는 대시보드가 하나 이상 포함됩니다. 통합을 구성하고 운영 에이전트가 측정항목 데이터 수집을 시작한 후 모든 대시보드가 자동으로 설치됩니다.

통합을 설치하지 않고도 대시보드의 정적 미리보기를 볼 수 있습니다.

설치된 대시보드를 보려면 다음을 수행합니다.

Google Cloud 콘솔에서 대시보드 페이지로 이동합니다.
대시보드로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
대시보드 목록 탭을 선택한 후 통합 카테고리를 선택합니다.
확인할 대시보드의 이름을 클릭합니다.

통합을 구성했지만 대시보드가 설치되지 않은 경우 운영 에이전트가 실행 중인지 확인합니다. 대시보드에 차트의 측정항목 데이터가 없으면 대시보드 설치가 실패합니다. 운영 에이전트가 측정항목 수집을 시작하면 대시보드가 자동으로 설치됩니다.

대시보드의 정적 미리보기를 보려면 다음을 수행합니다.

Google Cloud 콘솔에서 통합 페이지로 이동합니다.
통합으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
Compute Engine 배포 플랫폼 필터를 클릭합니다.
SQL Server 항목을 찾고 세부정보 보기를 클릭합니다.
정적 미리보기를 보려면 대시보드 탭을 선택합니다. 대시보드가 설치되어 있으면 대시보드 보기를 클릭하여 대시보드로 이동할 수 있습니다.

Cloud Monitoring의 대시보드에 대한 자세한 내용은 대시보드 및 차트를 참조하세요.

통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.

알림 정책 설치

알림 정책은 지정된 조건이 발생할 때 Cloud Monitoring에서 알림을 받도록 지시합니다. SQL Server 통합에는 사용할 알림 정책이 하나 이상 포함됩니다. Monitoring의 통합 페이지에서 이러한 알림 정책을 보고 설치할 수 있습니다.

사용 가능한 알림 정책에 대한 설명을 보고 설치하려면 다음을 수행합니다.

Google Cloud 콘솔에서 통합 페이지로 이동합니다.
통합으로 이동

검색창을 사용하여 이 페이지를 찾은 경우 부제목이 Monitoring인 결과를 선택합니다.
SQL Server 항목을 찾고 세부정보 보기를 클릭합니다.
알림 탭을 선택합니다. 이 탭에는 사용 가능한 알림 정책에 대한 설명과 이를 설치하기 위한 인터페이스가 제공됩니다.
알림 정책을 설치합니다. 알림 정책은 경고가 트리거되었다는 알림을 전송할 위치를 알아야 하므로, 설치 시 사용자에게 해당 정보를 요청합니다. 알림 정책을 설치하려면 다음을 수행합니다.
1. 사용 가능한 알림 정책 목록에서 설치할 정책을 선택합니다.
2. 알림 구성 섹션에서 알림 채널을 하나 이상 선택합니다. 알림 채널 사용을 중지할 수 있지만 사용 중지하면 알림 정책이 자동으로 실행됩니다. Monitoring에서 상태를 확인할 수 있지만 알림이 수신되지 않습니다.
  
  알림 채널에 대한 자세한 내용은 알림 채널 관리를 참조하세요.
3. 정책 만들기를 클릭합니다.

Cloud Monitoring의 알림 정책에 대한 자세한 내용은 알림 소개를 참조하세요.

통합 페이지 사용에 대한 자세한 내용은 통합 관리를 참조하세요.

다음 단계

Ansible을 사용하여 운영 에이전트를 설치하고, 서드파티 애플리케이션을 구성하고, 샘플 대시보드를 설치하는 방법은 운영 에이전트를 설치하여 서드파티 애플리케이션 문제 해결 동영상을 참조하세요.