グローバル レート制限を設定する
グローバル レート制限を使用すると、トラフィックを 2 つのカテゴリに分類し、それぞれに個別のレート制限を適用することで、インスタンスに到達するリクエストの量を制御できます。これにより、トラフィックが集中する期間中のインスタンスの安定性を保護します。
グローバル レート制限は、Confluence Data Center 10.2.13 以降でご利用になれます。バージョンを確認するには、[管理] メニュー > [一般設定] > [システム情報] の順に移動します。
グローバル レート制限がリクエストを分類する仕組み
グローバル レート制限は、すべての受信リクエストを 2 つのカテゴリに分類します。
リクエスト タイプ | 説明 |
|---|---|
自動化リクエスト | 統合、予定されたジョブ、背景 API の各リクエストを含む、自動化スクリプトやボットからのトラフィック。 |
アプリ リクエスト | ページ遷移、フォーム送信、 UI 主導のアクションを含む、ブラウザやモバイルでのインタラクションを通じてユーザーが生成したトラフィック。 |
自動化リクエストとアプリ リクエストは個別に設定されており、それぞれに独自の設定 UI があります。許可されるリクエストと最大リクエスト数の定義は、標準のレート制限と同じです。詳細は「レート制限でインスタンスの安定性を改善する」をご参照ください。
両方のセクションで、特定のユーザーやサービス アカウントをレート制限から除外できます。適用除外は、グローバル レート制限の設定をオーバーライドします。
サービス アカウントは Confluence に直接ログインできないため、アプリ リクエストの適用除外リストには表示されません。代わりに、自動化リクエスト セクションにサービス アカウントの適用除外を追加しましょう。
グローバル レート制限を有効化する方法
グローバル レート制限を有効化するには、次の手順に従います。
Confluence を停止します。
com.atlassian.ratelimiting.global-rate-limiter.enabledシステム プロパティを追加して、trueに設定します。-Dcom.atlassian.ratelimiting.global-rate-limiter.enabled=trueシステム プロパティの追加方法は、Confluence の実行方法によって異なります。詳細は「システム プロパティを設定する」をご参照ください。
Confluence を再起動します。
ユーザーがレート制限を受けた場合の動作
ユーザーがレート制限に達した場合の動作は、リクエスト タイプによって異なります。
自動化リクエスト: リクエストは HTTP 429 エラー (too many requests) で失敗します。
アプリ リクエスト: ユーザーに対して Confluence でレート制限エラーの通知が表示されます。
現在レート制限されているユーザーとサービス アカウントを確認するには、レート制限の設定ページに移動して [制限されたアカウントのリスト] タブを開きます。このリストは、クラスター全体におけるすべてのユーザーとサービス アカウントを対象としています。