Revisar logs e solucionar problemas
A extensão data export fornece logs para rastrear processos de sincronização e coleta de dados.
Logs
Os logs estão disponíveis no diretório var/log no servidor de aplicativos do Commerce.
commerce-data-export.logdata-export-errors.logsaas-export.logsaas-export-errors.logSe você não vir os dados esperados para um serviço do Adobe Commerce, use os logs de erro da extensão de exportação de dados para determinar onde o problema ocorreu. Além disso, é possível estender registros com dados adicionais para rastreamento e solução de problemas. Consulte Logon estendido.
Formato do log
Cada registro de log tem a seguinte estrutura.
[<log record datetime>] report.<log level>:
{
"feed": "<feed name>",
"operation": "<executed operation>",
"status": "<status of operation>",
"elapsed": "<time elapsed from script run>",
"pid": "<process id that executed `operation`>",
"caller": "<who called this `operation`>"
} [] []
A tabela a seguir descreve os tipos de operação que podem ser registrados nos logs.
bin/magento saas:resync --feed=productsbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (qualquer grupo cron "*_data_exporter")bin/magento saas:resync --feed=categoriesbin/magento cron:run --group=indexbin/magento cron:run --group=saas_data_exporter (qualquer grupo cron "*_data_exporter")Exemplos de registro
Durante uma ressincronização completa, o progresso é rastreado e registrado a cada 30 segundos por padrão. Este é um exemplo de entrada de log.
{
"feed": "prices",
"operation": "full sync",
"status": "Progress: 2/5, processed: 200, synced: 100",
"elapsed": "00:00:00 190 ms",
"pid": "12824",
"caller": "bin/magento saas:resync --feed=products"
}
Neste exemplo, os valores status fornecem informações sobre a operação de sincronização:
-
"Progress 2/5"indica que 2 de 5 iterações foram concluídas. O número de iterações depende do número de entidades exportadas. -
"processed: 200"indica que 200 itens foram processados. -
"synced: 100"indica que 100 itens foram enviados para SaaS. Espera-se que"synced"não seja igual a"processed". Veja um exemplo:"synced" < "processed"significa que a tabela de feed não detectou alterações no item em comparação à versão sincronizada anteriormente. Esses itens são ignorados durante a operação de sincronização."synced" > "processed"a mesma id de entidade (por exemplo,Product ID) pode ter vários valores em escopos diferentes. Por exemplo, um produto pode ser atribuído a cinco sites. Nesse caso, você pode ter "1 item processado" e "5 itens sincronizados".
| code language-none |
|---|
|
Exibir e solucionar problemas de logs com o New Relic
Se você armazenar logs do Adobe Commerce na New Relic, poderá adicionar regras de análise para melhorar a legibilidade e a experiência de consulta.
-
Faça logon no New Relic.
-
Ir para
Logs => Parsing. -
Clique em
Create parsing rule. -
Configure a regra de análise adicionando os seguintes valores.
-
Filtrar logs com base no NRQL
filePath LIKE '%commerce-data-export%.log' -
Regra de análise
\[%{DATA:timestamp}\] report.%{DATA:logLevel} %{GREEDYDATA:feed:json}
-
Esse exemplo adiciona uma regra que permite consultar logs do New Relic por tipo de feed específico, operação e assim por diante.
Exemplo de cadeia de caracteres de consulta—feed.feed:"products" and feed.status:"Complete"
Solução de problemas
Se os dados estiverem ausentes ou incorretos nos serviços da Commerce, verifique nos logs se há mensagens sobre erros que ocorreram durante a sincronização do Adobe Commerce com a plataforma dos serviços da Commerce. Se necessário, use o registro estendido para adicionar mais informações aos registros para solucionar problemas.
- O log de erros de Exportação de Dados (
commerce-data-export-errors.log) captura erros que ocorrem durante a fase de coleta. - O log de erros de exportação SaaS (
saas-export-errors.log) captura os erros que ocorrem durante a fase de transmissão.
Se você vir erros não relacionados à configuração ou a extensões de terceiros, envie um tíquete de suporte com o máximo de informações possível.
Resolver problemas de sincronização do catálogo resolvesync
Quando você aciona uma ressincronização de dados, pode levar até uma hora para que os dados sejam atualizados e refletidos nos componentes da interface do usuário, como pesquisa em tempo real e unidades de recomendação. Se você ainda vir discrepâncias entre o catálogo e os dados na loja da Commerce, ou se a sincronização do catálogo falhar, consulte o seguinte:
Discrepância de dados
- Exiba a exibição detalhada do produto em questão nos resultados da pesquisa.
- Copie a saída JSON e verifique se o conteúdo corresponde ao que você tem no catálogo Commerce.
- Se o conteúdo não corresponder, faça uma pequena alteração no produto no catálogo, como adicionar um espaço ou um ponto.
- Aguarde uma ressincronização ou acione uma ressincronização manual.
A sincronização não está em execução
Se a sincronização não estiver sendo executada de acordo com um agendamento ou se nada estiver sincronizado, consulte este artigo da KnowledgeBase.
Falha na sincronização
Se a sincronização do catálogo tiver um status de Falha, envie um tíquete de suporte.
Logon estendido
Use variáveis de ambiente para estender logs com dados adicionais para rastreamento e solução de problemas. Adicione a variável de ambiente à linha de comando quando executar comandos da CLI de exportação de dados, conforme mostrado nos exemplos a seguir.
Verificar a carga do feed
Inclua a carga do feed no log de exportação do SaaS adicionando a variável de ambiente EXPORTER_EXTENDED_LOG=1 ao sincronizar novamente o feed.
EXPORTER_EXTENDED_LOG=1 bin/magento saas:resync --feed=products
Após a conclusão da operação, a carga do feed estará disponível para revisão no log de exportação do SaaS (var/.log/saas-export.log).
Preservar conteúdo na tabela de índice do feed
Para a extensão de exportação de dados SaaS do Commerce (magento/module-data-exporter) 103.3.0 e posterior, os feeds de exportação imediatos mantêm somente os dados mínimos necessários na tabela de índice. Os feeds incluem todos os feeds de status do catálogo e do estoque de estoque.
A preservação de dados de carga útil na tabela de índice não é recomendada em ambientes de produção, mas pode ser útil em um ambiente de desenvolvedor. Inclua a carga do feed no índice adicionando a variável de ambiente PERSIST_EXPORTED_FEED=1 ao ressincronizar o feed.
PERSIST_EXPORTED_FEED=1 bin/magento saas:resync --feed=products
Execute o Profiler para solucionar problemas de desempenho lento
Se o processo de reindexação de um feed específico demorar um tempo excessivo, execute o profiler para coletar dados adicionais que podem ser úteis para a Equipe de suporte.
Execute o profiler adicionando a variável de ambiente EXPORTER_PROFILER=1 quando você executar o comando reindex.
EXPORTER_PROFILER=1 bin/magento indexer:reindex catalog_data_exporter_products
Os dados do criador de perfil são armazenados no log de exportação de dados (var/log/commerce-data-export.log) no seguinte formato:
<Provider class name>, <# of processed entities>, <execution time im ms>, <memory consumption in Mb>