Halaman ini diterjemahkan oleh Cloud Translation API.

Microsoft SQL Server

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

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

Sebelum memulai

Ops Agent versi 2.15.0 memperkenalkan dukungan untuk kumpulan metrik SQL Server baru menggunakan awalan workload.googleapis.com/. Anda harus mengonfigurasi agen untuk mengumpulkan metrik ini, seperti yang dijelaskan dalam Contoh konfigurasi.

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

Dokumen ini merujuk pada metrik dengan awalan agent sebagai metrik v1 dan metrik dengan 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 Yang dipantau.

Mulai dari Ops Agent versi 2.15.0, Anda dapat mengonfigurasi agen untuk mengumpulkan metrik v1, metrik v2, atau keduanya.

Catatan: Jika Anda memiliki pemberitahuan atau konfigurasi lain yang dibuat berdasarkan metrik v1 dan beralih ke metrik v2, Anda juga harus memigrasikan konfigurasi. Jika Anda berhenti mengumpulkan metrik v1, peringatan dan pemantauan lainnya terhadap metrik tersebut akan berhenti berfungsi. Tabel berikut menunjukkan pemetaan metrik v1 ke metrik v2:

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

Prasyarat

Untuk mengumpulkan telemetri SQL Server, Anda harus menginstal 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 tinggi.

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

Mengonfigurasi Agen Operasional untuk SQL Server

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

Dengan mengikuti panduan untuk mengonfigurasi Ops Agent, tambahkan elemen yang diperlukan untuk mengumpulkan telemetri dari instance SQL Server, dan mulai ulang agen.

Setelah menyiapkan instance SQL Server baru, Anda mungkin tidak langsung melihat tampilan metrik di Metrics Explorer. Agen Ops mulai mengumpulkan metrik SQL 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 Ops di 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. Ops Agent mulai mengumpulkan metrik SQL 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, untuk memantau beberapa endpoint. Semua instance tersebut menulis ke deret waktu yang sama, dan Cloud Monitoring tidak dapat membedakannya. Ops Agent 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; gunakan `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 tindakan berikut:
- Beri nama penerima 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 selain mssql, seperti mssql_v2.
- Tetapkan kolom type ke mssql.
- Tetapkan receiver_version ke 2.
- Gunakan penerima ini di pipeline baru Anda. Konfigurasi ini menambahkan penerima v2, bukan mengganti penerima bawaan. Skrip di Contoh konfigurasi menggunakan pendekatan ini.

Yang dipantau

Mulai versi 2.15.0, Agen Operasi dapat mengumpulkan dua kumpulan metrik yang berbeda:

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.; misalnya, metric.labels.LABEL="VALUE".

Jenis metrik ^{Tahap peluncuran} (Tingkat hierarki resource) Nama tampilan
Jenis, Tipe, Unit Resource yang dimonitor	Deskripsi Label
`connections/user` ^GA *(project)* Koneksi terbuka SQL Server
`GAUGE`, `DOUBLE`, `1` aws_ec2_instance gce_instance	Koneksi yang saat ini terbuka ke server SQL. Diambil sampelnya setiap 60 detik.
`transaction_rate` ^GA *(project)* Rasio transaksi SQL Server
`GAUGE`, `DOUBLE`, `1/s` aws_ec2_instance gce_instance	Total transaksi SQL Server per detik. Diambil sampelnya setiap 60 detik.
`write_transaction_rate` ^GA *(project)* Rasio transaksi tulis SQL Server
`GAUGE`, `DOUBLE`, `1/s` aws_ec2_instance gce_instance	Transaksi tulis server SQL per detik. Diambil sampelnya setiap 60 detik.

Tabel dihasilkan pada 26-11-2024 17.39.42 UTC.

Metrik V2

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

Jenis metrik
Jenis, Tipe Resource yang dimonitor	Label
`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

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:

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.
Di toolbar panel pembuat kueri, pilih tombol yang namanya adalah MQL atau PromQL.
Pastikan MQL dipilih di tombol Language. Tombol bahasa berada di toolbar yang sama yang 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 mengonfigurasi diagram atau dasbor. Integrasi SQL Server menyertakan satu atau beberapa dasbor untuk Anda. Dasbor apa pun akan otomatis diinstal setelah Anda mengonfigurasi integrasi dan Agen Operasional telah mulai mengumpulkan data metrik.

Anda juga dapat melihat pratinjau statis dasbor tanpa menginstal integrasi.

Untuk melihat dasbor yang terinstal, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Dasbor:
Buka Dasbor

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Pilih tab Daftar Dasbor, lalu pilih kategori Integrasi.
Klik nama dasbor yang ingin Anda lihat.

Jika Anda telah mengonfigurasi integrasi, tetapi dasbor belum diinstal, pastikan Agen Operasional berjalan. Jika tidak ada data metrik untuk diagram di dasbor, penginstalan dasbor akan gagal. Setelah Ops Agent mulai mengumpulkan metrik, dasbor akan diinstal untuk Anda.

Untuk melihat pratinjau statis dasbor, lakukan tindakan berikut:

Di konsol Google Cloud, buka halaman Integrations :
Buka Integrations

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Klik filter platform deployment Compute Engine.
Temukan entri untuk SQL Server, lalu klik Lihat Detail.
Pilih tab Dasbor untuk melihat pratinjau statis. Jika dasbor telah diinstal, Anda dapat membukanya dengan mengklik 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.

Menginstal kebijakan pemberitahuan

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

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

Di konsol Google Cloud, buka halaman Integrations :
Buka Integrations

Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil yang subjudulnya adalah Monitoring.
Temukan entri untuk SQL Server, lalu klik Lihat Detail.
Pilih tab Notifikasi. Tab ini memberikan deskripsi tentang kebijakan pemberitahuan yang tersedia dan menyediakan antarmuka untuk menginstalnya.
Instal kebijakan pemberitahuan. Kebijakan pemberitahuan perlu mengetahui tempat untuk mengirim notifikasi bahwa pemberitahuan telah dipicu, sehingga memerlukan informasi dari Anda untuk penginstalan. Untuk menginstal kebijakan pemberitahuan, lakukan hal berikut:
1. Dari daftar kebijakan pemberitahuan yang tersedia, pilih kebijakan yang ingin Anda instal.
2. Di bagian Konfigurasi notifikasi, pilih satu atau beberapa saluran notifikasi. Anda memiliki opsi untuk menonaktifkan penggunaan saluran notifikasi, tetapi jika Anda melakukannya, kebijakan pemberitahuan akan 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 Policies.

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

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

Langkah selanjutnya

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