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

このバージョンの GitHub Enterprise はこの日付をもって終了となりました: 2020-11-12. 重大なセキュリティの問題に対してであっても、パッチリリースは作成されません。 パフォーマンスの向上、セキュリティの改善、新機能のためには、最新バージョンのGitHub Enterpriseにアップグレードしてください。 アップグレードに関する支援については、GitHub Enterprise supportに連絡してください。

collectd のコンフィグレーション

GitHub Enterpriseは、collectd でデータを収集し、外部の collectd に送信することができます。 CPU の使用率やメモリーとディスクの消費、ネットワークインタフェーストラフィックとエラー、仮想マシンの全体的な負荷などのデータを収集しています。

ここには以下の内容があります:

外部 collectd サーバーを設置

your GitHub Enterprise Server instanceにcollectd の転送をまだ有効にしていない場合は、外部の collectd サーバを設置する必要があります。 collectd サーバは、collectd 5.x以上のバージョンを使わなければなりません。

  1. collectd サーバにログインする
  2. collectd を作成、または編集することで、ネットワークプラグインをロードし、適切な値をサーバとポートのディレクティブに追加する。 たいていのディストリビューションでは、これは /etc/collectd/collectd.conf にあります。

collectd サーバを実行するための見本のcollectd.conf

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

GitHub Enterpriseでcollectd転送を有効にする

デフォルトでは、collectd 転送は GitHub Enterprise で無効になっています。 次の手順に従って、collectd 転送を有効にして設定します。

  1. From an administrative account on GitHub Enterprise Server, click in the upper-right corner of any page.
    サイトアドミン設定にアクセスするための宇宙船のアイコン
  2. 左のサイドバーでManagement Consoleをクリックしてください。
    左のサイドバーのManagement Consoleタブ
  3. ログの転送設定の下にある、Enable collectd forwarding を選択する
  4. Server address の欄には GitHub Enterpriseのアプライアンスの統計を転送したいcollectd サーバのアドレスを入力する。
  5. Portの欄には、collectd サーバーに接続するためのポートを入力する。 (デフォルトは 25826)
  6. Cryptographic setup のドロップダウンメニューでは、collectd サーバーとのコミュニケーションのセキュリティーレベルを選択する。 (None, signed packets, or encrypted packets.)
  7. 左のサイドバーの下でSave settings(設定の保存)をクリックしてください。
    Management Console での [Save settings] ボタン
  8. 設定が完了するのを待ってください。

collectd データの ghe-export-graphsでのエクスポート

ghe-export-graphs のコマンドラインツールは、collectd が RRD データベースに保存するデータをエクスポートします。 このコマンドは、データを XML にして、1つのTAR書庫(.tgz)にエクスポートします。

その主な用途は、Support Bundleを一括ダウンロードする必要なく、GitHub Enterprise Support または GitHub Premium Supportのチームに仮想マシンのパフォーマンスに関するデータ提供することです。 定期的なバックアップエクスポートに含めてはなりません。また、その逆のインポートもありません。 GitHub Enterprise Support または GitHub Premium Supportに連絡したとき、問題解決を容易にするため、このデータが必要となる場合があります。

使い方

ssh -p 122 admin@[hostname] -- 'ghe-export-graphs' && scp -P 122 admin@[hostname]:~/graphs.tar.gz .

トラブルシューティング

中心の collectd サーバはデータを受信していない

GitHub Enterprise は collectd バージョン 5.x に付属しています。 collectd 5.x is not backwards compatible with the 4.x release series. your GitHub Enterprise Server instanceから送られるデータを受信するには、中心のcollectdサーバは 5.x 以上のバージョンでなければなりません。

他に質問や問題がある場合、GitHub Enterprise Support または GitHub Premium Supportまでお問い合わせください。