GitHub Support へのデータ提供
GitHub Support は顧客の環境にはアクセスできないので、追加情報をご提供いただかなければなりません。
ここには以下の内容があります:
Diagnosticファイルの作成と共有
Diagnostics は GitHub Enterprise Server インスタンスの設定と環境の概要であり、以下の内容が含まれます:
- 企業名、有効期限、シート数を含むクライアントライセンス情報
- バージョン番号及びSHA
- VMアーキテクチャ
- ホスト名、プライベートモード、SSLの設定
- 負荷及びプロセスのリスト
- ネットワーク設定
- 認証方式と詳細
- リポジトリ数、ユーザ数、その他のインストール関連データ
インスタンスのDiagnosticsはManagement Consoleから、あるいはghe-diagnostics
コマンドラインユーティリティを実行することでダウンロードできます。
Management ConsoleでのDiagnosticsファイルの作成
SSHキーがすぐに利用できない場合、この方法が使えます。
-
In the upper-right corner of any page, click .
-
左サイドバーで [Management Console] をクリックします。
-
If prompted, type your Management Console password.
-
In the upper right of the Management Console, click Support.
-
Download diagnostics info(Diagnostic情報のダウンロード)をクリックしてください。
SSHを使ったDiagnosticsファイルの作成
この方法は、Management Console にサインインせずに利用できます。
ghe-diagnostics コマンドラインユーティリティを使ってインスタンスの Diagnostics を取得してください。
$ ssh -p122 admin@hostname -- 'ghe-diagnostics' > diagnostics.txt
Support Bundleの作成と共有
サポートリクエストをサブミットした後、私たちのチームと Support Bundle の共有をお願いすることがあります。 Support Bundle は gzip 圧縮された tar アーカイブで、インスタンスの Diagnostics と以下のような重要なログが含まれます:
- 認証のエラーのトラブルシューティングやLDAP、CAS、SAMLの設定に役立つ認証関連のログ
- Management Consoleのログ
github-logs/exceptions.log
:サイトで生じた500エラーに関する情報github-logs/audit.log
: GitHub Enterprise Server 監査ログbabeld-logs/babeld.log
:Gitプロキシのログsystem-logs/haproxy.log
:HAProxyのログelasticsearch-logs/github-enterprise.log
:Elasticsearchのログconfiguration-logs/ghe-config.log
: GitHub Enterprise Server 設定ログcollectd/logs/collectd.log
:Collectdのログmail-logs/mail.log
:SMTPのメール配送ログhookshot-logs/exceptions.log
:webhookのデリバリエラー
詳細は「監査ログ」を参照してください。
Support Bundle には過去 2 日分のログが含まれます。 過去 7 日分のログを取得したい場合には、拡張 Support Bundle をダウンロードできます。 詳細は「拡張 Support Bundle の作成と共有」を参照してください。
参考: GitHub Support に連絡を取ると、チケットの参照リンクを含む確認のメールが送られてきます。 GitHub Support が Support Bundle のアップロードをお願いした場合、Support Bundle のアップロードにこのチケット参照リンクを利用できます。
Management ConsoleでのSupport Bundleの作成
Web べースの Management Console と外部のインターネットにアクセスできる環境があれば、以下の手順で Support Bundle を作成して共有できます。
-
In the upper-right corner of any page, click .
-
左サイドバーで [Management Console] をクリックします。
-
If prompted, type your Management Console password.
-
In the upper right of the Management Console, click Support.
-
[Download support bundle] (Support Bundle のダウンロード) をクリックします。
-
Visit https://enterprise.github.com/support and sign in (if prompted).
-
Visit https://enterprise.github.com/support/bundles/new and upload your support bundle.
SSHを使ったSupport Bundleの作成
GitHub Enterprise Server アプライアンスが SSH を利用でき、外部のインターネットにアクセスできる場合は、以下の手順で Support Bundle を作成して共有できます。
Note: If you are using a Geo-replication configuration, or GitHub Enterprise Clustering, you should use the ghe-cluster-support-bundle
command to retrieve the support bundle. For more information, see "Command-line utilities."
-
SSH経由でSupport Bundleをダウンロードします。
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle' -o > support-bundle.tgz
For more information about the
ghe-support-bundle
command, see "Command-line utilities". -
Visit https://enterprise.github.com/support and sign in (if prompted).
-
Visit https://enterprise.github.com/support/bundles/new and upload your support bundle.
SSHを使ったSupport Bundleの直接アップロード
以下の状況であれば、Support Bundleを当社のサーバに直接アップロードできます。
- GitHub Enterprise Server アプライアンスに SSH でアクセスできること。
- GitHub Enterprise Server アプライアンスから外部の TCP ポート 443 に HTTPS 接続ができること。
-
バンドルを当社のSupport Bundleサーバにアップロードします。
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u'
拡張Support Bundleの作成と提供
Support Bundleには過去2日分のログが含まれますが、_拡張_Support Bundleには過去7日分のログが含まれます。 GitHub Support が調査しているイベントが 2 日以上前に起きたのであれば、拡張Support Bundleの共有をお願いすることがあります。 拡張Support BundleのダウンロードにはSSHアクセスが必要です。拡張Support BundleをManagement Consoleからダウンロードすることはできません。
バンドルが大きくなりすぎるのを避けるために、バンドルにはローテーションや圧縮されていないログだけが含まれます。 GitHub Enterprise Server でのログのローテーションは、それぞれのログがどの程度の大きさになるかの予想に応じて、ログごとに様々な頻度 (日次あるいは週次) で行われます。
SSHを使った拡張Support Bundleの作成
GitHub Enterprise Server アプライアンスにSSHでアクセスでき、外部のインターネットへアクセスできるのであれば、以下の手順で拡張Support Bundleを作成し、共有できます。
-
ghe-support-bundle
コマンドに-x
フラグを追加して、SSH経由で拡張Support Bundleをダウンロードしてください。$ ssh -p 122 admin@hostname -- 'ghe-support-bundle' -o -x > support-bundle.tgz
-
Visit https://enterprise.github.com/support and sign in (if prompted).
-
Visit https://enterprise.github.com/support/bundles/new and upload your support bundle.
SSHを使った拡張Support Bundleの直接アップロード
以下の状況であれば、Support Bundleを当社のサーバに直接アップロードできます。
- GitHub Enterprise Server アプライアンスに SSH でアクセスできること。
- GitHub Enterprise Server アプライアンスから外部の TCP ポート 443 に HTTPS 接続ができること。
-
バンドルを当社のSupport Bundleサーバにアップロードします。
$ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'