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 recentes, acesse a documentação em inglês. Se houver problemas com a tradução desta página, entre em contato conosco.

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2020-05-23. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Versão do artigo: Enterprise Server 2.17

Monitorar usando SNMP

O GitHub Enterprise fornece dados sobre o uso de disco, CPU, memória e muito mais no SNMP.

Neste artigo

O SNMP é um padrão comum para monitorar dispositivos em uma rede. É altamente recomendável ativar o SNMP para monitorar a integridade da sua instância do GitHub Enterprise Server e saber quando adicionar mais memória, armazenamento ou potência do processador à máquina host.

O GitHub Enterprise tem uma instalação SNMP padrão que permite aproveitar vários plugins disponíveis para Nagios ou qualquer outro sistema de monitoramento.

Configurar SMTP v2c

  1. In the upper-right corner of any page, click .
    Ícone de foguete para acessar as configurações de administrador do site
  2. In the left sidebar, click Console de gerenciamento.
    Console de gerenciamento tab in the left sidebar
  3. In the left sidebar, click Monitoring.
    Monitoring tab
  4. Under "Monitoring", select Enable SNMP.
    Button to enable SNMP
  5. No campo Community string (String de comunidade), insira a nova string da comunidade. Se deixada em branco, essa informação fica como public por padrão.
    Campo para adicionar a string da comunidade
  6. Under the left sidebar, click Save settings.
    Botão Save settings (Salvar configurações)
  7. Teste a configuração SNMP executando o seguinte comando em uma estação de trabalho separada com suporte a SNMP na rede:
    # community-string is your community string
    # hostname is the IP or domain of your Enterprise instance
    $ snmpget -v 2c -c community-string -O e hostname hrSystemDate.0

Isso deve retornar o horário do sistema no host do sua instância do GitHub Enterprise Server.

Segurança baseada no usuário

Se habilitar o SNMP v3, você poderá aproveitar o aumento da segurança baseada no usuário por meio do User Security Model (USM). É possível especificar um nível de segurança para cada usuário:

  • noAuthNoPriv: este nível de segurança não oferece autenticação nem privacidade.
  • authNoPriv: este nível de segurança oferece autenticação, mas não privacidade. Para consultar o appliance, você precisará de nome de usuário e senha (com pelo menos oito caracteres). As informações são enviadas sem criptografia, de modo semelhante ao SNMPv2. O protocolo de autenticação pode ser MD5 ou SHA, e o padrão é SHA.
  • authPriv: este nível de segurança oferece autenticação e privacidade. A autenticação (com senha de no mínimo oito caracteres) é necessária, e as respostas são criptografadas. Não é necessário usar uma senha de privacidade, mas, se houver, ela deve ter no mínimo oito caracteres. Se não houver senha de privacidade, a senha de autenticação será usada. O protocolo de privacidade pode ser DES ou AES, e o padrão é AES.

Configurar usuários para o SNMP v3

  1. In the upper-right corner of any page, click .
    Ícone de foguete para acessar as configurações de administrador do site
  2. In the left sidebar, click Console de gerenciamento.
    Console de gerenciamento tab in the left sidebar
  3. In the left sidebar, click Monitoring.
    Monitoring tab
  4. Under "Monitoring", select Enable SNMP.
    Button to enable SNMP
  5. Selecione SNMP v3.
    Botão para habilitar o SNMP v3
  6. Em "Username" (Nome de usuário), digite o nome exclusivo do seu usuário SNMP v3.
    Campo para digitar o nome de usuário SNMP v3
  7. No menu suspenso Security Level (Nível de segurança), clique no nível de segurança do seu usuário SNMP v3.
    Menu suspenso para o nível de segurança do usuário SNMP v3
  8. Para usuários SNMP v3 com nível de segurança authnopriv:
    Configurações para o nível de segurança authnopriv
    • Em "Authentication password" (Senha de autenticação), digite a senha de autenticação.
    • On the right side of "Authentication password", in the Protocol dropdown menu, click the authentication protocol you want to use.
  9. Para usuários SNMP v3 com nível de segurança authpriv:
    Configurações para o nível de segurança authpriv
    • Em "Authentication password" (Senha de autenticação), digite a senha de autenticação.
    • On the right side of "Authentication password", in the Protocol dropdown menu, click the authentication protocol you want to use.
    • Como alternativa, em "Privacy password" (senha de privacidade), digite a senha de privacidade.
    • No lado direito de "Privacy password" (Senha de privacidade), no menu suspenso Protocol (Protocolo), clique no protocolo de privacidade que você deseja usar.
  10. Clique em Add user (Adicionar usuário).
    Botão para adicionar usuário SNMP v3
  11. Under the left sidebar, click Save settings.
    Botão Save settings (Salvar configurações)
