Pular para o conteúdo principal

Tarefa de Sincronização

1. Introdução​

Este documento tem como objetivo auxiliar na análise da tarefa de sincronização, descrevendo os passos necessários para realizar a verificação e identificar possíveis problemas.

2. Itens necessários​

Para executar a análise, é necessário ter acesso a:

  • Landix Station (Station Web)
  • AWS

Caso você não tenha acesso ao Landix Station, procure as credenciais no TeamPass.
Se não tiver acesso à AWS, solicite suporte à equipe de Infraestrutura.

3. Rodar a tarefa de sincronização​

A tarefa de sincronização pode ser acionada manualmente pelo Station Web.

Para rodar a sincronização:

  1. Abra o Station Web.
  2. Na barra lateral esquerda, acesse o módulo Tarefas.
  3. Clique na opção Solicitar Importação Sync SFV.
  4. Confirme no aviso que deseja executar a sincronização.
  5. Ainda no módulo Tarefas, acesse a aba Tarefas Escalonadas.
  6. Localize a tarefa de sincronização e acompanhe o status:
    • Esperando (azul)
    • Processando (laranja)
    • Concluída (verde)

4. Verificação no Step Functions​

Após acionar a tarefa de sincronização no Station, inicia-se a importação dos itens que sofreram alterações no Sankhya. Essas alterações geram logs gravados na tabela TGLATS do Sankhya.

Para verificar a execução no AWS Step Functions, siga os passos abaixo:

Passo 1: Acessar a AWS​

  1. Acesse o link no navegador:
    https://d-9a6711e2da.awsapps.com/start/#/?tab=accounts
  2. Entre no perfil correspondente ao Station onde você acionou a sincronização.
  3. No portal de serviços da AWS, utilize a barra de pesquisa (parte superior esquerda) e procure por Step Functions.

Passo 2: Selecionar a máquina de estado​

  1. Ao abrir o Step Functions, acesse a tela Máquinas de estado.
  2. Você verá duas máquinas:
    • Uma para importações do Landix SFV
    • Outra para o Landix FLEX
  3. Selecione a máquina conforme o aplicativo utilizado pelo cliente analisado.

Passo 3: Localizar a sincronização do cliente​

  1. Na tela principal, serão exibidas as execuções de sincronização de diversos clientes.
  2. Para identificar a sincronização correta, utilize o horário de início da tarefa.
  3. Esse horário deve ser obtido no Station Web, na tela Tarefas Escalonadas.
  4. Encontre a execução no Step Functions com o mesmo horário de início.

Passo 4: Confirmar o cliente da execução​

  1. Clique no código em azul da execução.
  2. Dentro da execução, acesse a aba Entrada e Saída de execução.
  3. Verifique o nome do cliente nas informações exibidas.

Passo 5: Entender as tabelas importadas​

  1. Dentro da execução, clique em Exibição de tabela.
  2. Você verá uma visão em linha com as “mini tarefas” da sincronização.

Em uma sincronização, os principais passos são:

  • Orchestrator
  • Parallel Sync
  • Merger

No passo Parallel Sync, existem tarefas chamadas MapIteration, responsáveis por importar as tabelas do ERP do cliente.

Passo 6: Identificar a tabela de cada MapIteration​

  1. Selecione a bolinha à esquerda da tarefa MapIteration desejada.
  2. No painel de detalhes (lado direito), verifique o campo name.
  3. O campo name indica o nome da entidade/tabela do Sankhya que está sendo importada.

Também é possível verificar o tempo de duração da importação de cada tabela diretamente nessa visualização.

5. Verificação no CloudWatch​

Para analisar os logs da sincronização, utilize o AWS CloudWatch.

Passo 1: Acessar o CloudWatch​

  1. Na barra de pesquisa da AWS (parte superior esquerda), procure por CloudWatch.

Passo 2: Acessar Log Management​

  1. No menu lateral esquerdo, clique em Log Management.

Passo 3: Localizar o grupo de logs​

  1. Em Grupo de logs, pesquise pelo seguinte grupo:
  • /aws/lambda/sfv-import-lambda-task-sync-prod-us-east-2-main

Passo 4: Pesquisar nos fluxos de log​

  1. Entre no grupo de logs.
  2. Acesse a aba Pesquisar todos os fluxos de log.

Passo 5: Filtrar logs pela tarefa do Station​

Para localizar os logs da tarefa que você executou:

  1. No Station Web, vá até Tarefas Escalonadas.
  2. Na coluna Código, copie o código da tarefa somente até o último caractere antes do primeiro hífen.

⚠️ Atenção

Para pesquisar corretamente, utilize apenas a parte do código antes do primeiro hífen.

  1. Cole o código na barra de pesquisa em Eventos de log.
  2. Ajuste o intervalo de tempo ao lado da pesquisa (por exemplo, 1 hora), considerando o horário em que a tarefa rodou.

Após isso, os logs correspondentes à sua tarefa serão exibidos.

Passo 6: Ver logs detalhados​

  1. Clique no link azul na coluna Nome do stream de logs.

Assim, você terá acesso aos logs completos da tarefa de sincronização, desde o início até a finalização.

6. Erros do cotidiano​

Um dos problemas mais comuns na análise é a lentidão no tempo de sincronização.

Conforme descrito anteriormente, é possível verificar o tempo de duração da importação de cada tabela via Step Functions. Quando uma tabela ainda não foi importada completamente, o status permanece como Em andamento.

Verificar quanto ainda falta para importar​

Para entender quantos dados ainda faltam:

  1. No Step Functions, entre na tarefa MapIteration correspondente à tabela que está Em andamento.
  2. Verifique o campo start_page (página inicial utilizada pela importação).

Para descobrir em qual página o processo está atualmente:

  1. Acesse os logs no CloudWatch.
  2. Localize a linha do log que indica a página atual.

Para identificar o total de páginas a serem importadas:

  1. No CloudWatch, localize a linha que indica o total de páginas.

Em seguida:

  1. Subtraia a página atual do total de páginas.
  2. O resultado indica quantas páginas ainda faltam para importar.

⚠️ Atenção

Neste cenário, considere que cada página corresponde a 50 logs.

Material de apoio​

Documento: Manual de análise da tarefa de sincronização