Pular para o conteúdo principal
Versão 3.1.0

Instalação do Serviço de Observabilidade

No PostgreSYS, o serviço de Observabilidade é implementado através da integração dos componentes Prometheus, Grafana, Alertmanager e Karma, responsáveis por recolher, armazenar e exibir métricas e alertas de todo o ambiente de base de dados PostgreSQL.

Pré-Requisitos

  • Instalação do PgSmart, observando os requisitos mínimos.

  • Repositório de pacotes extras para resolver dependências indiretas. Em conformidade com as políticas de segurança e suporte de cada organização, a Tecnisys não fornece tais pacotes. De toda forma, visando auxiliá-los, informamos que para distribuições da família Enterprise Linux o repositório Extra Packages for Enterprise Linux - EPEL geralmente fornece as dependências indiretas necessárias.

  • Inicialização do serviço do Agente do PgSmart em todas as máquinas do ambiente de base de dados.

    Terminal input
    systemctl start pgsmart-agent

  • Acesso com o usuário local PgSmart. Por exemplo:

    Terminal input
    su - PgSmart

  • Registo de Agentes por meio do PgSmart-Client.

Sintaxe do Comando
Terminal input
pgsmart install -s obs
Terminal input
pgsmart install --service=obs

Flags:​

  • -M, --pgversion=(11/12/13/14/15). Default: 15. => Versão majoritária do PostgreSQL, independentemente do serviço. Será usada a release mais recente da versão majoritária escolhida.
  • -a, --agent= <agent>. => Alias, hostname ou IP do servidor onde o PgSmart Agent pretendido está instalado.
  • -h, --help . => Ajuda
  • -q, --quiet. => Execução não interativa para a instalação dos serviços. Usada juntamente com --service, --pg-major-version, --agent.
Instalação Não-Interativa

Este modo de instalação é ativado pela opção quiet (--quiet, -q) e sua execução utiliza os valores padrão (default) para os parâmetros não informados. Contudo, esta opção é desabilitada na primeira instalação, visto a necessidade de criação do Repositório de pacotes do PostgreSYS baseado nas informações solicitadas interativamente.

Terminal input
    pgsmart install -q -a 192.168.0.102 --service obs --pgversion=16
Figura 1 -Instalação Observabilidade - Não Interativa
Figura 1 -Instalação Observabilidade - Não Interativa
Instalação Interativa
Terminal input
pgsmart install

  1. Escolha o Agente do PgSmart (ou Registar um Novo Agente).

  2. Escolha o serviço Observabilidade.

  3. Escolha a versão majoritária do PostgreSQL .

  4. Escolha a release da versão majoritária do PostgreSQL .

  5. Confirme a instalação.

  6. Confirme se deseja instalar o Repositório de pacotes do PostgreSYS.

    6.1. Caso tenha optado por instalar/atualizar o Repositório de pacotes, introduza a URL do Repositório de pacotes.

    nota

    A instalação do repositório conterá o registo de onde os pacotes dos componentes da plataforma PostgreSYS podem ser descarregados. A opção de instalação do Repositório de pacotes não é realizada se os repositórios pgsys-utils já estiverem presentes ou mapeados na máquina.

    Figura 2 -Instalação Observabilidade - Interativa
    Figura 2 -Instalação Observabilidade - Interativa

Variações do Comando para Instalação Interativa​

Alguns parâmetros podem ser repassados previamente no comando; entretanto, a execução continua interativa, ou seja, durante a instalação, os parâmetros informados deverão ser confirmados, juntamente com os valores "Default" para aqueles parâmetros não informados.

Exemplos:

Terminal input
    pgsmart install --service=pool
Terminal input
    pgsmart install --service=pool --pg-version=15
Notas Finais
nota

O PgSmart define variáveis de ambiente (PGDATA, PGBIN, entre outras) no ficheiro bash_profile do usuário corrente que serão carregadas em novas sessões. Caso deseje carregar imediatamente estas variáveis execute o comando abaixo após a instalação:

Terminal input
    source ~/.bash_profile