ドキュメントCommerce設定ガイド

サポートユーティリティの実行

最終更新日： 2026年5月19日

作成対象：

  • Experienced
  • Admin
  • Developer
NOTE
この機能は、Adobe Commerce インスタンスでのみ使用できます。
WARNING
すべてのMagento CLI コマンドは、​ ファイルシステム所有者によって実行する必要があります。

Adobe Commerce サポートユーティリティ（Data Collectorとも呼ばれます）を使用すると、お客様のシステムに関するトラブルシューティング情報を収集できます。この情報は、サポートチームで使用できます。

Adobe Commerceでは、コードへのアクセスが必要な問題を分析するために、これらのバックアップ（ダンプ​とも呼ばれます）を使用します。 一般的なシナリオは次のとおりです。

  1. Commerce ストアに問題が発生しており、Adobe Commerce サポートにお問い合わせください。

  2. サポートは、問題を再現するためにコードまたはデータベースを確認する必要があると判断します。

  3. コードを.tar.gz ファイルにバックアップします。

    このバックアップは、メディアファイルを除外して、プロセスを高速化し、ファイルを大幅に小さくします。

  4. データベースを.tar.gz ファイルにバックアップします。

    デフォルトでは、機密データはバックアップ時にハッシュ化されます。

  5. バックアップをファイル共有サービスにアップロードします。

  6. サポートは、開発や実稼動環境に影響を与えることなく、問題を分析します。

ユーティリティは完了するのに数分かかることがあります。

コードバックアップの作成

このコマンドは、コードをバックアップし、tar.gz形式で圧縮します。

TIP
support:backup コマンドは、setup:backup コマンドで実行したコード バックアップと同じ​_not_​です。 support:backup コマンドは、Adobe Commerce サポートによるテスト用にコードをバックアップすることを目的としています。

コマンドオプション：

bin/magento support:backup:code [--name=<file name>] [-o|--output=<path>] [-l|--logs]

どこで：

  • --name​は、ダンプファイル名を指定します（オプション）。 このパラメーターを省略すると、ダンプファイルは時刻と日付がスタンプされます。
  • -o|--output=<path>​は、バックアップを保存するための絶対ファイル システム パスです（必須）。
  • -l|--logs​にはログファイルが含まれています（オプション）。

例えば、/var/www/html/magento2/var/log/mycodebackup.tar.gzという名前のコードバックアップを作成するには：

bin/magento support:backup:code --name mycodebackup -o /var/www/html/magento2/var/log

コマンドが完了したら、コードのバックアップをAdobe Commerce サポートに提供します。

データベースのバックアップの作成

このコマンドは、Commerce データベースをバックアップし、tar.gz形式で圧縮します。

TIP
support:backup コマンドは、setup:backup コマンドで実行したコード バックアップと同じ​_not_​です。 support:backup コマンドは、Adobe Commerce サポートによるテスト用にコードをバックアップすることを目的としています。

コマンドオプション：

bin/magento support:backup:db [--name=<name>] [-o|--output=<path>] [-l|--logs] [-i|--ignore-sanitize]

どこで：

  • --name​は、ダンプファイル名を指定します（オプション）。 このパラメーターを省略すると、ダンプファイルは時刻と日付がスタンプされます。
  • **-o|--output=<path>は、バックアップを保存するための絶対ファイルシステムパスです（必須）。
  • -l|--logs​にはログファイルが含まれています（オプション）。
  • -i|--ignore-sanitize​は、データが保持されることを意味します。バックアップの作成時に、データベースに保存されている機密データをハッシュするフラグを省略します（オプション）。

機密データには、次のデータベーステーブルからの顧客情報が含まれます。

'customer_entity',
'customer_entity_varchar',
'customer_address_entity',
'customer_address_entity_varchar',
'customer_grid_flat',
'quote',
'quote_address',
'sales_order',
'sales_order_address',
'sales_order_grid'

コマンドが完了したら、データベースのバックアップをAdobe Commerce サポートに提供します。

トラブルシューティング：表示ユーティリティとパス

データコレクターとコマンドラインで必要なユーティリティへのパスを表示するコマンドを提供します。 例えば、次のようなエラーが管理者またはコマンドラインに表示される場合は、これらのコマンドを使用できます。

Utility lsof not found

次のコマンドを順に実行して、サポートユーティリティとデータコレクターで使用されるアプリケーションへのパスを表示します。

  1. Commerceのインストールディレクトリに移動します。

    例：cd /var/www/magento2

    note info
    INFO
    インストールディレクトリから​_only_ コマンドが正しく実行されます。

  2. bin/magento support:utility:pathsは<magento_root>/var/support/Paths.phpを作成し、ユーティリティで使用されるすべてのアプリケーションへのパスを一覧表示します。

  3. bin/magento support:utility:checkはファイルシステムのパスを表示します。

サンプルは次のとおりです。

   gzip => /bin/gzip
   lsof => /usr/sbin/lsof
   mysqldump => /usr/bin/mysqldump
   nice => /bin/nice
   php => /usr/bin/php
   tar => /bin/tar
   sed => /bin/sed
   bash => /bin/bash
   mysql => /usr/bin/mysql

ツールの実行に関する問題を解決するには、これらのアプリケーションがインストールされ、web サーバーユーザーの$PATH環境変数にあることを確認してください。

recommendation-more-help
commerce-operations-help-configuration