Pular para o conteúdo principal

​
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.

​
Canais do Slack

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

Extração com Sucesso

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

Erro de Extração

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

Erro de Transformação

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

Erro de Envio

{{tenant}}-load-errorLogs 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:

CampoDescrição
data.hasDatapointsSe a integração conseguiu extrair algum datapoint
data.totalNúmero de datapoints extraídos
data.iterationsNú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.failNúmero de tentativas de extração com falha
data.successNú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:

CampoDescrição
data.totalNúmero de datapoints extraídos
data.iterationsNú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.failNúmero de tentativas de extração com falha
data.successNúmero de tentativas de extração bem-sucedidas
data.errorsMensagens 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:

CampoDescrição
data.totalNúmero de datapoints processados pela transformação
data.failedNúmero de datapoints que falharam na transformação
data.successNúmero de datapoints transformados com sucesso
data.errorsDetalhes 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:

CampoDescrição
data.failedNúmero de requisições de envio com falha
data.errorsA resposta/erro retornado pela API de destino durante o envio
data.requestsO 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:
  1. Copie o ID da integração:
    Copie o integrationId da interface de integração no seu dashboard.
  2. Busque no Slack:
    Cole o ID na barra de busca do Slack.
  3. Filtre para arquivos:
    Filtre a busca para Arquivos para ver apenas arquivos de log JSON.
  4. 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.