ドキュメントには頻繁に更新が加えられ、その都度公開されています。本ページの翻訳はまだ未完成な部分があることをご了承ください。最新の情報については、英語のドキュメンテーションをご参照ください。本ページの翻訳に問題がある場合はこちらまでご連絡ください。
記事のバージョン: Enterprise Server 2.15

このバージョンの GitHub Enterprise はこの日付をもって終了となります: このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2019-10-16. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 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.

SNMP での監視

GitHub Enterpriseは、SNMP経由でディスクの使用や CPU の使用率、メモリーの使用などのデータを提供します。

SNMP とは、ネットワーク経由でデバイスを監視するための一般的基準です。 GitHub Enterprise Server インスタンスのj状態を監視可能にし、いつホストのマシンにメモリやストレージ、処理能力を追加すべきかを知るために、SNMP を有効にすることを強くおすすめします。

GitHub Enterprise には標準の SNMP がインストールされているので、Nagios などのモニタリングシステムに対して利用可能な数多くのプラグインを活用できます。

SNMP v2c を設定

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

    サイトアドミン設定にアクセスするための宇宙船のアイコン

  2. 左サイドバーで [Management Console] をクリックします。

    左サイドバーの Management Console タブ

  3. In the left sidebar, click Monitoring.

    Monitoring tab

  4. Under "Monitoring", select Enable SNMP.

    Button to enable SNMP

  5. Community string の欄では、新しいコミュニティ文字列を入力する。 空白のままだと、publicという設定になります。

    Field to add the community string

  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:

Configuring users for SNMP v3

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

    サイトアドミン設定にアクセスするための宇宙船のアイコン

  2. 左サイドバーで [Management Console] をクリックします。

    左サイドバーの Management Console タブ

  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

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

    Settings for 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.

    Button to add SNMP v3 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 のいくつかの重要なオブジェクトについては、以下の表を参照してください:

名前 OID 説明
hrSystemDate.2 .1.3.6.1.2.1.25.1.2 ホストから見たローカルの日付と時間。
hrSystemUptime.0 .1.3.6.1.2.1.25.1.1.0 前回ホストが起動してからの時間。
hrMemorySize.0 .1.3.6.1.2.1.25.2.2.0 ホストが持っているRAMの容量。
hrSystemProcesses.0 .1.3.6.1.2.1.25.1.6.0 現在、ホストでロードされている、または作動しているプロセスのコンテキストの数。
hrStorageUsed.1 .1.3.6.1.2.1.25.2.3.1.6.1 hrStorageAllocationUnits のホストの使用ストレージ領域。
hrStorageAllocationUnits.1 .1.3.6.1.2.1.25.2.3.1.4.1 hrStorageAllocationUnit のバイトでのサイズ

たとえば、SNMP v3 で hrMemorySize を照会するには、ネットワークで SNMP をサポートしている別のワークステーションで次のコマンドを実行します:

# username はあなたの SNMP v3 ユーザの一意のユーザ名
# auth password は認証パスワード
# privacy password はプライバシーパスワード
# hostname はあなたの Enterprise インスタンスの IP またはドメイン
$ 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 はあなたのコミュニティ文字列
# hostname はあなたの Enterprise インスタンスの IP またはドメイン
snmpget -v 2c -c community-string hostname HOST-RESOURCES-MIB::hrMemorySize.0

メモ: アプライアンスで実行中のサービスに関する情報の漏洩を防ぐために、SNMP v3 でセキュリティレベル authPriv を使用していない限り、結果の SNMP レポートから hrSWRun の表 (1.1.3.6.1.2.1.25.41) は除外されます。 セキュリティレベル authPriv を使用している場合は、hrSWRun の表が掲載されます。

SNMP での一般的なシステム属性に対する OID マッピングの詳しい情報については、「CPU、メモリ、ディスクの統計情報に対する Linux SNMP OID」を参照してください。

担当者にお尋ねください

探しているものが見つからなかったでしょうか?

弊社にお問い合わせください