Olá! No momento, esta página ainda está sendo desenvolvida ou traduzida. Para obter as informações mais recentes, acesse a documentação em inglês.
Versão do artigo: Enterprise Server 2.15

Esta versão do GitHub Enterprise será descontinuada em Esta versão do GitHub Enterprise foi descontinuada em 2019-10-16. 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.

Monitorar usando SNMP

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

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.

    Field to add the community string

  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

This should return the system time on sua instância do GitHub Enterprise Server host.

User-based security

If you enable SNMP v3, you can take advantage of increased user based security through the User Security Model (USM). For each unique user, you can specify a security level:

Configuring users for 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. Select SNMP v3.

    Button to enable SNMP v3

  6. In "Username", type the unique username of your SNMP v3 user.

    Field to type the SNMP v3 username

  7. In the Security Level dropdown menu, click the security level for your SNMP v3 user.

    Dropdown menu for the SNMP v3 user's security level

  8. For SNMP v3 users with the authnopriv security level:

    Settings for the authnopriv security level

    • 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. For SNMP v3 users with the authpriv security level:

    Settings for the authpriv security level

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

    • Optionally, in "Privacy password", type the privacy password.

    • On the right side of "Privacy password", in the Protocol dropdown menu, click the privacy protocol method you want to use.

  10. Click Add user.

    Button to add SNMP v3 user

  11. Under the left sidebar, click Save settings.

    Botão Save settings (Salvar configurações)

Querying SNMP data

Both hardware and software-level information about your appliance is available with SNMP v3. Due to the lack of encryption and privacy for the noAuthNoPriv and authNoPriv security levels, we exclude the hrSWRun table (1.1.3.6.1.2.1.25.41) from the resulting SNMP reports. We include this table if you're using the authPriv security level.

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. Several MIBs are available, which you can see by running snmpwalk on a separate workstation with SNMP support in your network:

# community-string is your community string
# hostname is the IP or domain of your Enterprise instance
$ 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:

Nome OID Descrição
hrSystemDate.2 .1.3.6.1.2.1.25.1.2 A noção dos hosts de data e hora locais de um dia.
hrSystemUptime.0 .1.3.6.1.2.1.25.1.1.0 Tempo transcorrido desde a última inicialização do host.
hrMemorySize.0 .1.3.6.1.2.1.25.2.2.0 Quantidade de RAM no host.
hrSystemProcesses.0 .1.3.6.1.2.1.25.1.6.0 Nú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.1 Quantidade de espaço de armazenamento consumido no host, em hrStorageAllocationUnits.
hrStorageAllocationUnits.1 .1.3.6.1.2.1.25.2.3.1.4.1 Tamanho 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