GitHub Support へのデータ提供

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

• Diagnosticファイルの作成と共有

  • Management ConsoleでのDiagnosticsファイルの作成
  • SSHを使ったDiagnosticsファイルの作成

• Support Bundleの作成と共有

  • Management ConsoleでのSupport Bundleの作成
  • SSHを使ったSupport Bundleの作成
  • SSHを使ったSupport Bundleの直接アップロード

• 拡張Support Bundleの作成と提供

  • SSHを使った拡張Support Bundleの作成
  • SSHを使った拡張Support Bundleの直接アップロード

Diagnosticファイルの作成と共有

Diagnostics は GitHub Enterprise Server インスタンスの設定と環境の概要であり、以下の内容が含まれます:

• 企業名、有効期限、シート数を含むクライアントライセンス情報
• バージョン番号及びSHA
• VMアーキテクチャ
• ホスト名、プライベートモード、SSLの設定
• 負荷及びプロセスのリスト
• ネットワーク設定
• 認証方式と詳細
• リポジトリ数、ユーザ数、その他のインストール関連データ

インスタンスのDiagnosticsはManagement Consoleから、あるいはghe-diagnosticsコマンドラインユーティリティを実行することでダウンロードできます。

Management ConsoleでのDiagnosticsファイルの作成

SSHキーがすぐに利用できない場合、この方法が使えます。

1. In the upper-right corner of any page, click .

   

2. 左サイドバーで [Management Console] をクリックします。

   

3. If prompted, type your Management Console password.

   

4. In the upper right of the Management Console, click Support.

   

5. 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 の作成と共有」を参照してください。

Management ConsoleでのSupport Bundleの作成

Web べースの Management Console と外部のインターネットにアクセスできる環境があれば、以下の手順で Support Bundle を作成して共有できます。

1. In the upper-right corner of any page, click .

   

2. 左サイドバーで [Management Console] をクリックします。

   

3. If prompted, type your Management Console password.

   

4. In the upper right of the Management Console, click Support.

   

5. [Download support bundle] (Support Bundle のダウンロード) をクリックします。

6. Visit https://enterprise.github.com/support and sign in (if prompted).

7. Visit https://enterprise.github.com/support/bundles/new and upload your support bundle.

SSHを使ったSupport Bundleの作成

GitHub Enterprise Server アプライアンスが SSH を利用でき、外部のインターネットにアクセスできる場合は、以下の手順で Support Bundle を作成して共有できます。

1. 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".

2. Visit https://enterprise.github.com/support and sign in (if prompted).

3. 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 接続ができること。

1. バンドルを当社の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を作成し、共有できます。

1. ghe-support-bundleコマンドに-xフラグを追加して、SSH経由で拡張Support Bundleをダウンロードしてください。

   $ ssh -p 122 admin@hostname -- 'ghe-support-bundle' -o -x > support-bundle.tgz

2. Visit https://enterprise.github.com/support and sign in (if prompted).

3. 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 接続ができること。

1. バンドルを当社のSupport Bundleサーバにアップロードします。

   $ ssh -p122 admin@hostname -- 'ghe-support-bundle -u -x'

参考リンク

• GitHub Enterprise Support について
• GitHub Enterprise ServerのGitHub Premium Supportについて