Esta página foi traduzida pela API Cloud Translation.

PostgreSQL

A integração do PostgreSQL recolhe métricas de utilização da base de dados, como o tamanho da base de dados, o número de backends ou o número de operações. A integração também recolhe registos do PostgreSQL e analisa-os num payload JSON. Este resultado inclui campos para a função, o utilizador, o nível e a mensagem.

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

Pré-requisitos

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

Para métricas, instale a versão 2.21.0 ou superior.
Para registos, instale a versão 2.9.0 ou superior.

Esta integração suporta a versão 10.18 e posteriores do PostgreSQL.

Configure a sua instância do PostgreSQL

O recetor postgresql liga-se por predefinição a um servidor postgresql local através de um socket Unix e da autenticação Unix como utilizador root.

Configure o agente de operações para o PostgreSQL

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

Exemplo de configuração

Os seguintes comandos criam a configuração para recolher e carregar telemetria para o PostgreSQL:

# Configures Ops Agent to collect telemetry from the app. You must restart the agent for the configuration to take effect.

set -e

# Check if the file exists
if [ ! -f /etc/google-cloud-ops-agent/config.yaml ]; then
  # Create the file if it doesn't exist.
  sudo mkdir -p /etc/google-cloud-ops-agent
  sudo touch /etc/google-cloud-ops-agent/config.yaml
fi

# Create a back up of the existing file so existing configurations are not lost.
sudo cp /etc/google-cloud-ops-agent/config.yaml /etc/google-cloud-ops-agent/config.yaml.bak

# Configure the Ops Agent.
sudo tee /etc/google-cloud-ops-agent/config.yaml > /dev/null << EOF
metrics:
  receivers:
    postgresql:
      type: postgresql
      username: postgres
      password: abc123
      # To use the googlesecretmanager provider to replace plaintext passwords, refer to the example below.
      # password: ${googlesecretmanager:projects/<project-id>/secrets/<secret-id>/versions/<version-id>}
      insecure: true
      endpoint: localhost:5432
  service:
    pipelines:
      postgresql:
        receivers:
        - postgresql
logging:
  receivers:
    postgresql_general:
      type: postgresql_general
  service:
    pipelines:
      postgresql:
        receivers:
          - postgresql_general
EOF

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

Linux

Para reiniciar o agente, execute o seguinte comando na sua instância:
```
sudo systemctl restart google-cloud-ops-agent
```
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:
```
sudo systemctl status "google-cloud-ops-agent*"
```

Windows

Estabeleça ligação à sua instância através do RDP ou de uma ferramenta semelhante e inicie sessão no Windows.
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
Para reiniciar o agente, execute o seguinte comando do PowerShell:
```
Restart-Service google-cloud-ops-agent -Force
```
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 registos

Para carregar registos do PostgreSQL, tem de criar um recetor para os registos produzidos pelo PostgreSQL e, em seguida, criar um pipeline para o novo recetor.

Para configurar um recetor para os seus registos postgresql_general, especifique os seguintes campos:

Campo	Predefinição	Descrição
`exclude_paths`		Uma lista de padrões de caminhos do sistema de ficheiros a excluir do conjunto correspondente a `include_paths`.
`include_paths`	`[/var/log/postgresql/postgresql.log, /var/lib/pgsql/data/log/postgresql.log, /var/lib/pgsql//data/log/postgresql.log]`	Uma lista de caminhos do sistema de ficheiros a ler através da análise detalhada de cada ficheiro. Pode usar um caráter universal (`*`) nos caminhos.
`record_log_file_path`	`false`	Se estiver definido como `true`, o caminho para o ficheiro específico a partir do qual o registo de registo foi obtido aparece na entrada de registo de saída como o valor da etiqueta `agent.googleapis.com/log_file_path`. Quando usa um caráter universal, apenas é registado o caminho do ficheiro a partir do qual o registo foi obtido.
`type`		Este valor tem de ser `postgresql_general`.
`wildcard_refresh_interval`	`60s`	O intervalo no qual os caminhos de ficheiros com carateres universais em `include_paths` são atualizados. Indicado como uma duração, por exemplo, `30s` ou `2m`. Esta propriedade pode ser útil em débitos de registo elevados, em que os ficheiros de registo são rodados mais rapidamente do que o intervalo predefinido.

O que é registado

O logName é derivado dos IDs dos recetores especificados na configuração. Os campos detalhados no interior de LogEntry são os seguintes.

Os registos postgresql_general contêm os seguintes campos em LogEntry:

Campo	Tipo	Descrição
`jsonPayload.database`	de string	Nome da base de dados da ação que está a ser registada quando relevante
`jsonPayload.level`	de string	Gravidade do registo ou tipo de interação com a base de dados para alguns registos
`jsonPayload.message`	de string	Registo da ação da base de dados
`jsonPayload.tid`	número	ID da discussão de onde o registo se originou
`jsonPayload.user`	de string	Utilizador autenticado para a ação que está a ser registada quando relevante
`severity`	string (`LogSeverity`)	Nível de entrada de registo (traduzido).

Configure a recolha de métricas

Para carregar métricas do PostgreSQL, tem de criar um recetor para as métricas produzidas pelo PostgreSQL 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.

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

