[PaaS のみ]{class="badge informative" title="Adobe Commerce on Cloud プロジェクト（Adobeが管理する PaaS インフラストラクチャ）およびオンプレミスプロジェクトにのみ適用されます。"}

Redis サービス設定のベストプラクティス

Redis L2 キャッシュの設定

REDIS_BACKEND 設定ファイルの .magento.env.yaml デプロイメント変数を設定して、Redis L2 キャッシュを設定します。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'

クラウドインフラストラクチャー上の環境設定については、REDIS_BACKEND クラウドインフラストラクチャー上のCommerceガイドの __ を参照してください。

オンプレミスのインストールの場合は、 設定ガイドの Redis ページ キャッシュの設定 を参照してください。

L2 キャッシュメモリのサイズ設定（Adobe Commerce Cloud）

L2 キャッシュは、ストレージ メカニズムとして 一時ファイル システムを使用します。 特殊なキー値データベースシステムと比較して、一時ファイルシステムには、メモリの使用を制御するためのキー削除ポリシーがありません。

メモリ使用量の制御がないと、古くなったキャッシュが蓄積され、L2 キャッシュのメモリ使用量が時間の経過とともに増加する可能性があります。

L2 キャッシュ実装のメモリ不足を避けるために、Adobe Commerceは、特定のしきい値に達するとストレージをクリアします。 デフォルトのしきい値は 95% です。

キャッシュストレージのプロジェクト要件に基づいて、L2 キャッシュメモリの最大使用量を調整することが重要です。 次のいずれかの方法を使用して、メモリキャッシュサイズを設定します。

次のコードは、.magento.env.yaml ファイルの設定例を示しています。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            cleanup_percentage: 90

キャッシュ要件は、プロジェクト設定とカスタムサードパーティコードによって異なる場合があります。 L2 キャッシュ メモリ サイズのスコープにより、しきい値のヒット数が多くなりすぎることなく、L2 キャッシュを動作させることができます。
ストレージのクリアが頻繁に行われるのを避けるために、L2 キャッシュメモリの使用状況が、しきい値を下回る一定のレベルで安定していることが理想的です。

以下の CLI コマンドを使用してクラスターの各ノードでの L2 キャッシュストレージメモリの使用状況を確認し、/dev/shm 行を探すことができます。
使用方法はノードによって異なる場合がありますが、同じ値に収束する必要があります。

df -h

Redis スレーブ接続を有効にする

.magento.env.yaml 設定ファイルの Redis スレーブ接続を有効にして、1 つのノードだけが読み取り/書き込みトラフィックを処理し、他のノードが読み取り専用トラフィックを処理できるようにします。

stage:
  deploy:
    REDIS_USE_SLAVE_CONNECTION: true

2}Cloud Infrastructure ガイドのCommerceREDIS_USE_SLAVE_CONNECTION} を参照してください __

Adobe Commerce オンプレミスのインストールの場合は、bin/magento:setup コマンドを使用して新しい Redis キャッシュ実装を設定します。 設定ガイドの デフォルトキャッシュに Redis を使用 を参照してください。

キーをプリロード

ページ間でデータを再利用するには、プリロードのキーを .magento.env.yaml 設定ファイルにリストします。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          id_prefix: '061_'                       # Prefix for keys to be preloaded
          backend_options:
            preload_keys:                         # List the keys to be preloaded
              - '061_EAV_ENTITY_TYPES:hash'
              - '061_GLOBAL_PLUGIN_LIST:hash'
              - '061_DB_IS_UP_TO_DATE:hash'
              - '061_SYSTEM_DEFAULT:hash'

オンプレミスのインストールについては、 設定ガイドの Redis プリロード機能 を参照してください。

古いキャッシュを有効にする

新しいキャッシュを並行して生成しながら古いキャッシュを使用することで、特に多数のブロックとキャッシュキーを処理する場合に、ロックの待機時間を短縮し、パフォーマンスを向上させます。 古いキャッシュを有効にして、config.php 設定ファイルでキャッシュタイプを定義する（クラウドのみ）:

