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 saber mais, confira Sobre o painel do monitor.

Você pode revisar uma lista das métricas que o collectd reúne no sua instância do GitHub Enterprise Server. Para saber mais, 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.

    Note

    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.