サポート zip ファイルの作成

アトラシアン製品に問題がある場合は、サポート zip を作成すると解決に役立つ場合があります。サポート zip には インスタンスのログやシステムの診断情報、設定情報が含まれます。

このファイルをサポート チームに送付することで、アプリケーションの構成方法を理解し、問題を効率的にトラブルシューティングできるようになります。サポート zip の共有は任意ですが、アトラシアン サポートに貴重な情報を提供し、通常トラブルシューティングの時間を短縮します。

サポート zip は、アトラシアンのトラブルシューティングをサポートツール (ATST) アプリを使用して作成できます。アトラシアンのトラブルシューティングとサポート ツールについて詳細を確認する

サポート zip ファイルを作成する

サポート zip を作成するには:

1. アトラシアン製品内で、トラブルシューティングとサポート ツールを開きます。トラブルシューティングとサポート ツールにアクセスする方法を確認する

2. [サポート ZIP を作成する] タブに移動し、サポート zip の内容をカスタマイズします。サポート zip の内容をカスタマイズする方法を確認する

3. zip をダウンロードします。インスタンスがクラスタ化されている場合、利用可能なすべてのクラスタ ノードが一覧表示されます。1 つのノードで zip を作成することも、複数ノードの zipをダウンロードすることもできます。 

1. zip ファイルの中身を確認します。

2. zip ファイルの中身をカスタマイズします。

3. このノードで新しいサポート zip を作成します。

zip ファイルのコンテンツをカスタマイズする

デフォルトでは、サポート zip には以下が含まれます。

• スレッドダンプと Tomcat アクセス ログを除く、すべてのファイル タイプ

• 1 ファイルあたり 100 MB の制限

• 過去 5 日間に変更されたログ ファイル

各サポート zip の中身をカスタマイズすることもできます。

1. ファイル更新日 (ログ ファイルのみ): 選択した期間内に最後に更新されたログファイルを含みます。

   ファイル更新日 は Jira のデフォルトのタイムゾーンである協定世界時 (UTC) で定義されます。タイムゾーンが異なる場合には、エクスポートされるファイルの数に影響します。

   例えば、今日 更新されたログをエクスポートしたくて、現在時刻が午前 1 時 UTC の場合は、過去 1 時間以内に更新されたログのみを取得します。

   ファイル更新日オプションには、以下があります。

   • 指定なし: 利用可能なログファイルがすべて zip に含まれます。

   • 今日: UTCの 00:00 以降に編集されたログファイル (0～1 日分)。

   • 過去 3 日間 : 本日より 3 日前、UTC 00:00 以降に編集されたログファイル (3-4 日分のデータ)

   • 過去 5 日間 : 本日より 5 日前、 UTC 00:00 以降に 編集された ログファイル (5-6 日分のデータ)

   • 過去 10 日間 : 本日より 10 日前、 UTC 00:00 以降に 編集された ログファイル (10-11 日分のデータ)

2. 最大ファイル サイズ: エクスポートされる各ファイルのサイズを制限します。サイズ制限を設定すると、制限を超えるサイズのファイルは部分的にエクスポートされます (切り捨てられます)。Jira は各ファイルからデータの収集を開始し、最新のエントリから制限に達するまで収集します。

   ファイル サイズのオプションには、以下があります。

   • 制限なし: 選択したすべてのファイルが完全にエクスポートされます。

   • 1 ファイルあたり 25 MB の制限

   • 1 ファイルあたり 100 MB

   • 1 ファイルあたり 500 MB の制限

     ファイル サイズの制限は、ランタイム診断データ (Java Flight Recorder ファイル) と Tomcat ログには適用されません。これらのファイルは常に完全にエクスポートされます。

     X.X バージョンから、Tomcat のアクセスログを最新の 5 つのファイルに制限しなくなりました。これらのファイルは 1 日に 1 回作成されるため、新しいファイル更新日オプションを使用することで、エクスポートされるログの数を減らすことができます。

3. ファイル タイプ: サポート zip にすべてのファイルを追加するか、エクスポートしたい特定のファイルを選択します。

Jira のカスタマイズオプションの例:

zip を作成すると、カスタマイズ設定が自動保存され、インスタンス全体で共有されます。ページをリロードしたり閉じたりしても、この情報はプラグインのストレージに保持されます。

REST API を使ってサポート zip を作成する

REST API を使用してサポート zip を作成する場合は、以下のガイドを参照してください。

• データセンター アプリケーションで REST API を使用してサポート zip を作成する

• サーバー アプリケーションで REST API を使用してサポート zip を作成する

サポート zip に含まれるファイル

サポート zip に含まれる内容の概要は、次のとおりです。製品によって若干異なります。

SELECT BANDANAID, BANDANACONTEXT, BANDANAKEY, BANDANAVALUE
FROM BANDANA
WHERE BANDANAKEY IN ('plugin.manager.state.Map','atlassian.confluence.settings');

SELECT PLUGINDATAID, PLUGINKEY, FILENAME, LASTMODDATE
FROM PLUGINDATA;

SELECT CONFVERSIONID, BUILDNUMBER, INSTALLDATE, VERSIONTAG, FINALIZED, CREATIONDATE, LASTMODDATE
FROM CONFVERSION;

SELECT pluginkey, pluginenabled
FROM pluginstate;

SELECT id, pluginname, pluginkey, pluginversion, created
FROM pluginversion;