監査ログ項目を期限切れにする

プラットフォームについて: Data Center のみ。 - この記事は、 Data Center プラットフォーム

この KB は Data Center バージョンの製品用に作成されています。Data Center 固有ではない機能の Data Center KB は、製品のサーバー バージョンでも動作する可能性はありますが、テストは行われていません。 Server* 製品のサポートは 2024 年 2 月 15 日に終了しました。Server 製品を実行している場合は、 アトラシアン Server サポート終了 のお知らせにアクセスして、移行オプションを確認してください。

*Fisheye および Crucible は除く

要約

大規模なインスタンスでは時間の経過とともに大量の監査ログが蓄積されて、Jira データベースのパフォーマンスに影響を与えてディスク容量を圧迫する可能性があります。このガイドでは、不要になった古い監査ログ項目を定期的に削除する方法について説明します。

ソリューション

監査ログの期限設定

Automation for Jira 3.12 以降の実行時に、グローバル管理者が監査ログの有効期限を設定できるようになりました。

グローバル設定」セクションに進んで監査ログの有効期限を希望の値にスライドさせ、監査ログの有効期限を有効にします。

「グローバル設定」セクションの許可リスト

[保存] を選択して完了します。そのスケジュールで監査ログの有効期限が切れるようになりました。

続行する前にご確認ください

監査ログ項目が多い場合、この操作はコストがかかり、データベースに余分な負荷をかける可能性があります。適切な時間を選択して最大実行時間を制限し、Jira インスタンスが最もビジーになりにくい時間 (週末など) にのみ有効期限が切れるようにしてください。

監査項目のバックログが大量にある場合はグローバル設定で監査ログの自動期限切れを設定する前に、スケジュールされたダウンタイム中に次のデータベースクエリによって最初にすべての監査項目を一括削除することをお勧めします。

データベースのアイテムを直接期限切れにする

これを誤って行うと、データが失われたり破損したりする可能性があります

これは破壊的なプロセスであり、正しく実行しないとデータが損失/破損する可能性があります。ロールバックが必要になった場合に備えて、バックアップを実行することをお勧めします。

この手順は、古いバージョンの Automation for Jira を利用している、またはスケジュールされたダウンタイム中に一括で削除する監査項目が多数ある場合にのみ必要です。

これは、テーブルを特定し、アイテムの数を確認して、最後に削除するという 3 つのステップで行います。この情報はキャッシュされないため、最後に Jira やアドオンを再起動する必要はありません。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 DELETE FROM "AO_589059_AUDIT_ITEM_ASC_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_CGE_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_COMP_CGE" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_PROJECT" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508';

まず、必要なテーブルの数を確認します。

1 2 3 4 5 SELECT count(*) FROM "AO_589059_AUDIT_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_ASC_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_CGE_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_COMP_CGE"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_PROJECT";
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 SELECT count(*) FROM "AO_589059_AUDIT_ITEM_ASC_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); SELECT count(*) FROM "AO_589059_AUDIT_ITEM_CGE_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); SELECT count(*) FROM "AO_589059_AUDIT_ITEM_COMP_CGE" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); SELECT count(*) FROM "AO_589059_AUDIT_ITEM_PROJECT" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); SELECT count(*) FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508';

このタイミングでバックアップすることをお勧めします。

次に、項目を削除します。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 DELETE FROM "AO_589059_AUDIT_ITEM_ASC_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_CGE_ITEM" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_COMP_CGE" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM_PROJECT" WHERE "AUDIT_ITEM_ID" IN (SELECT "ID" FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508'); DELETE FROM "AO_589059_AUDIT_ITEM" WHERE "CREATED" < '2016-09-12 07:20:17.508';

テーブルの新しい数を確認します。

1 2 3 4 5 SELECT count(*) FROM "AO_589059_AUDIT_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_ASC_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_CGE_ITEM"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_COMP_CGE"; SELECT count(*) FROM "AO_589059_AUDIT_ITEM_PROJECT";

更新日時: 2024年05月31日)

さらにヘルプが必要ですか?

アトラシアン コミュニティをご利用ください。