Microsoft SQL Server

A integração do Microsoft SQL Server recolhe transações, ligações e outras métricas das suas instâncias do SQL Server.

Para mais informações sobre o SQL Server, consulte a documentação do SQL Server.

Antes de começar

A versão 2.15.0 do agente de operações introduz suporte para um novo conjunto de métricas do SQL Server com o prefixo workload.googleapis.com/. Tem de configurar o agente para recolher estas métricas, conforme descrito na configuração de exemplo.

O agente de operações sempre suportou um conjunto limitado de métricas do SQL Server; estas métricas usam o prefixo agent.googleapis.com/mssql/. Não é necessária nenhuma configuração adicional para recolher estas métricas em VMs do Windows.

Este documento refere-se às métricas com o prefixo agent como métricas v1 e às métricas com o prefixo workload como métricas v2.

• As métricas da v1 incluem informações sobre a taxa de transação e a quantidade de ligações.
• As métricas da v2 incluem informações de lote, bloqueio, página e contagem de ligações de utilizadores ao nível da instância, e informações de transações e registo de transações ao nível da base de dados.

Para ver tabelas destas métricas, consulte o artigo O que é monitorizado.

A partir da versão 2.15.0 do agente de operações, pode configurar o agente para recolher métricas v1, métricas v2 ou ambas.

Nota: se tiver alertas ou outras configurações criadas com base nas métricas da v1 e mudar para as métricas da v2, também tem de migrar as suas configurações. Se parar de recolher métricas da versão 1, os alertas e outra monitorização dessas métricas vão deixar de funcionar. A tabela seguinte mostra o mapeamento das métricas da v1 para as métricas da v2:

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

Pré-requisitos

Para recolher telemetria do SQL Server, tem de instalar o agente de operações:

• Para as métricas v1, instale a versão 1.0.0 ou superior.
• Para as métricas v2, instale a versão 2.15.0 ou superior.

Esta integração suporta as versões 11.x, 12.x, 13.x, 14.x, 15.x e 16.x do SQL Server.

Configure o agente de operações para o SQL Server

Quando usa o agente de operações numa VM do Microsoft Windows, o agente recolhe automaticamente as métricas do SQL Server v1. Não é necessária nenhuma configuração adicional.

Seguindo o guia para configurar o Ops Agent, adicione os elementos necessários para recolher telemetria de instâncias do SQL Server e reinicie o agente.

Depois de configurar uma nova instância do SQL Server, pode não ver imediatamente as métricas apresentadas no explorador de métricas. O agente de operações começa a recolher métricas do SQL Server apenas depois de haver atividade da base de dados para comunicar.

Exemplo de configuração

Os seguintes comandos criam a configuração para recolher e carregar telemetria para o 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')
}

Para que estas alterações entrem em vigor, tem de reiniciar o agente de operações:

1. Estabeleça ligação à sua instância através do RDP ou de uma ferramenta semelhante e inicie sessão no Windows.
2. Abra um terminal do PowerShell com privilégios de administrador: clique com o botão direito do rato no ícone do PowerShell e selecione Executar como administrador
3. Para reiniciar o agente, execute o seguinte comando do PowerShell:

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

4. Para confirmar que o agente foi reiniciado, execute o seguinte comando e verifique se os componentes "Agente de métricas" e "Agente de registo" foram iniciados:

   Get-Service google-cloud-ops-agent*
   

Configure a recolha de métricas da v1

O agente de operações numa VM do Microsoft Windows recolhe automaticamente métricas do SQL Server v1. Não é necessária nenhuma configuração adicional. Para obter informações sobre a recolha apenas de métricas da v2, consulte o artigo Configure a recolha de métricas da v2.

Depois de configurar uma nova instância do SQL Server, o SQL Server pode não comunicar imediatamente quaisquer métricas. O agente de operações começa a recolher métricas do SQL Server depois de haver atividade da base de dados para comunicar.

Configure a recolha de métricas da versão 2

Para carregar métricas da versão 2 do SQL Server, tem de criar um recetor para as métricas que o SQL Server produz e, em seguida, criar um pipeline para o novo recetor.

Este recetor não suporta a utilização de várias instâncias na configuração, por exemplo, para monitorizar vários pontos finais. Todas essas instâncias escrevem na mesma série cronológica e o Cloud Monitoring não tem forma de as distinguir. O agente Ops não suporta instâncias nomeadas do SQL Server.

Para configurar um destinatário para as suas métricas mssql, especifique os seguintes campos:

Campo	Predefinição	Descrição
collection_interval	60s	Um valor time.Duration, como 30s ou 5m.
receiver_version		Versão das métricas recolhidas; use 2 para recolher métricas da v2.
type		Este valor tem de ser mssql.

Por predefinição, as métricas da v1 são recolhidas automaticamente. Pode aumentar as métricas v1 recolhendo também métricas v2 ou pode substituir as métricas v1 para recolher apenas métricas v2.

• Para recolher apenas métricas da versão 2, faça o seguinte:

  • Atribua um nome ao recetor mssql.
  • Defina o campo type como mssql.
  • Defina o campo receiver_version como 2.
  • Use este recetor no seu pipeline default_pipeline. Esta configuração substitui a configuração integrada do recetor mssql.

• Para recolher métricas v1 e v2, faça o seguinte:

  • Atribua ao recetor um nome diferente de mssql, como mssql_v2.
  • Defina o campo type como mssql.
  • Definir o receiver_version para 2.
  • Use este recetor no novo pipeline. Esta configuração adiciona um recetor v2 em vez de substituir o recetor incorporado. O script na Configuração de exemplo usa esta abordagem.

O que é monitorizado

A partir da versão 2.15.0, o agente de operações pode recolher dois conjuntos diferentes de métricas:

• As métricas da v1: agent.googleapis.com/mssql/.
• As métricas da v2: workload.googleapis.com/.

Métricas V1

A tabela seguinte apresenta a lista de métricas da v1 que o agente de operações recolhe da instância do SQL Server.

As strings "metric type" nesta tabela têm de ter o prefixo agent.googleapis.com/mssql/. Esse prefixo foi omitido das entradas na tabela. Ao consultar uma etiqueta, use o prefixo metric.labels.; por exemplo, metric.labels.LABEL="VALUE".

Tipo de métrica ^Fase de lançamento (Níveis da hierarquia de recursos) Nome a apresentar
Kind, Type, Unit Recursos monitorizados	Descrição Etiquetas
connections/user ^GA  (project) SQL Server open connections
GAUGE, DOUBLE, 1 aws_ec2_instance gce_instance	Ligações atualmente abertas ao servidor SQL. Amostrada a cada 60 segundos.
transaction_rate ^GA  (project) Taxa de transação do SQL Server
GAUGE, DOUBLE, 1/s aws_ec2_instance gce_instance	Total de transações por segundo do servidor SQL. Amostrada a cada 60 segundos.
write_transaction_rate ^GA  (project) Taxa de transação de gravação do SQL Server
GAUGE, DOUBLE, 1/s aws_ec2_instance gce_instance	Transações de escrita do servidor SQL por segundo. Amostrada a cada 60 segundos.

Tabela gerada a 12/09/2025 às 17:40:42 UTC.

Métricas da V2

A tabela seguinte apresenta a lista de métricas da v2 que o agente de operações recolhe da instância do SQL Server.

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
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

Valide a configuração

Esta secção descreve como verificar se configurou corretamente o recetor do SQL Server. O agente de operações pode demorar um ou dois minutos a começar a recolher telemetria.

Para verificar se as métricas do SQL Server estão a ser enviadas para o Cloud Monitoring, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é  MQL ou  PromQL.
3. Verifique se a opção PromQL está selecionada no botão Idioma. O botão para alternar o idioma encontra-se na mesma barra de ferramentas que lhe permite formatar a consulta.
• Para métricas da v1, introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
  

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

• Para métricas da v2, introduza a seguinte consulta no editor e, de seguida, clique em Executar:
  

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

Ver o painel de controlo

Para ver as métricas do SQL Server, tem de ter um gráfico ou um painel de controlo configurado. A integração do SQL Server inclui um ou mais painéis de controlo para si. Todos os painéis de controlo são instalados automaticamente depois de configurar a integração e o agente de operações começar a recolher dados de métricas.

Também pode ver pré-visualizações estáticas de painéis de controlo sem instalar a integração.

Para ver um painel de controlo instalado, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Painéis de controlo:

   Aceda a Painéis de controlo

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Selecione o separador Lista de painéis de controlo e, de seguida, escolha a categoria Integrações.
3. Clique no nome do painel de controlo que quer ver.

Se configurou uma integração, mas o painel de controlo não foi instalado, verifique se o agente de operações está em execução. Quando não existem dados de métricas para um gráfico no painel de controlo, a instalação do painel de controlo falha. Depois de o agente de operações começar a recolher métricas, o painel de controlo é instalado para si.

Para ver uma pré-visualização estática do painel de controlo, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Integrações:

   Aceda a Integrações

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Clique no filtro da plataforma de implementação Compute Engine.
3. Localize a entrada para SQL Server e clique em Ver detalhes.
4. Selecione o separador Painéis de controlo para ver uma pré-visualização estática. Se o painel de controlo estiver instalado, pode navegar até ele clicando em Ver painel de controlo.

Para mais informações acerca dos painéis de controlo no Cloud Monitoring, consulte o artigo Painéis de controlo e gráficos.

Para mais informações sobre como usar a página Integrações, consulte o artigo Gerir integrações.

Instale políticas de alerta

As políticas de alerta indicam ao Cloud Monitoring que lhe envie uma notificação quando ocorrerem condições especificadas. A integração do SQL Server inclui uma ou mais políticas de alerta para sua utilização. Pode ver e instalar estas políticas de alerta na página Integrações em Monitorização.

Para ver as descrições das políticas de alerta disponíveis e instalá-las, faça o seguinte:

1. Na Google Cloud consola, aceda à página  Integrações:

   Aceda a Integrações

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

2. Localize a entrada para SQL Server e clique em Ver detalhes.
3. Selecione o separador Alertas. Este separador apresenta descrições das políticas de alerta disponíveis e uma interface para as instalar.
4. Instale políticas de alerta. As políticas de alerta precisam de saber para onde enviar notificações de que o alerta foi acionado, pelo que requerem informações suas para a instalação. Para instalar políticas de alerta, faça o seguinte:
   1. Na lista de políticas de alerta disponíveis, selecione as que quer instalar.

   2. Na secção Configurar notificações, selecione um ou mais canais de notificação. Tem a opção de desativar a utilização de canais de notificação, mas, se o fizer, as suas políticas de alerta são acionadas silenciosamente. Pode verificar o respetivo estado em Monitorização, mas não recebe notificações.

      Para mais informações sobre os canais de notificação, consulte o artigo Faça a gestão dos canais de notificação.

   3. Clique em Criar políticas.

Para mais informações sobre as políticas de alerta no Cloud Monitoring, consulte o artigo Introdução aos alertas.

Para mais informações sobre como usar a página Integrações, consulte o artigo Gerir integrações.

O que se segue?

Para ver um passo a passo sobre como usar o Ansible para instalar o agente de operações, configurar uma aplicação de terceiros e instalar um painel de controlo de exemplo, consulte o vídeo Instale o agente de operações para resolver problemas de aplicações de terceiros.