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 coletar, armazenar e exibir métricas e alertas de todo o ambiente de banco 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 Banco de Dados.

    Terminal input
    systemctl start pgsmart-agent

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

    Terminal input
    su - PgSmart

  • Registro dos Agentes do PgSmart 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 desejado 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 e --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. Selecione o Agente do PgSmart (ou registre um novo).

  2. Selecione o serviço Observabilidade.

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

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

  5. Confirme a instalação:

  6. Confirme se deseja instalar/atualizar o Repositório de Pacotes do PostgreSYS..

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

    nota

    A opção de instalação do Repositório de Pacotes não é realizada se os repositórios do pgsys 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 arquivo 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