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

外部 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をクリックしてください。
   
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（設定の保存）をクリックしてください。
   
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までお問い合わせください。