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.log
data-export-errors.log
saas-export.log
saas-export-errors.log
Se 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 elaspsed from script run>",
"pid": "<proccess id who 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=products
bin/magento cron:run --group=index
bin/magento cron:run --group=saas_data_exporter
(qualquer grupo cron "*_data_exporter")bin/magento saas:resync --feed=categories
bin/magento cron:run --group=index
bin/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 do Comércio, verifique os logs para ver se ocorreu um problema durante a sincronização da instância do Adobe Commerce com a plataforma Commerce Service. Se necessário, use o registro estendido para adicionar mais informações aos registros para solucionar problemas.
- commerce-data-export-errors.log - se ocorreu um erro durante a fase de coleta
- saas-export-errors.log - se um erro ocorreu 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
Para obter informações de log adicionais, você pode usar variáveis de ambiente para estender logs com dados adicionais para rastreamento e solução de problemas.
Há dois arquivos de log no diretório var/log/
:
- commerce-data-export-errors.log - se ocorreu um erro durante a fase de coleta
- saas-export-errors.log - se um erro ocorreu durante a fase de transmissão
Você pode usar variáveis de ambiente para estender logs com dados adicionais para rastreamento e solução de problemas.
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
quando 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>