Microsoft SQL Server

L'integrazione di Microsoft SQL Server raccoglie metriche relative a transazioni, connessioni e altro dalle tue istanze SQL Server.

Per saperne di più su SQL Server, consulta la documentazione di SQL Server.

Prima di iniziare

La versione 2.15.0 di Ops Agent introduce il supporto per un nuovo insieme di metriche di SQL Server che utilizzano il prefisso workload.googleapis.com/. Devi configurare l'agente per raccogliere queste metriche, come descritto in Configurazione di esempio.

Ops Agent ha sempre supportato un insieme limitato di metriche di SQL Server; queste metriche utilizzano il prefisso agent.googleapis.com/mssql/. Non è necessaria alcuna configurazione aggiuntiva per raccogliere queste metriche sulle VM Windows.

Questo documento fa riferimento alle metriche con prefisso agent come metriche v1 e alle metriche con prefisso workload come metriche v2.

• Le metriche v1 includono informazioni sulla frequenza delle transazioni e sul numero di connessioni.
• Le metriche v2 includono informazioni sul numero di connessioni di batch, blocchi, pagine e utenti a livello di istanza, nonché informazioni su transazioni e log delle transazioni a livello di database.

Per le tabelle di queste metriche, consulta Cosa viene monitorato.

A partire dalla versione 2.15.0 di Ops Agent, puoi configurare l'agente in modo che raccolga metriche v1, metriche v2 o entrambe.

Nota: se hai avvisi o altre configurazioni basate sulle metriche v1 e passi alle metriche v2, devi eseguire anche la migrazione delle configurazioni. Se interrompi la raccolta delle metriche v1, gli avvisi e altri monitoraggi di queste metriche smetteranno di funzionare. La seguente tabella mostra il mapping delle metriche v1 alle metriche v2:

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

Prerequisiti

Per raccogliere la telemetria di SQL Server, devi installare Ops Agent:

• Per le metriche v1, installa la versione 1.0.0 o successive.
• Per le metriche v2, installa la versione 2.15.0 o successiva.

Questa integrazione supporta le versioni 11.x, 12.x, 13.x, 14.x, 15.x e 16.x di SQL Server.

Configura Ops Agent per SQL Server

Quando utilizzi Ops Agent su una VM Microsoft Windows, l'agente raccoglie automaticamente le metriche di SQL Server v1. Non occorrono ulteriori configurazioni.

Segui la guida per configurare Ops Agent, aggiungi gli elementi richiesti per raccogliere i dati di telemetria dalle istanze SQL Server e riavvia l'agente.

Dopo aver configurato una nuova istanza di SQL Server, potresti non visualizzare immediatamente le metriche inMetrics Explorere. Ops Agent inizia a raccogliere le metriche di SQL Server solo dopo che sono state registrate attività del database da segnalare.

Configurazione di esempio

I seguenti comandi creano la configurazione per raccogliere e importare la telemetria per 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 an empty config.yaml file if it doesn't exist.
$configFilePath  = 'C:\Program Files\Google\Cloud Operations\Ops Agent\config\config.yaml'

if (-not (Test-Path -Path $configFilePath -PathType Leaf)) {
    New-Item -ItemType File -Path $configFilePath -Force | Out-Null
}

# 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
"

if (Get-Service google-cloud-ops-agent* -ErrorAction SilentlyContinue) {
  (Get-Service google-cloud-ops-agent*).WaitForStatus('Running', '00:03:00')
}

Affinché queste modifiche vengano applicate, devi riavviare Ops Agent:

1. Connettiti all'istanza utilizzando RDP o uno strumento simile e accedi a Windows.
2. Apri un terminale PowerShell con privilegi amministrativi facendo clic con il tasto destro del mouse sull'icona di PowerShell e selezionando Esegui come amministratore.
3. Per riavviare l'agente, esegui il seguente comando PowerShell:

   Restart-Service google-cloud-ops-agent -Force
   

4. Per verificare che l'agente sia stato riavviato, esegui il seguente comando e verifica che i componenti "Agente Metriche" e "Agente Logging" siano stati avviati:

   Get-Service google-cloud-ops-agent*
   

Configura la raccolta delle metriche v1

Ops Agent su una VM Microsoft Windows raccoglie automaticamente le metriche di SQL Server v1. Non occorrono ulteriori configurazioni. Per informazioni sulla raccolta solo delle metriche v2, consulta Configura la raccolta delle metriche v2.

