OneTrace.pro Central de ajuda

Diagnóstico

A página “Diagnóstico” mostra se os dados do projeto estão fluindo neste momento:

  • se os eventos estão sendo recebidos;
  • se os feeds estão sendo atualizados e as imagens dos produtos, copiadas;
  • se as sincronizações e integrações estão funcionando;
  • se as mensagens estão sendo enviadas;
  • se os cálculos em segundo plano não travaram.

Consulte esta página se os relatórios estiverem vazios, se faltarem imagens no widget ou se os e-mails não tiverem chegado: geralmente a causa aparece aqui.

Onde encontrar

  • Configurações → Diagnóstico no menu do projeto — a página detalhada.
  • O bloco Diagnóstico no painel — o resumo de cada seção em uma linha e o link Abrir diagnóstico.

A página se atualiza sozinha a cada 30 segundos enquanto estiver aberta. O seletor no topo mostra os gráficos da Última hora (por minuto) ou das 24 horas (por hora). O histórico é mantido por 24 horas.

Página “Diagnóstico”

Status

Cada seção e cada linha dentro dela têm um status. O status da seção é o pior status entre as suas linhas.

Status O que significa
Normal Tudo está funcionando
Atenção Está funcionando, mas há desvios: parte dos eventos foi rejeitada, não há eventos há mais de um dia, uma execução agendada atrasou mais de 30 minutos, as mensagens estão sendo enviadas com erros
Erro É preciso intervir: um feed ou uma sincronização terminou com erro, há mensagens presas na fila, eventos não foram processados
Sem dados A seção ainda não foi usada: por exemplo, o projeto ainda não recebeu nenhum evento

Quem vê o quê

A página está aberta a todos os membros do projeto, e as seções nela aparecem conforme as permissões — da mesma forma que os itens do menu. Por exemplo, a função “Usuário” vê a recepção de eventos, o catálogo, as mensagens e os cálculos, enquanto as fontes de dados, as migrações e as integrações ficam visíveis a partir de “Gerente”. Se a função dá acesso apenas a parte dos segmentos, jornadas ou integrações, o diagnóstico não os mostra. Mais sobre permissões no artigo Membros e funções.

Recepção de eventos

Indicador O que significa
Último evento Quando o último evento chegou ao projeto
Aceitos em 24 horas Eventos aceitos nas últimas 24 horas, incluindo cargas de períodos anteriores
Rejeitados em 24 horas Eventos que não foram aceitos: o limite de eventos do plano se esgotou ou o projeto está suspenso
Aguardando processamento Eventos aceitos que ainda não foram gravados nos perfis. Normalmente são segundos
Lotes com falha Lotes de eventos que não foram processados após todas as tentativas

O gráfico mostra os eventos aceitos, duplicados e rejeitados. Um duplicado é um evento com o mesmo messageId de um que já chegou: ele não é contado uma segunda vez. Duplicados são normais quando o rastreador ou o servidor reenviam um evento depois de uma queda de conexão.

Se não houver eventos há mais de um dia, a seção recebe o status “Atenção”. Verifique se o rastreador está instalado no site e se as integrações e fontes de dados estão enviando eventos.

Catálogo e feeds

No topo da seção ficam o número de produtos e quantos deles estão em estoque. Abaixo, para cada feed:

  • o status;
  • a hora da última e da próxima execução;
  • o texto do erro, se a última execução falhou.

Se o feed copia as imagens dos produtos, logo abaixo aparece quantas imagens foram copiadas, quantas aguardam na fila e quantas não puderam ser baixadas. O gráfico da fila de cópia mostra como ela é processada depois da atualização do feed. A velocidade de cópia é definida nas configurações do feed (Baixar no máximo) — veja Recomendações e catálogo de produtos.

Sincronizações

Aqui ficam as conexões que trocam dados com outros sistemas:

Em cada linha aparecem a hora da última execução (nas integrações, da última verificação), da próxima execução e o texto do erro. O nome leva à página da conexão.

Mensagens

Indicador O que significa
Em 24 horas Todas as mensagens do projeto nas últimas 24 horas
Com falha em 24 horas Mensagens que o canal não conseguiu entregar
Presas na fila Mensagens que aguardam envio há mais de 15 minutos

Abaixo ficam a hora da última mensagem enviada em cada canal e o gráfico de mensagens das últimas 24 horas por hora: enviadas, na fila, ignoradas (por exemplo, sem consentimento ou por limite de frequência) e com falha. O gráfico Fila de envio mostra quantas mensagens aguardavam envio: depois do disparo de uma campanha grande, a fila cresce e é processada em minutos.

Cálculos em segundo plano

Cálculo O que é verificado
Recomendações O estado do modelo e a hora do último cálculo
Previsões O estado do modelo e a hora do último cálculo
Aprendizado da busca Quantas buscas foram aprendidas e quando
Segmentos Segmentos com erro de cálculo e travados (calculando há mais de 30 minutos)
Jornadas Esperas de participantes atrasadas em mais de 5 minutos

Fila de tarefas

As tarefas em massa do projeto — campanhas, indexação do catálogo, carregamento do histórico de eventos, etapas de jornadas, importações agendadas de feeds, sincronizações e cálculos noturnos — são processadas em revezamento com as tarefas de outros projetos. Enquanto o projeto está sozinho, ele ocupa toda a capacidade de processamento. Quando outros projetos também têm tarefas aguardando, cada um recebe uma cota de vagas, e uma campanha grande de uma loja não atrasa os e-mails da loja vizinha. A cota depende do plano: no “Crescimento”, ela é duas vezes maior do que no “Inicial”, e no “Empresarial”, quatro vezes maior.

A seção aparece quando o projeto teve tarefas na fila nas últimas 24 horas. Nela, você vê quantas tarefas aguardam agora e de quais tipos, além do gráfico da fila. Se as tarefas aguardam por mais de meia hora a cada minuto, a seção recebe o status “Atenção”: com a carga compartilhada, o projeto atinge a sua cota. Nesse caso, as tarefas não se perdem: elas são processadas à medida que as vagas se liberam.

O que fazer se…

O que aparece O que verificar
Não há eventos há mais de um dia O rastreador no site, as chaves de API das integrações, o agendamento das fontes de dados
Há eventos rejeitados O consumo de eventos na página Plano e cobrança — veja Plano e cobrança
Há lotes com falha Fale com o suporte: esses lotes podem ser processados novamente
Feed com erro Se o endereço do feed está acessível e se o formato dele não mudou
As imagens não são copiadas Se as imagens estão acessíveis pelos links do feed e se o espaço da biblioteca de mídia no plano não se esgotou
Sincronização com erro O texto do erro: na maioria das vezes, a chave de acesso expirou ou o endereço está inacessível
Mensagens presas na fila As integrações dos canais na página Integrações; se estiverem em ordem, fale com o suporte
Segmento travado Abra o segmento e clique em Recalcular; se não resolver, fale com o suporte
As tarefas aguardam muito tempo na fila É melhor iniciar grandes operações pontuais (carregamento do histórico, campanha para toda a base) fora dos horários de pico; a falta constante de cota é um motivo para mudar para um plano superior — veja Plano e cobrança