データフィード同期ステータスの監視
Adobe Commerce管理者は、Commerce Admin のデータフィード同期ステータスページを使用して、Adobe Commerceから接続されたCommerce サービスに書き出されたデータの同期ステータスを監視できます。
このページでは、Commerceから Product Recommendations、Live Search、Catalog Service などの外部サービスに製品およびカテゴリデータを転送するデータ書き出しフィードの正常性とパフォーマンスに関するリアルタイムのインサイトを提供します。
同期ステータスページには、書き出しステータスのみが表示されます。 成功ステータスは、データが正常に書き出され、最終的に接続されたCommerce サービスで使用できることを示します。 データ管理ダッシュボード を使用して、エンティティ同期の実際の状態を確認します。
フィードのステータスを監視すると、データの一貫性を確保でき、書き出しプロセス中に発生した問題を迅速に解決できます。 管理者は次の操作を実行できます。
- すべてのデータフィードの 同期ステータスの表示
- フィード処理での エラーの特定とトラブルシューティング
- 個々のフィード項目の詳細ステータス情報へのアクセス
ステータスは、次のフィードについて追跡されます。
- 製品フィード
- 製品属性フィード
- カテゴリフィード
- 製品オーバーライドフィード
- 製品価格フィード
- 製品バリアントフィード
拡張機能のインストール
データフィードステータス ページは、次のCommerce サービスのライセンスがアクティブなすべてのCommerce マーチャントが利用できます。
- Product Recommendations v6.0.0+
- Live Search v4.1.0+
- アクティブなライセンスを持つ Catalog Service v1.17+。
要件
-
PHP 8.1、8.2、8.3、または 8.4
-
Adobe Commerce 2.4.4 以降
-
Adobe Commerce Data Export Extension、バージョン 103.4.15 以降
-
repo.magento.com へのアクセス
キーを生成し必要な権限を取得するには、 認証キーの取得 を参照してください。 クラウドインストールについては、Commerce on Cloud Infrastructure ガイド を参照してください。
-
Adobe Commerce アプリケーションサーバーのコマンドラインにアクセスします。
インストール手順
Composer を使用して magento/module-data-exporter-status モジュールを追加します。
composer require magento/module-data-exporter-status
インストール手順について詳しくは、次のガイドを参照してください。
データフィードのステータス ページにアクセスします
Commerce管理者で、Commerce管理者（System / データ転送/ Data Feed Sync Status）からデータフィードステータスページにアクセスします。
データフィードステータス監視には、次の 2 つのインターフェイスが用意されています。
- 使用可能なフィードと現在の状態を一覧表示する データフィード同期ステータスの概要ページ
- 選択したフィードに関する詳細情報を表示する データフィード同期のステータス – 詳細 ページ。
データフィード同期ステータスの概要
フィード同期ステータスの概要ページには、データフィードのエクスポートアクティビティに関する情報が表示されます。これには次の情報が含まれます。
データフィード同期ステータスの詳細
データフィードのステータスの概要ページで、フィード名をクリックするか、View Details アクションを使用して、フィード内の個々のレコードに関する詳細情報にアクセスします。
フィード項目のステータスレポートを含む
詳細表示には、フィード項目ごとに次の情報が表示されます。
次のコントロールを使用して、ビューを管理できます。
- 選択したフィード項目の再同期をスケジュールで Mass Action ません
- Filters
- フィルター済みビューを作成および保存したり、ビューを切り替えたりで Default View ます
- テーブルの列の表示と非表示を切り Columns えます。
フィードの正常性インジケーター
各フィードの詳細ページの上部にある重要なヘルスインジケーターには、各フィードのシステムステータスが表示されます。
インデクサーのステータス
- 有効: データは同期されています。再インデックスは必要ありません。
- 無効：元のデータが変更されました。インデックスを更新する必要があります。
- 処理中: インデックスを処理中です。
変更ログバックログ
- すべて同期済み：処理する保留中の変更はありません
- バックログの項目：処理待ちの保留中の変更数
ステータスのタイプを書き出し
システムには、問題をすばやく特定するのに役立つ次のステータス指標が用意されています。
状態カテゴリ
データフィードのステータスの監視
Commerce データベース内の製品およびカテゴリ関連のエンティティを更新すると、フィードの設定に従ってCommerce サービスにデータが転送されます。 データフィード同期ステータスの概要ページから、このプロセスをリアルタイムで監視できます。
正常に送信されたレコードの数がソースレコードの数と一致する場合は、同期が完了し、すべてのデータが正常に送信されたことを示しています。
失敗した書き出しの管理
失敗した書き出しの詳細を確認し、修正措置を実行するには、次の手順を実行します。
-
「フィード同期のステータス」ページで、レコードが失敗したフィードを見つけます。
-
「Details」をクリックします。
-
特定の失敗理由について、エラーメッセージを確認します。
-
一括処理を使用して、失敗した品目の再同期操作をスケジュールします。
失敗したデータの再同期
失敗したデータフィードや問題のあるデータフィードは、Actions ページの Data Feed Sync Status - Details メニューを使用して、手動で再同期できます。
システムは特定の種類のエラーを自動的に再試行しますが、次のような場合は手動での介入が必要な場合があります。
- 認証エラーまたは権限エラー（401、403 ステータスコード）が表示されます。
- ペイロードエラーの原因となったデータフォーマットの問題を解決した後。
- 外部サービスの設定またはエンドポイントを次のように更新しました。
- データの書き出しプロセスに影響を与えるカスタマイズをデプロイしようとしています。
フィードのステータスをプロアクティブに監視し、エラーに迅速に対処することで、Commerce エコシステム全体でデータの一貫性と信頼性を維持できます。
フィード項目を手動で再同期
特定のフィード項目を再同期する必要がある場合：
- レコードを選択：チェックボックスを使用して、注意が必要な失敗したレコードを選択します。
- アクションを選択：一括アクショ Schedule Resync ドロップダウンから「アクション」を選択します。
- 確認:「Submit」をクリックして、再同期操作を確認します。
- 結果を監視：成功メッセージを確認し、ステータスの変更を監視します。
ベストプラクティス
定期的な監視
- 日別チェック：高い失敗率を示すフィードについて、概要ページを毎日確認します
- 週別ディープダイブ：重要なフィード（製品、価格）の詳細なステータスを調べます
- 月次分析：書き出しの成功率とパフォーマンスのトレンドを追跡します
トラブルシューティングワークフロー
- 問題の特定：エラーと多数の失敗数を探します
- インデクサーの正常性のチェック：インデクサーが有効で、バックログが管理可能であることを確認します
- エラーの詳細を確認：失敗したレコードをクリックして、特定のエラーメッセージを表示します
- 再同期をスケジュール：一括操作を使用して、失敗した書き出しを再試行します
- モニターの解決：再同期された項目のステータスが成功であることを確認します
よくある問題の修正
高い障害率
症状：多数のレコードに「失敗、要注意」ステータスが表示される
考えられる原因:
- 外部サービス設定の変更
- データ形式の非互換性
- 認証または権限の問題
解決手順:
- 外部サービスのステータスと設定の確認
- パターンのエラーメッセージの確認
- 認証資格情報の検証
- 必要に応じて、外部サービスサポートにお問い合わせください
書き出しのパフォーマンスの低下
症状：変更ログバックログが多く、ステータスの更新が遅い
考えられる原因:
- インデクサーのパフォーマンスの問題
- 大量のデータ
- 外部サービスレート制限
解決手順:
- インデクサーステータスを確認し、無効な場合は再実行します
- 外部サービスの応答時間の監視
- ピーク以外の時間帯に書き出しをスケジュールすることを検討する
- システムリソースとパフォーマンスのレビュー
認証エラー
症状:401 または 403 ステータスコード
解決手順:
- API 資格情報とトークンの検証
- 外部サービス アカウントのアクセス許可の確認
- 期限切れ認証トークンの更新
- アクセスの問題については、サービスプロバイダーにお問い合わせください