RWS Docs

Visão geral

Para verificar se sua integração está executando corretamente ou diagnosticar falhas em Extração, Transformação ou Envio, use os canais de log do Slack criados para seu tenant. A RWS Integration publica logs de execução como arquivos json nesses canais.

Página de status da integração

Em workspaces onde ela está habilitada, abrir uma integração mostra uma página de status em vez do formulário editável. Ela dá uma visão rápida da saúde da integração sem sair do app:

A execução atual ou a última execução e seu resultado
Quanto tempo cada fase levou: Extração, Transformação e Envio
Quantos registros cada fase processou

A partir dessa página você também pode:

Clicar em Executar agora para iniciar uma execução imediatamente. A página é somente leitura, então não há nada para salvar: após confirmar no diálogo, a execução começa na hora.
Clicar em Editar Integração para abrir o formulário editável.

A página de status é habilitada por workspace. Se você não a vê, seu workspace ainda abre o formulário editável. Fale com a equipe RWS se quiser habilitá-la.

Canais do Slack

No Slack, você verá quatro canais para seu tenant:

Extração com Sucesso

{{ tenant }}-extract-success Logs para extrações bem-sucedidas de todas as integrações

Erro de Extração

{{ tenant }}-extract-error Logs para extrações com falha de todas as integrações

Erro de Transformação

{{ tenant }}-transform-error Logs para erros de transformação de todas as integrações

Erro de Envio

{{ tenant }}-load-error Logs para erros de envio de todas as integrações

Entendendo os logs

Cada arquivo de log contém dados estruturados em JSON que ajudam você a diagnosticar problemas. Abaixo estão exemplos de cenários comuns de sucesso e erro e como interpretá-los.

Extração com Sucesso

Quando uma extração é bem-sucedida, você verá um log como este:

{
  "type": "Error",
  "category": "Integration Extract - Success",
  "timestamp": "2025-12-09T23:39:05.458Z",
  "message": "Extract Success",
  "data": {
    "merchant": "tenant",
    "integrationName": "integration",
    "integrationId": "682693a60de87c17bbea7d85",
    "hasDatapoints": true,
    "total": 69376,
    "iterations": 1,
    "fail": 0,
    "success": 1
  }
}

Campos principais para Extração com sucesso:

Campo	Descrição
`data.hasDatapoints`	Se a integração conseguiu extrair algum datapoint
`data.total`	Número de datapoints extraídos
`data.iterations`	Número de tentativas de extração realizadas. Este é sempre a soma de `data.fail` e `data.success` para a execução. Também reflete o número de parâmetros de paralelização usados; por exemplo, se a paralelização estiver definida como `123,456` (2 parâmetros), então `iterations` será 2 para essa integração.
`data.fail`	Número de tentativas de extração com falha
`data.success`	Número de tentativas de extração bem-sucedidas

Erro de Extração

Quando uma extração falha, você verá um log como este:

{
  "type": "Error",
  "category": "Integration Extract - Failed",
  "timestamp": "2025-12-10T23:34:49.768Z",
  "message": "Extract Error",
  "data": {
    "merchant": "tenant",
    "integrationName": "integration",
    "integrationId": "682693a60de87c17bbea7d81",
    "total": 0,
    "iterations": 1,
    "fail": 1,
    "success": 0,
    "errors": ["HTTP status error @ ApiPage.extract(): status=500 response=\"Internal Server Error\""]
  }
}

Campos principais para erros de Extração:

Campo	Descrição
`data.total`	Número de datapoints extraídos
`data.iterations`	Número de tentativas de extração realizadas. Este é sempre a soma de `data.fail` e `data.success` para a execução. Também reflete o número de parâmetros de paralelização usados; por exemplo, se a paralelização estiver definida como `123,456` (2 parâmetros), então `iterations` será 2 para essa integração.
`data.fail`	Número de tentativas de extração com falha
`data.success`	Número de tentativas de extração bem-sucedidas
`data.errors`	Mensagens de erro retornadas/levantadas durante a extração (geralmente inclui status HTTP + resposta)

Erros de Extração frequentemente incluem códigos de status HTTP e mensagens de resposta, que podem ajudá-lo a identificar problemas de conectividade de API ou problemas de endpoint.