'cache' => [
        'frontend' => [
            'stale_cache_enabled' => [
                'backend' => '\\Magento\\Framework\\Cache\\Backend\\RemoteSynchronizedCache',
                'backend_options' => [
                    'remote_backend' => '\\Magento\\Framework\\Cache\\Backend\\Redis',
                    'remote_backend_options' => [
                        'persistent' => 0,
                        'server' => 'localhost',
                        'database' => '4',
                        'port' => '6370',
                        'password' => ''
                    ],
                    'local_backend' => 'Cm_Cache_Backend_File',
                    'local_backend_options' => [
                        'cache_dir' => '/dev/shm/'
                    ],
                    'use_stale_cache' => true,
                ],
                'frontend_options' => [
                    'write_control' => false,
                ],
            ]
        ],
        'type' => [
            'default' => ['frontend' => 'default'],
            'layout' => ['frontend' => 'stale_cache_enabled'],
            'block_html' => ['frontend' => 'stale_cache_enabled'],
            'reflection' => ['frontend' => 'stale_cache_enabled'],
            'config_integration' => ['frontend' => 'stale_cache_enabled'],
            'config_integration_api' => ['frontend' => 'stale_cache_enabled'],
            'full_page' => ['frontend' => 'stale_cache_enabled'],
            'translate' => ['frontend' => 'stale_cache_enabled']
        ],
    ]

オンプレミスのインストールを構成する方法については、 構成ガイドの 古いキャッシュ オプション を参照してください。

Redis のキャッシュとセッションのインスタンスを分離する

Redis キャッシュと Redis セッションを分離すると、キャッシュとセッションを個別に管理できます。 キャッシュの問題がセッションに影響を与え、売上高に影響を与える可能性を防ぐことができます。 各 Redis インスタンスは独自のコアで実行されるため、パフォーマンスが向上します。

デプロイメント中、 ビルドおよびデプロイログに次の行が表示されます。

W:   - Downloading colinmollenhour/credis (1.11.1)
W:   - Downloading colinmollenhour/php-redis-session-abstract (v1.4.5)
...
W:   - Installing colinmollenhour/credis (1.11.1): Extracting archive
W:   - Installing colinmollenhour/php-redis-session-abstract (v1.4.5): Extracting archive
...
[2022-08-17 01:13:40] INFO: Version of service 'redis' is 6.0
[2022-08-17 01:13:40] INFO: Version of service 'redis-session' is 6.0
[2022-08-17 01:13:40] INFO: redis-session will be used for session if it was not override by SESSION_CONFIGURATION

キャッシュ圧縮

6 GB を超える Redis maxmemory を使用している場合は、キャッシュ圧縮を使用して、キーが消費する領域を減らすことができます。 クライアントサイドのパフォーマンスにはトレードオフがあることに注意してください。 予備の CPU がある場合は、有効にします。 設定ガイドの セッションストレージに Redis を使用 を参照してください。

stage:
  deploy:
    REDIS_BACKEND: '\Magento\Framework\Cache\Backend\RemoteSynchronizedCache'
    CACHE_CONFIGURATION:
      _merge: true;
      frontend:
        default:
          backend_options:
            compress_data: 4              # 0-9
            compress_tags: 4              # 0-9
            compress_threshold: 20480     # don't compress files smaller than this value
            compression_lib: 'gzip'       # snappy and lzf for performance, gzip for high compression (~69%)

Redis 非同期解放の有効化（lazyfree）

クラウドインフラストラクチャー上のAdobe Commerceで lazyfree を有効にするには、Adobe Commerce サポートチケットを送信し次の Redis 設定が環境に適用されるようにリクエストします。

lazyfree-lazy-eviction yes
lazyfree-lazy-expire yes
lazyfree-lazy-server-del yes
replica-lazy-flush yes
lazyfree-lazy-user-del yes

lazyfree を有効にすると、Redis はメモリの再利用をバックグラウンド スレッドにオフロードし、削除、サーバーによる削除、ユーザーの削除、レプリカ データセットのフラッシュを行います。 これにより、メインスレッドのブロックが減り、リクエストの待ち時間が短縮されます。

Redis マルチスレッド I/O を有効にする

クラウドインフラストラクチャでAdobe Commerceの Redis I/O スレッドを有効にするには、Adobe Commerce サポートチケットを送信し以下の設定をリクエストします。 これにより、ソケットの読み取り/書き込みとコマンド解析をメインスレッドからオフロードすることで、スループットが向上しますが、CPUの使用率は高くなります。 負荷の下で検証し、ホストを監視します。

io-threads-do-reads yes
io-threads 8 # choose a value lower than the number of CPU cores (check with nproc), then tune under load

Redis クライアントのタイムアウトと再試行の回数を増やす

.magento.env.yaml でバックエンドオプションを調整して、キャッシュクライアントの許容値を一時的な飽和値に引き上げます。

stage:
  deploy:
    CACHE_CONFIGURATION:
      _merge: true
      frontend:
        default:
          backend_options:
            read_timeout: 10
            connect_retries: 5

これらの設定により、Redis のクライアント許容値が増加し、返信待ちウィンドウが拡張され、接続設定が再試行されます。 これにより、短いスパイク時の断続的な cannot connect to localhost:6370 ールと読み取りタイムアウトのエラーを減らすことができます。

追加情報