intra-mart Accel Platform 設定ファイルリファレンス 第24版 2019-12-01

リクエスト制御設定

概要

リクエスト制御の設定です。
リクエストの同時処理制限やクエリの長さによるページ処理を制御する機能を提供します。

モジュール Webモジュール
フォーマットファイル(xsd) WEB-INF/schema/request-control-config.xsd
設定場所 WEB-INF/conf/request-control-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<request-control-config
    xmlns="http://intra-mart.co.jp/system/servlet/filter/xml/request_control/request-control-config"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://intra-mart.co.jp/system/servlet/filter/xml/request_control/request-control-config ../schema/request-control-config.xsd">
  <thread max="32"/>
  <accept queue="100">
    <query>
      <length max="0"/>
    </query>
  </accept>
  <synchronized queue="8">
    <query>
      <length min="1048576"/>
    </query>
  </synchronized>
</request-control-config>

リファレンス

サーバの同時処理の制限

タグ名 thread
サーバの同時処理制限を指定します。
制限数を超えるリクエストを受け付けた場合、制限数を超えたリクエストに関しては受け付け順にキューに溜められて処理待ちのステータスとして扱われます。
maxに 0 を指定するとリクエストの同時処理数を制限しません。

【設定項目】

<request-control-config>
  <thread max="32"/>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 サーバの同時処理制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ request-control-config

【属性】

属性名 説明 必須 デフォルト値
max サーバの最大同時処理数を設定します。 なし

リクエストの処理制限

タグ名 accept
サーバが受け付けたリクエストの処理制限を指定します。
同時処理数を超えた場合の処理待ちを行うリクエストの最大数やリクエストクエリの長さによる制限を行うことができます。

【設定項目】

<request-control-config>
  <accept queue="100">
    ...
  </accept>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 リクエストの処理制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ request-control-config

【属性】

属性名 説明 必須 デフォルト値
queue 処理待ちを行うリクエストの最大数を設定します。 なし

リクエストクエリの制限

タグ名 query
リクエストクエリの制限を指定します。
リクエストクエリに対する制限を行います。

【設定項目】

<request-control-config>
  <accept queue="100">
    <query>
      ...
    </query>
  </accept>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 リクエストクエリの制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ accept

リクエストクエリの長さ制限

タグ名 length
リクエストクエリの長さ制限を指定します。
リクエストクエリの長さがこの設定値よりも大きい場合は、HTTPレスポンスコード 413 が返却されます。
maxに 0 を指定するとリクエストクエリの長さによる制限を行いません。

【設定項目】

<request-control-config>
  <accept>
    <query>
      <length max="0"/>
        ...
      </length>
    </query>
  </accept>
<request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 リクエストクエリの長さ制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ query

【属性】

属性名 説明 必須 デフォルト値
max この設定値に指定された長さよりリクエストクエリの長さが小さいリクエストのみ処理を行います。 なし

リクエスト処理の直列化

タグ名 synchronized
クエリサイズの大きいリクエストの処理に関する制限を指定します。
サイズの大きいリクエストを処理する場合に、リソース不足によるエラーが発生しないように並列処理を行わないようにする設定です。
この設定を行うとサイズの大きいリクエストは受付順に直列処理されます。

【設定項目】

<request-control-config>
  <synchronized queue="8">
    ...
  </synchronized>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 リクエストの処理制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ request-control-config

【属性】

属性名 説明 必須 デフォルト値
queue 処理待ちを行うリクエストの最大数を設定します。 なし

直列処理を行うリクエストクエリの制限

タグ名 query
直列処理を行うリクエストのクエリの制限を指定します。
この設定値を基準に並列処理するリクエストと直列処理するリクエストを分けます。

【設定項目】

<request-control-config>
  <synchronized queue="8">
    <query>
      ...
    </query>
  </synchronized>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 直列処理を行うリクエストのクエリの制限を設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ synchronized

直列処理を行うリクエストクエリの長さ制限

タグ名 length
直列処理を行うリクエストのクエリの長さを指定します。
minに指定されたサイズよりリクエストクエリのサイズが小さいリクエストは並列処理され、大きいリクエストを直列処理されます。

【設定項目】

<request-control-config>
  <synchronized>
    <query>
      <length min="1048576"/>
    </query>
  </synchronized>
</request-control-config>

必須項目
複数設定 ×
設定値・設定する内容 直列処理を行うリクエストのクエリの長さを設定します。
単位・型 なし
省略時のデフォルト値 なし
親タグ query

【属性】

属性名 説明 必須 デフォルト値
min 直列処理を行うリクエストのクエリの長さを設定します。 なし