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