Configurando o collectd para sua instância

Para obter informações sobre o desempenho do GitHub Enterprise Server, você pode analisar os dados do collectd na sua instância ou, opcionalmente, enviar os dados para um servidor externo collectd.

Neste artigo

Sobre o collectd para GitHub Enterprise Server

O collectd é um serviço que é executado no sua instância do GitHub Enterprise Server para reunir e fornecer métricas sobre o desempenho do sistema. As métricas comuns coletadas pelo collectd incluem utilização da CPU, consumo de memória e disco, tráfego e erros da interface de rede e carga geral do sistema. Você também pode encaminhar os dados para outro servidor collectd. Para obter mais informações, consulte o wiki do collectd.

Sua instância usa métricas do collectd para exibir gráficos no painel do monitor do Console de Gerenciamento. Para obter mais informações, confira "Acessar o painel de monitoramento".

Você pode revisar uma lista das métricas que o collectd reúne no sua instância do GitHub Enterprise Server. Para obter mais informações, confira "métricas do collectd para o GitHub Enterprise Server".

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>

Habilitando o encaminhamento do 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.

  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

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

  5. 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.

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

  7. 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.

  8. 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 conosco por meio do Suporte do GitHub Enterprise, poderemos solicitar esses dados para ajudar na solução de problemas.

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.

Para obter ajuda com outras dúvidas ou problemas, acesse o Suporte do GitHub Enterprise.