Consultar dados SNMP

As informações de hardware e software do appliance estão disponíveis no SNMP v3. Devido à falta de criptografia e privacidade para os níveis de segurança noAuthNoPriv e authNoPriv, a tabela hrSWRun (1.1.3.6.1.2.1.25.41) foi excluída dos relatórios SNMP resultantes. Incluímos esta tabela para o caso de você estar usando o nível de segurança authPriv.

Com o SNMP v2c, ficam disponíveis somente as informações em nível de hardware. Os aplicativos e serviços no GitHub Enterprise não têm OIDs configurados para reportar métricas. Diversas MIBs estão disponíveis, o que pode ser visto ao executar snmpwalk em uma estação de trabalho à parte com suporte SNMP na rede:

# community-string é a string de sua comunidade
# hostname é o IP ou domínio da sua instância Enterprise
$ snmpwalk -v 2c -c community-string -O e hostname

Das MIBs disponíveis para SNMP, a mais útil é a HOST-RESOURCES-MIB (.1.3.6.1.2.1.25). Consulte a tabela a seguir para ver objetos importantes dessa MIB:

NomeOIDDescrição
hrSystemDate.2.1.3.6.1.2.1.25.1.2A noção dos hosts de data e hora locais de um dia.
hrSystemUptime.0.1.3.6.1.2.1.25.1.1.0Tempo transcorrido desde a última inicialização do host.
hrMemorySize.0.1.3.6.1.2.1.25.2.2.0Quantidade de RAM no host.
hrSystemProcesses.0.1.3.6.1.2.1.25.1.6.0Número de contextos de processo carregados ou em execução no host.
hrStorageUsed.1.1.3.6.1.2.1.25.2.3.1.6.1Quantidade de espaço de armazenamento consumido no host, em hrStorageAllocationUnits.
hrStorageAllocationUnits.1.1.3.6.1.2.1.25.2.3.1.4.1Tamanho em bytes de um hrStorageAllocationUnit.

Por exemplo, para consultar hrMemorySize com SNMP v3, execute o seguinte comando em outra estação de trabalho com suporte a SNMP na sua rede:

# username é o nome exclusivo do seu usuário do SNMP v3
# auth password é a senha de autenticação
# privacy password é a senha de privacidade
# hostname é o IP ou domínio da sua instância do Enterprise
$ snmpget -v 3 -u username -l authPriv \
  -A "auth password" -a SHA \
  -X "privacy password" -x AES \
  -O e hostname HOST-RESOURCES-MIB::hrMemorySize.0

Para consultar hrMemorySize com SNMP v2c, execute o seguinte comando em outra estação de trabalho com suporte a SNMP na sua rede:

# community-string é a string da sua comunidade
# hostname é o IP ou domínio da sua instância do Enterprise
snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0

Observação: para evitar o vazamento de informações sobre os serviços em execução no seu appliance, a tabela hrSWRun (1.1.3.6.1.2.1.25.41) foi excluída dos relatórios SNMP resultantes, a menos que você esteja usando o nível de segurança authPriv com SNMP v3. Incluímos a tabela hrSWRun para o caso de você estar usando o nível de segurança authPriv.

Para obter mais informações sobre mapeamentos OID para atributos comuns do sistema no SNMP, consulte "OID de SNMP do Linux para estatísticas de CPU, memória e disco".

Pergunte a uma pessoa

Não consegue encontrar o que procura?

Entrar em contato