Skip to main content

Configurar collectd

O GitHub Enterprise pode coletar dados com collectd e enviá-los a um servidor externo collectd. Reunimos um conjunto padrão de dados e outras métricas, como uso de CPU, consumo de memória e disco, tráfego e erros da interface de rede e carga geral da VM.

Configurar um servidor externo do collectd

Se você ainda não tiver configurado um servidor externo do collectd, precisará fazer isso antes de habilitar o encaminhamento do collectd no your GitHub Enterprise Server instance. O servidor do collectd precisa executar o collectd versão 5.x ou superior.

  1. Faça logon no servidor do collectd.
  2. Crie ou edite o arquivo de configuração collectd para carregar o plug-in de rede e preencher as diretivas de servidor e porta com os valores adequados. Na maioria das distribuições, isso está localizado em /etc/collectd/collectd.conf

Um exemplo de collectd.conf para executar um servidor do collectd:

LoadPlugin network
...
...
<Plugin network>
    Listen "0.0.0.0" "25826"
</Plugin>

Habilitar o encaminhamento collectd no GitHub Enterprise

Por padrão, o encaminhamento do collectd está desabilitado no GitHub Enterprise. Siga as etapas abaixo para habilitar e configurar o encaminhamento do collectd:

  1. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

    Captura de tela do ícone de foguete para acesso às configurações de administração do site

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

    Captura de tela do link "Administração do site" 1. Na barra lateral à esquerda, clique em Console de Gerenciamento . Guia Console de Gerenciamento na barra lateral esquerda

  3. Abaixo das configurações de encaminhamento de log, selecione Habilitar encaminhamento do collectd.

  4. No campo Endereço do servidor, digite o endereço do servidor do collectd para o qual deseja encaminhar as estatísticas do dispositivo do GitHub Enterprise.

  5. No campo Porta, digite a porta usada para se conectar ao servidor do collectd. (o padrão é 25826).

  6. No menu suspenso Configuração de criptografia, selecione o nível de segurança de comunicações com o servidor do collectd. (Nenhum, pacotes assinados ou pacotes criptografados).1. Na barra lateral esquerda, clique em Salvar configurações.

    Captura de tela do botão Salvar configurações no Console de Gerenciamento

    Observação: se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  7. Aguarde a conclusão da execução de suas configurações.

    Configurar a instância

Como exportar os dados do collectd com ghe-export-graphs

A ferramenta de linha de comando ghe-export-graphs exportará os dados que o collectd armazena em bancos de dados RRD. Esse comando transforma os dados em XML e os exporta em um só tarball (.tgz).

Seu uso principal é fornecer à equipe do Suporte do GitHub Enterprise dados sobre o desempenho de uma VM sem que seja necessário baixar um pacote de suporte completo. Ele não deve ser incluído nas exportações de backup regulares e não há contrapartida de importação. Se você entrar em contato com o Suporte do GitHub Enterprise para fins de solução de problemas, esses dados podem ser solicitados.

Uso

ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .

Solução de problemas

Central do servidor collectd não recebe dados

O GitHub Enterprise é fornecido com o collectd versão 5.x. O collectd 5.x não é compatível com versões anteriores da série de versões 4.x. Seu servidor central do collectd precisa ter, no mínimo, a versão 5.x para aceitar dados enviados do your GitHub Enterprise Server instance.

Em caso de dúvidas ou perguntas, entre em contato com o Suporte do GitHub Enterprise.