Dopo aver configurato una nuova istanza SQL Server, SQL Server potrebbe non segnalare immediatamente le metriche. Ops Agent inizia a raccogliere le metriche di SQL Server dopo che è stata registrata un'attività del database da segnalare.

Configura la raccolta delle metriche v2

Per importare le metriche v2 da SQL Server, devi creare un ricevitore per le metriche prodotte da SQL Server e poi creare una pipeline per il nuovo ricevitore.

Questo receiver non supporta l'utilizzo di più istanze nella configurazione, ad esempio per monitorare più endpoint. Tutte queste istanze scrivono nella stessa serie temporale e Cloud Monitoring non ha modo di distinguerle. Ops Agent non supporta le istanze denominate di SQL Server.

Per configurare un ricevitore per le metriche mssql, specifica i seguenti campi:

Campo	Predefinito	Descrizione
collection_interval	60s	Un valore time.Duration, ad esempio 30s o 5m.
receiver_version		Versione delle metriche raccolte; utilizza 2 per raccogliere le metriche della versione 2.
type		Questo valore deve essere mssql.

Per impostazione predefinita, le metriche v1 vengono raccolte automaticamente. Puoi aumentare le metriche v1 raccogliendo anche le metriche v2 oppure puoi sostituire le metriche v1 per raccogliere solo le metriche v2.

• Per raccogliere solo le metriche v2:

  • Assegna un nome al ricevitore mssql.
  • Imposta il campo type su mssql.
  • Imposta il campo receiver_version su 2.
  • Utilizza questo ricevitore nella pipeline default_pipeline. Questa configurazione sostituisce quella integrata del ricevitore mssql.

• Per raccogliere le metriche v1 e v2, segui questi passaggi:

  • Assegna al ricevitore un nome diverso da mssql, ad esempio mssql_v2.
  • Imposta il campo type su mssql.
  • Imposta receiver_version su 2.
  • Utilizza questo ricevitore nella nuova pipeline. Questa configurazione aggiunge un ricevitore v2 anziché sostituire quello integrato. Lo script in Configurazione di esempio utilizza questo approccio.

Che cosa viene monitorato

A partire dalla versione 2.15.0, Ops Agent può raccogliere due diversi insiemi di metriche:

• Le metriche v1: agent.googleapis.com/mssql/.
• Le metriche v2: workload.googleapis.com/.

Metriche V1

La tabella seguente fornisce l'elenco delle metriche v1 raccolte da Ops Agent dall'istanza SQL Server.

Le stringhe "tipo di metrica" in questa tabella devono essere precedute dal prefisso agent.googleapis.com/mssql/. Questo prefisso è stato omesso dalle voci della tabella. Quando esegui una query su un'etichetta, utilizza il prefisso metric.labels., ad esempio metric.labels.LABEL="VALUE".

Tipo di metrica ^Fase di lancio (Livelli della gerarchia delle risorse) Nome visualizzato
Kind, Type, Unit Risorse monitorate	Descrizione Etichette
connections/user ^GA  (progetto) Connessioni aperte di SQL Server
GAUGE, DOUBLE, 1 aws_ec2_instance gce_instance	Connessioni attualmente aperte al server SQL. Campionamento eseguito ogni 60 secondi.
transaction_rate ^GA  (progetto) Frequenza delle transazioni SQL Server
GAUGE, DOUBLE, 1/s aws_ec2_instance gce_instance	Transazioni totali al secondo di SQL Server. Campionamento eseguito ogni 60 secondi.
write_transaction_rate ^GA  (progetto) Tasso di transazioni di scrittura di SQL Server
GAUGE, DOUBLE, 1/s aws_ec2_instance gce_instance	Transazioni di scrittura di SQL Server al secondo. Campionamento eseguito ogni 60 secondi.

Tabella generata il 14/10/2026 alle 20:24:33 UTC.

Metriche V2

La tabella seguente fornisce l'elenco delle metriche v2 che Ops Agent raccoglie dall'istanza SQL Server.

Tipo di metrica
Kind, Type Risorse monitorate	Etichette
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

Verificare la configurazione

Questa sezione descrive come verificare di aver configurato correttamente il receiver SQL Server. L'avvio della raccolta dei dati di telemetria da parte di Ops Agent potrebbe richiedere uno o due minuti.

