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.
- Faça logon no servidor do
collectd
. - 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
:
-
Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .
-
Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.
-
Na barra lateral " Administrador do site", clique em Console de Gerenciamento .
-
Abaixo das configurações de encaminhamento de log, selecione Habilitar encaminhamento do collectd.
-
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. -
No campo Porta, digite a porta usada para se conectar ao servidor do
collectd
. (o padrão é 25826). -
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.
-
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.