Erro de Transformação

Quando uma transformação falha, você verá um log como este:

{
  "type": "Error",
  "category": "Datapoint Transform",
  "timestamp": "2025-11-22T09:51:24.400Z",
  "message": "There was an error in transform-record operation",
  "data": {
    "merchant": "tenant",
    "integrationName": "integration",
    "integrationId": "6733572df58838c37514d907",
    "total": 1,
    "success": 0,
    "failed": 1,
    "errors": [
      "Error while executing the business rule example-doc with id 67570b4a1891fa735a486ae2: Cannot read property of undefined/null. Data is: {{ datapoint }}"
    ]
  }
}

Campos principais para erros de Transformação:

Campo	Descrição
`data.total`	Número de datapoints processados pela transformação
`data.failed`	Número de datapoints que falharam na transformação
`data.success`	Número de datapoints transformados com sucesso
`data.errors`	Detalhes do erro de transformação (aponta para a regra que falhou), também inclui o datapoint que causou o erro que pode ser identificado por `Data is: {{ datapoint }}`

Transformações simples não geram logs de erro de transformação, certifique-se de que o mapeamento está correto e corresponde exatamente aos nomes dos campos na origem

Erros de Transformação apontam para regras de negócio específicas que estão causando problemas. Verifique a mensagem de erro para o ID exato da regra.

Erro de Envio

Quando uma operação de envio falha, você verá um log como este:

{
  "type": "Error",
  "category": "Datapoint Load",
  "timestamp": "2025-12-10T17:03:30.527Z",
  "message": "There was an error processing requests",
  "data": {
    "merchant": "tenant",
    "integrationName": "integration",
    "integrationId": "6733572df58838c37514d902",
    "failed": 1,
    "errors": [
      "HTTP status error @ LoadService.load(): status=404 response={\"error\":{\"code\":\"OMS007\",\"message\":\"Register Not Found\",\"exception\":null}}"
    ],
    "requests": ["{{ request }}"]
  }
}

Campos principais para erros de Envio:

Campo	Descrição
`data.failed`	Número de requisições de envio com falha
`data.errors`	A resposta/erro retornado pela API de destino durante o envio
`data.requests`	O payload da requisição enviado para a API de destino (útil para reproduzir/debugar)

Buscar logs de uma integração específica

Para encontrar logs de uma execução de integração específica em todos os canais:

Copie o ID da integração:
Copie o integrationId da interface de integração no seu dashboard.
Busque no Slack:
Cole o ID na barra de busca do Slack.
Filtre para arquivos:
Filtre a busca para Arquivos para ver apenas arquivos de log JSON.
Revise os logs:
Abra o(s) arquivo(s) correspondente(s) para visualizar o log JSON completo dessa execução de integração.

Você pode buscar em todos os quatro canais simultaneamente usando o ID da integração, facilitando o rastreamento de uma execução completa de integração desde a extração até o envio.

Conexões

Regras de Negócio

Extração

Envio

Monitoramento

Monitoramento & Debug

Visão geral

Página de status da integração

Canais do Slack

Extração com Sucesso

Erro de Extração

Erro de Transformação

Erro de Envio

Entendendo os logs

Extração com Sucesso

Campos principais para Extração com sucesso:

Erro de Extração

Campos principais para erros de Extração:

Erro de Transformação

Campos principais para erros de Transformação:

Erro de Envio

Campos principais para erros de Envio:

Buscar logs de uma integração específica

​Visão geral

​Página de status da integração

​Canais do Slack

Extração com Sucesso

Erro de Extração

Erro de Transformação

Erro de Envio

​Entendendo os logs

​Extração com Sucesso

​Campos principais para Extração com sucesso:

​Erro de Extração

​Campos principais para erros de Extração:

​Erro de Transformação

​Campos principais para erros de Transformação:

​Erro de Envio

​Campos principais para erros de Envio:

​Buscar logs de uma integração específica

Visão geral

Página de status da integração

Canais do Slack

Entendendo os logs

Extração com Sucesso

Campos principais para Extração com sucesso:

Erro de Extração

Campos principais para erros de Extração:

Erro de Transformação

Campos principais para erros de Transformação:

Erro de Envio

Campos principais para erros de Envio:

Buscar logs de uma integração específica