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

外部 collectd サーバーを設置

GitHub Enterprise Serverのインスタンスに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. GitHub Enterprise Serverの管理アカウントから、任意のページの右上にあるをクリックしてください。
2. 左のサイドバーでManagement Consoleをクリックしてください。
3. ログの転送設定の下にある、Enable collectd forwarding を選択する
4. Server address の欄には GitHub Enterpriseのアプライアンスの統計を転送したいcollectd サーバのアドレスを入力する。
5. Portの欄には、collectd サーバーに接続するためのポートを入力する。 (デフォルトは 25826)
6. Cryptographic setup のドロップダウンメニューでは、collectd サーバーとのコミュニケーションのセキュリティーレベルを選択する。 （なし、署名付きパケット、または暗号化されたパケット。）
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 は、4.x リリースシリーズとの下位互換性がありません。 GitHub Enterprise Serverのインスタンスから送られるデータを受信するには、中心のcollectdサーバは 5.x 以上のバージョンでなければなりません。

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