Campo	Predefinição	Descrição
`ca_file`		Caminho para o certificado da AC. Como cliente, isto valida o certificado do servidor. Se estiver vazio, o destinatário usa a AC de raiz do sistema.
`cert_file`		Caminho para o certificado TLS a usar para ligações que requerem mTLS.
`collection_interval`	`60s`	Um valor de duração, como `30s` ou `5m`.
`endpoint`	`/var/run/postgresql/.s.PGSQL.5432`	O `hostname:port` ou o caminho do socket Unix que começa com `/` usado para estabelecer ligação ao servidor PostgreSQL.
`insecure`	`true`	Define se deve ou não usar uma ligação TLS segura. Se estiver definida como `false`, o TLS está ativado.
`insecure_skip_verify`	`false`	Define se a validação do certificado deve ou não ser ignorada. Se `insecure` estiver definido como `true`, o valor `insecure_skip_verify` não é usado.
`key_file`		Caminho para a chave TLS a usar para ligações que requerem mTLS.
`password`		A palavra-passe usada para estabelecer ligação ao servidor.
`type`		Este valor tem de ser `postgresql`.
`username`		O nome de utilizador usado para estabelecer ligação ao servidor.

O que é monitorizado

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

Tipo de métrica
Tipo, Tipo Recursos monitorizados	Etiquetas
`workload.googleapis.com/postgresql.backends`
`GAUGE`, `INT64` gce_instance	`database`
`workload.googleapis.com/postgresql.bgwriter.buffers.allocated`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/postgresql.bgwriter.buffers.writes`
`CUMULATIVE`, `INT64` gce_instance	`source`
`workload.googleapis.com/postgresql.bgwriter.checkpoint.count`
`CUMULATIVE`, `INT64` gce_instance	`type`
`workload.googleapis.com/postgresql.bgwriter.duration`
`CUMULATIVE`, `INT64` gce_instance	`type`
`workload.googleapis.com/postgresql.bgwriter.maxwritten`
`CUMULATIVE`, `INT64` gce_instance
`workload.googleapis.com/postgresql.blocks_read`
`CUMULATIVE`, `INT64` gce_instance	`database` `source` `table`
`workload.googleapis.com/postgresql.commits`
`CUMULATIVE`, `INT64` gce_instance	`database`
`workload.googleapis.com/postgresql.connection.max`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/postgresql.database.count`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/postgresql.db_size`
`GAUGE`, `INT64` gce_instance	`database`
`workload.googleapis.com/postgresql.index.scans`
`CUMULATIVE`, `INT64` gce_instance	`database` `index` `table`
`workload.googleapis.com/postgresql.index.size`
`GAUGE`, `INT64` gce_instance	`database` `index` `table`
`workload.googleapis.com/postgresql.operations`
`CUMULATIVE`, `INT64` gce_instance	`database` `operation` `table`
`workload.googleapis.com/postgresql.replication.data_delay`
`GAUGE`, `INT64` gce_instance	`replication_client`
`workload.googleapis.com/postgresql.rollbacks`
`CUMULATIVE`, `INT64` gce_instance	`database`
`workload.googleapis.com/postgresql.rows`
`GAUGE`, `INT64` gce_instance	`database` `state` `table`
`workload.googleapis.com/postgresql.table.count`
`GAUGE`, `INT64` gce_instance	`database`
`workload.googleapis.com/postgresql.table.size`
`GAUGE`, `INT64` gce_instance	`database` `table`
`workload.googleapis.com/postgresql.table.vacuum.count`
`CUMULATIVE`, `INT64` gce_instance	`database` `table`
`workload.googleapis.com/postgresql.wal.age`
`GAUGE`, `INT64` gce_instance
`workload.googleapis.com/postgresql.wal.lag`
`GAUGE`, `INT64` gce_instance	`operation` `replication_client`

Valide a configuração

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

Para verificar se os registos do PostgreSQL estão a ser enviados para o Cloud Logging, faça o seguinte:

Na Google Cloud consola, aceda à página Explorador de registos:
Aceda ao Explorador de registos

Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cuja legenda é Registo.
Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:
```
resource.type="gce_instance"
log_id("postgresql_general")
```

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

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.
Na barra de ferramentas do painel do criador de consultas, selecione o botão cujo nome é MQL ou PromQL.
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.

Introduza a seguinte consulta no editor e, de seguida, clique em Executar consulta:

{"workload.googleapis.com/postgresql.backends", monitored_resource="gce_instance"}

Ver o painel de controlo

Para ver as métricas do PostgreSQL, tem de ter um gráfico ou um painel de controlo configurado. A integração do PostgreSQL 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:

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.
Selecione o separador Lista de painéis de controlo e, de seguida, escolha a categoria Integrações.
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:

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.
Clique no filtro da plataforma de implementação Compute Engine.
Localize a entrada para PostgreSQL e clique em Ver detalhes.
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 PostgreSQL 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:

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.
Localize a entrada para PostgreSQL e clique em Ver detalhes.
Selecione o separador Alertas. Este separador apresenta descrições das políticas de alerta disponíveis e uma interface para as instalar.
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.