Skip to main content

Configurar collectd

O GitHub Enterprise pode coletar dados com collectd e enviá-los para 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 collectd

Se você ainda não configurou um servidor externo collectd, será preciso fazê-lo antes de ativar o encaminhamento collectd na your GitHub Enterprise Server instance. Seu servidor collectd deve estar executando uma versão collectd 5.x ou superior.

  1. Faça login no servidor collectd.
  2. Crie ou edite o arquivo de configuração collectd para carregar o plugin de rede e preencher as diretivas de servidor e porta com os valores adequados. Na maioria das distribuições, esses dados ficam em /etc/collectd/collectd.conf

Exemplo de collectd.conf para executar um servidor collectd:

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

Habilitar o encaminhamento collectd no GitHub Enterprise

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

  1. From an administrative account on GitHub Enterprise Server, in the upper-right corner of any page, click .

    Screenshot of the rocket ship icon for accessing site admin settings

  2. If you're not already on the "Site admin" page, in the upper-left corner, click Site admin.

    Screenshot of "Site admin" link

  3. Na barra lateral esquerda, clique em Console de gerenciamento. Console de gerenciamento aba na barra lateral esquerda

  4. Abaixo das configurações de encaminhamento de log, selecione Enable collectd forwarding (Habilitar encaminhamento collectd).

  5. No campo Server address (Endereço do servidor), digite o endereço do servidor collectd para o qual você deseja encaminhar as estatísticas do appliance do GitHub Enterprise.

  6. No campo Port (Porta), digite a porta usada para conexão com o servidor collectd (o padrão é 25826).

  7. No menu suspenso Cryptographic setup (Configuração criptográfica), selecione o nível de segurança das comunicações com o servidor collectd (nenhum, pacotes assinados ou pacotes criptografados).

  8. Na barra lateral esquerda, clique Save settings (Salvar configurações).

    Screenshot of the save settings button in the Console de gerenciamento

    Note: Saving settings in the Console de gerenciamento restarts system services, which could result in user-visible downtime.

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

    Configurar a instância

Exportar dados coletados com ghe-export-graphs

A ferramenta de linha de comando ghe-export-graphs exportará os dados que collectd armazenar em bancos de dados RRD. Este comando transforma os dados em XML e os exporta em um único tarball (.tgz).

Seu uso principal é fornecer à equipe do GitHub Enterprise Support 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 GitHub Enterprise Support 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

GitHub Enterprise vem com a versão 5.x. de collectd. collectd 5.x não é retrocompatível com a série de versões 4.x. Seu servidor central collectd precisa ser da versão 5.x para aceitar os dados enviados pela your GitHub Enterprise Server instance.

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