Microsoft SQL Server

Integrasi Microsoft SQL Server mengumpulkan transaksi, koneksi, dan metrik lainnya dari instance SQL Server Anda.

Untuk informasi selengkapnya tentang SQL Server, lihat Server SQL dokumentasi layanan.

Sebelum memulai

Agen Operasional versi 2.15.0 memperkenalkan dukungan untuk serangkaian Metrik SQL Server menggunakan awalan workload.googleapis.com/. Anda harus mengonfigurasi agen untuk mengumpulkan metrik ini, seperti dijelaskan dalam Contoh konfigurasi.

Agen Operasional selalu mendukung serangkaian metrik SQL Servier yang terbatas; metrik ini menggunakan awalan agent.googleapis.com/mssql/. Tidak ada tambahan konfigurasi diperlukan untuk mengumpulkan metrik ini di VM Windows.

Dokumen ini mengacu pada metrik berawalan agent sebagai metrik v1 dan metrik awalan workload sebagai metrik v2.

  • Metrik v1 mencakup informasi rasio transaksi dan jumlah koneksi.
  • Metrik v2 mencakup informasi jumlah koneksi batch, kunci, halaman, dan pengguna di tingkat instance, serta informasi transaksi dan log transaksi di tingkat database.

Untuk tabel metrik ini, lihat Apa yang dipantau.

Dimulai dengan Agen Operasional versi 2.15.0, Anda dapat mengonfigurasi agen untuk mengumpulkan metrik v1, metrik v2, atau keduanya.

Prasyarat

Untuk mengumpulkan telemetri SQL Server, Anda harus instal Agen Operasional:

  • Untuk metrik v1, instal versi 1.0.0 atau yang lebih tinggi.
  • Untuk metrik v2, instal versi 2.15.0 atau yang lebih baru.

Integrasi ini mendukung SQL Server versi 11.x, 12.x, 13.x, 14.x, dan 15.x.

Mengonfigurasi Agen Operasional untuk SQL Server

Saat menggunakan Agen Operasional pada VM Microsoft Windows, agen secara otomatis mengumpulkan metrik SQL Server v1. Tidak diperlukan konfigurasi tambahan.

Mengikuti panduan untuk mengonfigurasi Operasi Agen, tambahkan elemen yang diperlukan untuk mengumpulkan telemetri dari instance SQL Server, dan memulai ulang agen.

Setelah menyiapkan instance SQL Server baru, Anda mungkin tidak segera melihat metrik tersebut ditampilkan di Metrics Explorer. Agen Operasional mulai mengumpulkan SQL Metrik server hanya setelah ada aktivitas database yang akan dilaporkan.

Contoh konfigurasi

Perintah berikut membuat konfigurasi untuk mengumpulkan dan menyerap telemetry untuk SQL Server dan memulai ulang Ops Agent.

$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*

Mengonfigurasi pengumpulan metrik v1

Agen Operasional pada VM Microsoft Windows secara otomatis mengumpulkan Metrik SQL Server v1. Tidak diperlukan konfigurasi tambahan. Untuk informasi tentang cara mengumpulkan metrik v2 saja, lihat Mengonfigurasi pengumpulan metrik v2.

Setelah Anda menyiapkan instance SQL Server baru, SQL Server mungkin tidak langsung melaporkan metrik apa pun. Agen Operasional mulai mengumpulkan SQL Metrik server setelah ada aktivitas database yang akan dilaporkan.

Mengonfigurasi pengumpulan metrik v2

Untuk menyerap metrik v2 dari SQL Server, Anda harus membuat penerima untuk metrik yang dihasilkan SQL Server, lalu membuat pipeline untuk penerima baru.

Penerima ini tidak mendukung penggunaan beberapa instance dalam konfigurasi, misalnya, memantau beberapa endpoint. Semua instance tersebut ditulis ke deret waktu yang sama, dan Cloud Monitoring tidak dapat membedakan keduanya. Agen Operasional tidak mendukung instance bernama SQL Server.

Untuk mengonfigurasi penerima metrik mssql, tentukan kolom berikut:

Kolom Default Deskripsi
collection_interval 60s Nilai time.Duration, seperti 30s atau 5m.
receiver_version Versi metrik yang dikumpulkan; menggunakan 2 untuk mengumpulkan metrik v2.
type Nilai ini harus mssql.