Per verificare che le metriche di SQL Server vengano inviate a Cloud Monitoring, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina  Esplora metriche:

   Vai a Esplora metriche

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Nella barra degli strumenti del riquadro Query Builder, seleziona il pulsante il cui nome è  PromQL.
• Per le metriche v1, inserisci la seguente query nell'editor, quindi fai clic su Esegui query:
  

  {"agent.googleapis.com/mssql/connections/user", monitored_resource="gce_instance"}
  

• Per le metriche v2, inserisci la seguente query nell'editor e poi fai clic su Esegui:
  

  {"workload.googleapis.com/sqlserver.user.connection.count", monitored_resource="gce_instance"}
  

Visualizza dashboard

Per visualizzare le metriche di SQL Server, devi aver configurato un grafico o una dashboard. L'integrazione di SQL Server include uno o più dashboard. Le dashboard vengono installate automaticamente dopo la configurazione dell'integrazione e l'inizio della raccolta dei dati delle metriche da parte di Ops Agent.

Puoi anche visualizzare anteprime statiche delle dashboard senza installare l'integrazione.

Per visualizzare una dashboard installata, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina  Dashboard:

   Vai a Dashboard

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Seleziona la scheda Elenco dashboard, quindi scegli la categoria Integrazioni.
3. Fai clic sul nome della dashboard che vuoi visualizzare.

Se hai configurato un'integrazione, ma la dashboard non è stata installata, verifica che Ops Agent sia in esecuzione. Se non sono presenti dati delle metriche per un grafico nella dashboard, l'installazione della dashboard non va a buon fine. Dopo che Ops Agent inizia a raccogliere le metriche, la dashboard viene installata per te.

Per visualizzare un'anteprima statica della dashboard:

1. Nella console Google Cloud , vai alla pagina  Integrazioni:

   Vai a Integrazioni

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Fai clic sul filtro della piattaforma di deployment Compute Engine.
3. Individua la voce per SQL Server e fai clic su Visualizza dettagli.
4. Seleziona la scheda Dashboard per visualizzare un'anteprima statica. Se la dashboard è installata, puoi accedervi facendo clic su Visualizza dashboard.

Per ulteriori informazioni sulle dashboard in Cloud Monitoring, consulta Dashboard e grafici.

Per saperne di più sull'utilizzo della pagina Integrazioni, consulta Gestisci le integrazioni.

Installa policy di avviso

Le policy di avviso indicano a Cloud Monitoring di inviarti una notifica quando si verificano condizioni specificate. L'integrazione di SQL Server include una o più policy di avviso che puoi utilizzare. Puoi visualizzare e installare queste policy di avviso dalla pagina Integrazioni in Monitoring.

Per visualizzare le descrizioni delle policy di avviso disponibili e installarle, segui questi passaggi:

1. Nella console Google Cloud , vai alla pagina  Integrazioni:

   Vai a Integrazioni

   Se utilizzi la barra di ricerca per trovare questa pagina, seleziona il risultato con il sottotitolo Monitoring.

2. Individua la voce relativa a SQL Server e fai clic su Visualizza dettagli.
3. Seleziona la scheda Avvisi. Questa scheda fornisce descrizioni delle policy di avviso disponibili e un'interfaccia per installarle.
4. Installa policy di avviso. Le policy di avviso devono sapere dove inviare le notifiche di attivazione dell'avviso, pertanto richiedono informazioni da parte tua per l'installazione. Per installare le policy di avviso:
   1. Dall'elenco dei criteri di avviso disponibili, seleziona quelli che vuoi installare.

   2. Nella sezione Configura le notifiche, seleziona uno o più canali di notifica. Puoi disattivare l'utilizzo dei canali di notifica, ma in questo caso le policy di avviso vengono attivate in silenzio. Puoi controllare il loro stato in Monitoraggio, ma non ricevi notifiche.

      Per saperne di più sui canali di notifica, consulta Gestisci i canali di notifica.

   3. Fai clic su Crea policy.

Per saperne di più sulle policy di avviso in Cloud Monitoring, consulta Introduzione agli avvisi.

Per saperne di più sull'utilizzo della pagina Integrazioni, consulta Gestisci le integrazioni.

Passaggi successivi

Per una procedura dettagliata su come utilizzare Ansible per installare Ops Agent, configurare un'applicazione di terze parti e installare una dashboard di esempio, guarda il video Installa Ops Agent per risolvere i problemi delle applicazioni di terze parti.