Skip to main content
Publicamos atualizações frequentes em nossa documentação, e a tradução desta página ainda pode estar em andamento. Para obter as informações mais atualizadas, acesse a documentação em inglês.
All products
Administradores da empresa

Configurar collectd

Neste artigo

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 sua instância do GitHub Enterprise Server. 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 .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site. 1. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

  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 "Configurações", clique em Salvar configurações.

    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.

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 sua instância do GitHub Enterprise Server.

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