Pular para o conteúdo principal
Versão Next

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 CLI, 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 de Agentes por meio do PgSmart-Client.

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

Flags:​

  • -M, --pg-version=(11-17). => Versão majoritária do PostgreSQL a ser instalada. Será usada a release mais recente da versão escolhida.
  • -a, --agent=<value> => Alias, hostname ou IP do servidor onde um Agente do PgSmart está instalado.
  • -h, --help => Ajuda.
  • -q, --quiet => Execução não interativa para a instalação dos serviços. Usada em conjunto com as opções --service, --pgversion e --agent.
  • -s, --service=obs => Serviço de Observabilidade da Plataforma PostgreSYS.
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 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 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=obs
Terminal input
    pgsmart install --service=obs --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