Secara default, metrik v1 dikumpulkan secara otomatis. Anda dapat meningkatkan metrik v1 dengan mengumpulkan metrik v2 secara tambahan, atau Anda dapat mengganti metrik v1 untuk hanya mengumpulkan metrik v2.

  • Untuk mengumpulkan metrik v2 saja, lakukan hal berikut:

    • Beri nama penerima Anda mssql.
    • Tetapkan kolom type ke mssql.
    • Tetapkan kolom receiver_version ke 2.
    • Gunakan penerima ini di pipeline default_pipeline Anda. Konfigurasi ini menggantikan konfigurasi bawaan penerima mssql.
  • Untuk mengumpulkan metrik v1 dan v2, lakukan tindakan berikut:

    • Beri nama penerima Anda dengan nama selain mssql, seperti mssql_v2.
    • Tetapkan kolom type ke mssql.
    • Setel receiver_version ke 2.
    • Gunakan penerima ini di pipeline baru Anda. Konfigurasi ini menambahkan penerima v2, bukan mengganti penerima penerima. Skrip di Example configuration menggunakan pendekatan.

Hal yang dipantau

Dimulai dengan versi 2.15.0, Agen Operasional dapat mengumpulkan dua sekumpulan metrik:

  • Metrik v1: agent.googleapis.com/mssql/.
  • Metrik v2: workload.googleapis.com/.
Metrik V1

Tabel berikut memberikan daftar metrik v1 yang dikumpulkan Ops Agent dari instance SQL Server.

String "jenis metrik" dalam tabel ini harus diawali dengan agent.googleapis.com/mssql/. Awalan tersebut telah dihilangkan dari entri dalam tabel. Saat membuat kueri label, gunakan awalan metric.labels.; untuk contoh, metric.labels.LABEL="VALUE".

Jenis metrik Tahap peluncuran
Nama tampilan
Jenis, Tipe, Unit
Resource yang dimonitor
Deskripsi
Label
connections/user GA
Koneksi terbuka SQL Server
GAUGEDOUBLE1
aws_ec2_instance
gce_instance
Koneksi yang saat ini terbuka ke server SQL. Sampel diambil setiap 60 detik.
transaction_rate GA
Rasio transaksi SQL Server
GAUGEDOUBLE1/s
aws_ec2_instance
gce_instance
Total transaksi per detik SQL Server. Sampel diambil setiap 60 detik.
write_transaction_rate GA
Rasio transaksi tulis SQL Server
GAUGEDOUBLE1/s
aws_ec2_instance
gce_instance
Transaksi tulis server SQL per detik. Sampel diambil setiap 60 detik.

Tabel yang dibuat pada 10-09-2024 pukul 02.16.59 UTC.

Metrik V2

Tabel berikut memberikan daftar metrik v2 yang dikumpulkan Agen Operasional dari instance SQL Server.

Jenis metrik
Jenis, Jenis
Resource yang dipantau
Label
workload.googleapis.com/sqlserver.batch.request.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.batch.sql_compilation.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.batch.sql_recompilation.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.lock.wait.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.lock.wait_time.avg
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.page.buffer_cache.hit_ratio
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.page.checkpoint.flush.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.page.lazy_write.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.page.life_expectancy
GAUGEINT64
gce_instance
 
workload.googleapis.com/sqlserver.page.operation.rate
GAUGEDOUBLE
gce_instance
type
workload.googleapis.com/sqlserver.page.split.rate
GAUGEDOUBLE
gce_instance
 
workload.googleapis.com/sqlserver.transaction.rate
GAUGEDOUBLE
gce_instance
database
workload.googleapis.com/sqlserver.transaction.write.rate
GAUGEDOUBLE
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.flush.data.rate
GAUGEDOUBLE
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.flush.rate
GAUGEDOUBLE
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.flush.wait.rate
GAUGEDOUBLE
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.growth.count
CUMULATIVEINT64
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.percent_used
GAUGEINT64
gce_instance
database
workload.googleapis.com/sqlserver.transaction_log.shrink.count
CUMULATIVEINT64
gce_instance
database
workload.googleapis.com/sqlserver.user.connection.count
GAUGEINT64
gce_instance
 

Memverifikasi konfigurasi

Bagian ini menjelaskan cara memverifikasi bahwa Anda telah mengonfigurasi penerima SQL Server dengan benar. Mungkin perlu waktu satu atau dua menit agar Ops Agent mulai mengumpulkan telemetri.

Untuk memverifikasi bahwa metrik SQL Server dikirim ke Cloud Monitoring, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, buka Halaman Metrics Explorer:

    Buka Metrics explorer

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Di toolbar panel {i>query-builder<i}, pilih tombol yang namanya  MQL atau  PromQL.
  3. Pastikan MQL sudah dipilih tombol Language. Tombol bahasa berada di toolbar yang sama dengan memungkinkan Anda memformat kueri.
    • Untuk metrik v1, masukkan kueri berikut di editor, lalu klik Run query:
      fetch gce_instance
      | metric 'agent.googleapis.com/mssql/connections/user'
      | every 1m
      
    • Untuk metrik v2, masukkan kueri berikut di editor, lalu klik Run:
      fetch gce_instance
      | metric 'workload.googleapis.com/sqlserver.user.connection.count'
      | every 1m
      

