使用 SNMP 进行监视

SNMP 是一种用于通过网络监视设备的公共标准。 强烈建议启用 SNMP，以便监视 您的 GitHub Enterprise Server 实例 的健康状态并了解何时向主机增加更多内存、存储空间或处理器能力。

GitHub Enterprise 采用标准 SNMP 安装，因此您可以充分利用 Nagios 或其他任何监视系统可用的多种插件。

配置 SNMP v2c

1. In the upper-right corner of any page, click .

   

2. 在左侧边栏中，单击 管理控制台。

   

3. In the left sidebar, click Monitoring.

   

4. Under "Monitoring", select Enable SNMP.

   

5. 在 Community string 字段中，输入新的社区字符串。 如果留空，此字段将默认为 public。

   

6. Under the left sidebar, click Save settings.

   

7. 要测试 SNMP 配置，请在网络中支持 SNMP 的单独工作站上运行以下命令：

   # 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 您的 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:

• noAuthNoPriv: This security level provides no authentication and no privacy.
• authNoPriv: This security level provides authentication but no privacy. 要查询设备，您需要用户名和密码（长度必须至少为八个字符）。 与 SNMPv2 相似，发送的信息不会进行加密。 身份验证协议可以是 MD5 或 SHA，默认为 SHA。
• authPriv: This security level provides authentication with privacy. 要求进行身份验证（包含一个长度至少为八个字符的身份验证密码），并且会对响应进行加密。 不需要隐私密码，但如果提供隐私密码，其长度必须至少为八个字符。 如果不提供隐私密码，将使用身份验证密码。 隐私协议可以是 DES 或 AES，默认为 AES。

Configuring users for SNMP v3

1. In the upper-right corner of any page, click .

   

2. 在左侧边栏中，单击 管理控制台。

   

3. In the left sidebar, click Monitoring.

   

4. Under "Monitoring", select Enable SNMP.

   

5. Select SNMP v3.

   

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

   

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

   

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

   

   • 在“Authentication password（身份验证密码）”中，键入身份验证密码。

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

   

   • 在“Authentication password（身份验证密码）”中，键入身份验证密码。

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

    

11. Under the left sidebar, click Save settings.

    

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.

如果使用 SNMP v2c，则仅会提供关于您的设备的硬件级信息。 GitHub Enterprise 中的应用程序和服务未配置 OID 来报告指标。 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

在 SNMP 的可用 MIB 中，最有用的是 HOST-RESOURCES-MIB (.1.3.6.1.2.1.25)。 请参见下表，了解此 MIB 中的一些重要对象：

例如，要通过 SNMP v3 查询 hrMemorySize，请在您的网络中支持 SNMP 的单独工作站上运行以下命令：

# username is the unique username of your SNMP v3 user
# auth password is the authentication password
# privacy password is the privacy password
# hostname is the IP or domain of your Enterprise instance
$ 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

如果使用 SNMP v2c，要查询 hrMemorySize，请在您的网络中支持 SNMP 的单独工作站上运行以下命令：

# community-string is your community string
# hostname is the IP or domain of your Enterprise instance
snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0

更多关于 SNMP 中常用系统属性的 OID 映射的信息，请参阅“CPU、内存和磁盘统计信息的 Linux SNMP OID”。