GitHub Support へのデータ提供
GitHub Support は顧客の環境にはアクセスできないので、追加情報をご提供いただかなければなりません。
ここには以下の内容があります:
Diagnosticファイルの作成と共有
Diagnostics は GitHub Enterprise Server インスタンスの設定と環境の概要であり、以下の内容が含まれます:
- 企業名、有効期限、シート数を含むクライアントライセンス情報
- バージョン番号及びSHA
- VMアーキテクチャ
- ホスト名、プライベートモード、SSLの設定
- 負荷及びプロセスのリスト
- ネットワーク設定
- 認証方式と詳細
- リポジトリ数、ユーザ数、その他のインストール関連データ
インスタンスのDiagnosticsはManagement Consoleから、あるいはghe-diagnostics
コマンドラインユーティリティを実行することでダウンロードできます。
Management ConsoleでのDiagnosticsファイルの作成
SSHキーがすぐに利用できない場合、この方法が使えます。
-
任意のページの右上で をクリックします。
-
左のサイドバーでManagement Consoleをクリックしてください。
-
求められたなら、Management Consoleのパスワードを入力してください。
-
Management Consoleの右上で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 を作成して共有できます。
-
任意のページの右上で をクリックします。
-
左のサイドバーでManagement Consoleをクリックしてください。
-
求められたなら、Management Consoleのパスワードを入力してください。
-
Management Consoleの右上でSupport(サポート)をクリックしてください。
-
[Download support bundle] (Support Bundle のダウンロード) をクリックします。
-
https://enterprise.github.com/support にアクセスし、サインインを求められた場合はサインインしてください。
-
https://enterprise.github.com/support/bundles/new にアクセスして Support Bundle をアップロードします。
SSHを使ったSupport Bundleの作成
GitHub Enterprise Server アプライアンスが SSH を利用でき、外部のインターネットにアクセスできる場合は、以下の手順で Support Bundle を作成して共有できます。
ノート:Geo-replication設定もしくはGitHub Enterpriseクラスタリングを利用しているなら、Support Bundleを取得するにはghe-cluster-support-bundle
コマンドを使わなければなりません。 詳しい情報については「コマンドラインユーティリティ」を参照してください。
-
SSH経由でSupport Bundleをダウンロードします。
$ ssh -p 122 admin@hostname -- 'ghe-support-bundle -o' > support-bundle.tgz
ghe-support-bundle
コマンドに関する詳しい情報については、「コマンドラインユーティリティ」を参照してください。 -
https://enterprise.github.com/support にアクセスし、サインインを求められた場合はサインインしてください。
-
https://enterprise.github.com/support/bundles/new にアクセスして 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
-
https://enterprise.github.com/support にアクセスし、サインインを求められた場合はサインインしてください。
-
https://enterprise.github.com/support/bundles/new にアクセスして 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'