Lihat dasbor

Untuk melihat metrik SQL Server, Anda harus memiliki diagram atau dasbor dikonfigurasi. Integrasi SQL Server menyertakan satu atau beberapa dasbor untuk Anda. Setiap dasbor otomatis diinstal setelah Anda mengonfigurasi dan Agen Operasional telah mulai mengumpulkan data metrik.

Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.

Untuk melihat dasbor yang diinstal, lakukan tindakan berikut:

  1. Di konsol Google Cloud, buka halaman  Dashboards:

    Buka Dasbor

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Pilih tab Daftar Dasbor, lalu pilih kategori Integrasi.
  3. Klik nama dasbor yang ingin Anda lihat.

Jika Anda telah mengonfigurasi integrasi, tetapi dasbor belum diinstal, lalu periksa apakah Agen Operasional sedang berjalan. Ketika tidak ada data metrik untuk bagan di {i>dashboard<i}, penginstalan dasbor gagal. Setelah Agen Operasional mulai mengumpulkan metrik, dasbor akan diinstal keamanan untuk Anda.

Untuk melihat pratinjau statis dasbor, lakukan tindakan berikut:

  1. Di Konsol Google Cloud, buka  Integrasi halaman:

    Buka Integrations

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Klik filter platform deployment Compute Engine.
  3. Temukan entri untuk SQL Server, lalu klik Lihat Detail.
  4. Pilih tab Dasbor untuk melihat pratinjau statis. Jika sudah diinstal, maka Anda dapat membukanya dengan mengeklik Lihat dasbor.

Untuk mengetahui informasi selengkapnya tentang dasbor di Cloud Monitoring, lihat Dasbor dan diagram.

Untuk informasi selengkapnya tentang cara menggunakan halaman Integrasi, lihat Mengelola integrasi.

Instal kebijakan pemberitahuan

Kebijakan pemberitahuan menginstruksikan Cloud Monitoring untuk memberi tahu Anda saat kondisi yang ditentukan terjadi. Integrasi SQL Server mencakup satu atau beberapa kebijakan pemberitahuan untuk Anda gunakan. Anda dapat melihat dan menginstal kebijakan pemberitahuan ini dari halaman Integrations di Pemantauan.

Untuk melihat deskripsi dari kebijakan pemberitahuan yang tersedia dan menginstalnya, lakukan hal berikut:

  1. Di konsol Google Cloud, buka halaman  Integrations:

    Buka Integrations

    Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.

  2. Temukan entri untuk Server SQL lalu klik Lihat Detail.
  3. Pilih tab Alerts. Tab ini memberikan deskripsi tentang kebijakan pemberitahuan yang tersedia dan menyediakan antarmuka untuk menginstal mereka.
  4. Instal kebijakan pemberitahuan. Kebijakan pemberitahuan membutuhkan untuk mengetahui ke mana harus mengirim notifikasi bahwa peringatan itu telah dipicu, sehingga mereka memerlukan informasi dari Anda untuk instalasi. Untuk menginstal kebijakan pemberitahuan, lakukan langkah berikut:
    1. Dari daftar kebijakan pemberitahuan yang tersedia, pilih yang ingin Anda instal.
    2. Di bagian Configure notifications, pilih satu atau saluran notifikasi lainnya. Anda memiliki opsi untuk menonaktifkan penggunaan saluran notifikasi, tetapi jika Anda melakukannya, maka pemberitahuan kebijakan diaktifkan secara otomatis. Anda dapat memeriksa statusnya di Pemantauan, tetapi Anda tidak menerima notifikasi.

      Untuk informasi selengkapnya tentang saluran notifikasi, lihat Mengelola saluran notifikasi.

    3. Klik Create Policy.

Untuk mengetahui informasi selengkapnya tentang kebijakan pemberitahuan di Cloud Monitoring, lihat Pengantar pemberitahuan.

Untuk mengetahui informasi lebih lanjut tentang cara menggunakan halaman Integrations, lihat Kelola integrasi.

Langkah selanjutnya

Untuk panduan cara menggunakan Ansible untuk menginstal Agen Operasional, konfigurasi aplikasi pihak ketiga, dan menginstal dasbor contoh, lihat Instal Agen Operasional untuk memecahkan masalah video aplikasi pihak ketiga.