Monitoramento do status de sincronização do feed de dados
Os administradores do Adobe Commerce podem monitorar o status de sincronização dos dados exportados do Adobe Commerce para os serviços conectados do Commerce usando a página Status de sincronização do feed de dados no administrador do Commerce.
Esta página fornece insights em tempo real sobre a integridade e o desempenho dos feeds de exportação de dados que transferem dados de produto e categoria da Commerce para serviços externos, como Product Recommendations, Live Search e Catalog Service.
A página de status da sincronização mostra apenas o status da exportação. Um status bem-sucedido indica que os dados foram exportados com êxito e estarão disponíveis nos serviços conectados da Commerce. Use o Painel de gerenciamento de dados para ver o estado real da sincronização de entidade.
O monitoramento do status do feed ajuda a garantir a consistência dos dados e permite a resolução imediata de quaisquer problemas que surjam durante o processo de exportação. Os administradores podem:
- Exibir o status de sincronização para todos os feeds de dados
- Identificar e solucionar erros no processamento do feed
- Acessar informações detalhadas de status de itens de feed individuais
O status é rastreado para os seguintes feeds:
- Feed de produtos
- Feed de atributos do produto
- Feed de categorias
- Feed de substituições do produto
- Feed de preços do produto
- Feed de variantes de produto
Instalar a extensão
A página Status do feed de dados está disponível para todos os comerciantes da Commerce com licenças ativas para os seguintes serviços da Commerce:
- Product Recommendations v6.0.0+
- Live Search v4.1.0+
- Catalog Service v1.17+ com uma licença ativa.
Requisitos
-
PHP 8.1, 8.2, 8.3 ou 8.4
-
Adobe Commerce 2.4.4+
-
Extensão de Exportação de Dados do Adobe Commerce, versão 103.4.15 ou posterior
-
Acesso ao repo.magento.com
Para gerar chaves e obter os direitos necessários, consulte Obter suas chaves de autenticação. Para instalações na nuvem, consulte o Guia de Infraestrutura do Commerce na Nuvem.
-
Acesso à linha de comando do servidor de aplicativos do Adobe Commerce.
Etapas de instalação
Adicionar o módulo magento/module-data-exporter-status usando o Composer:
composer require magento/module-data-exporter-status
Para ver as etapas detalhadas de instalação, consulte os guias a seguir:
Acessar a página Status do feed de dados
No Administrador do Commerce, acesse a página Status do feed de dados do Administrador do Commerce em System > Transferência de dados > Data Feed Sync Status.
O monitoramento do status do feed de dados fornece duas interfaces:
- A página de resumo Status de sincronização do feed de dados, que lista os feeds disponíveis e o estado atual
- A página Status de Sincronização do Feed de Dados - Detalhes que mostra informações detalhadas sobre um feed selecionado.
Resumo do status de sincronização do feed de dados
A página de resumo Status de sincronização do feed fornece informações sobre a atividade de exportação do feed de dados, incluindo as seguintes informações:
Detalhes do status de sincronização do feed de dados
Na página de resumo Status do feed de dados, clique em um nome de feed ou use a ação View Details para acessar informações detalhadas sobre registros individuais em um feed.
A exibição detalhada fornece as seguintes informações para cada item do feed:
Você pode gerenciar a exibição usando os seguintes controles:
- Mass Action para agendar a ressincronização dos itens de feed selecionados
- Filters
- Default View para criar e salvar um modo de exibição filtrado e alternar entre modos de exibição
- Columns para mostrar e ocultar colunas na tabela.
Indicadores de saúde do feed
Na parte superior de cada página de detalhes do feed, os indicadores críticos de integridade fornecem o status do sistema para cada feed:
Status do indexador
- Válido: os dados estão sincronizados; nenhuma reindexação é necessária.
- Inválido: os dados originais foram alterados; o índice deve ser atualizado.
- Processando: indexação em andamento.
Backlog de log de alterações
- Todas as sincronizadas: nenhuma alteração pendente para processar
- Itens na lista de pendências: Número de alterações pendentes aguardando para serem processadas
Exportar tipos de status
O sistema fornece indicadores de status para ajudar você a identificar problemas rapidamente:
Categorias de status
Monitorar status do feed de dados
Ao atualizar entidades relacionadas ao produto e à categoria no banco de dados do Commerce, os dados são transferidos para os serviços da Commerce de acordo com a configuração do feed. Você pode monitorar esse processo em tempo real na página de resumo Status de sincronização do feed de dados.
Quando o número de registros enviados com êxito corresponde ao número de registros de origem, isso indica que a sincronização foi concluída e todos os dados foram transmitidos com êxito.
Gerenciamento de exportações com falha
Para ver os detalhes das exportações com falha e executar a ação corretiva:
-
Na página Status de sincronização do feed, encontre o feed com registros com falha.
-
Clique em Details.
-
Revise as mensagens de erro para obter os motivos específicos da falha.
-
Use ações em massa para programar operações de ressincronização para itens com falha.
Ressincronizar dados com falha
Você pode ressincronizar manualmente feeds de dados com falha ou problemáticos usando o menu Actions na página Data Feed Sync Status - Details.
Enquanto o sistema tenta automaticamente determinados tipos de falhas, pode ser necessária uma intervenção manual nos seguintes cenários:
- Você percebe erros de autenticação ou permissão (códigos de status 401, 403).
- Após resolver problemas de formato de dados que causavam erros de carga.
- Seguindo atualizações para configurações de serviço externo ou endpoints.
- Você está implantando personalizações que afetam processos de exportação de dados.
Ao monitorar proativamente o status do feed e solucionar falhas prontamente, você pode manter a consistência e a confiabilidade dos dados em todo o ecossistema do Commerce.
Ressincronizar manualmente os itens do feed
Se precisar ressincronizar itens específicos do feed:
- Selecionar Registros: use caixas de seleção para selecionar registros com falha que precisem de atenção.
- Escolher Ação: Selecione Schedule Resync na lista suspensa de ações em massa.
- Confirmar: clique em Submit e confirme a operação de ressincronização.
- Monitorar Resultados: Verifique a mensagem de êxito e monitore as alterações de status.
Práticas recomendadas
Monitoramento regular
- Verificações Diárias: examine a página de visão geral diariamente para ver se há feeds mostrando altas taxas de falha
- Aprofundamento Semanal: examine o status detalhado de feeds críticos (produtos, preços)
- Análise Mensal: controle tendências em taxas de sucesso e desempenho de exportação
Solução de problemas do fluxo de trabalho
- Identificar problemas: procure erros e contagens altas de falhas
- Verificar Integridade do Indexador: verifique se os indexadores são válidos e se a lista de pendências é gerenciável
- Revisar Detalhes do Erro: clique nos registros com falha para ver mensagens de erro específicas
- Ressincronizar agendamento: usar ações em massa para repetir exportações com falha
- Resolução do Monitor: verifique se os itens ressincronizados mostram o status de êxito
Corrigir problemas comuns
Altas taxas de falha
Sintomas: grande número de registros mostrando o status "Falha, requer atenção"
Causas potenciais:
- Alterações na configuração do serviço externo
- Incompatibilidades de formato de dados
- Problemas de autenticação ou permissão
Etapas de resolução:
- Verificar o status e a configuração do serviço externo
- Revisar mensagens de erro por padrões
- Verificar credenciais de autenticação
- Entre em contato com o suporte do serviço externo, se necessário
Desempenho de exportação lento
Sintomas: alta lista de pendências de changelog, atualizações lentas de status
Causas Possíveis:
- Problemas de desempenho do indexador
- Alto volume de dados
- Limitação da taxa de serviço externa
Etapas de Resolução:
- Verifique o status do indexador e execute novamente se for inválido
- Monitorar tempos de resposta do serviço externo
- Considere o agendamento de exportações fora do horário de pico
- Analisar o desempenho e os recursos do sistema
Falhas de autenticação
Sintomas: códigos de status 401 ou 403
Etapas de Resolução:
- Verificar credenciais e tokens da API
- Verificar permissões de conta de serviço externo
- Renovar tokens de autenticação expirados
- Entre em contato com seu provedor de serviços para resolver problemas de acesso