Solução de Problemas de Conectores

Use informações de diagnóstico e solução de problemas para identificar e tratar problemas comuns que podem ocorrer ao trabalhar com o Connector Hub.

Consulte também Problemas Conhecidos do Connector Hub.

Não há Dados a Serem Movidos

Solucione problemas com a movimentação de dados por meio de conectores.

O conector não está movendo dados. Por exemplo, conectores, consulte Cenários de Hub de Conector.

Causa: Os dados não existem

A origem não contém dados correspondentes à consulta na configuração de origem do conector.

Para descobrir se existem dados na origem, faça o seguinte:

  • Obtenha logs de serviço para o conector. (Se necessário, ative logs primeiro.) Veja a seguir um exemplo de mensagem de log que indica uma execução bem-sucedida do conector, incluindo a quantidade de dados movidos:
    Service connector run succeeded - <number> messages (<number> bytes) written to target
  • Para logs de origem, pesquise os logs usando a consulta da configuração de origem do conector.
  • Para métricas de origem, pesquise as métricas.
  • Para fluxos de origem, consulte as métricas padrão do produtor do fluxo.

Solução: Atualize o conector

Altere a configuração do serviço de origem para especificar os dados existentes. Consulte Atualizando um Conector.

Causa: erro no nível do serviço

Um erro no serviço de origem, no serviço de destino ou no Connector Hub está impedindo a movimentação de dados.

Para descobrir se existe um erro no nível do serviço, faça o seguinte:

  • Obtenha logs de serviço para o conector. (Se necessário, ative logs primeiro.) Veja a seguir um exemplo de mensagem de log que indica um erro no nível do serviço:
    Connector run failed due to <type> error, Error Code : XXX <exception>
  • Exiba os seguintes gráficos de métricas para o conector:
    • Erros na origem
    • Erros no destino
    • Erros do Connector Hub

Solução: Atualize o conector

Altere a configuração do serviço de origem ou do serviço de destino. Consulte Atualizando um Conector.

Solução: Entre em contato com o suporte

Se você vir 5xx ou -1 em Erros do Hub do Conector, entre em contato com o suporte. Consulte Obtendo Ajuda e Entrando em Contato com o Suporte.

Causa: Autorização ausente

Você não tem autorização para gravar no serviço de destino.

Para descobrir se a autorização está ausente, obtenha logs de serviço para o conector. (Se necessário, ative logs primeiro.) Veja a seguir um exemplo de mensagem de log que indica autorização ausente:

Connector run failed due to <type> error, Error Code : 404 NotAuthorizedOrNotFound

Solução: Obtenha autorização

Verifique se você tem autorização, seja por meio da política padrão oferecida ao criar ou atualizar o conector ou por meio da política baseada em grupo. Consulte Autenticação e Autorização.
Observação

Suas políticas padrão aceitas podem levar alguns minutos para serem propagadas para regiões que não são sua região home. O conector não move dados até que as políticas sejam propagadas.

Causa: Payload não corresponde à configuração da função

O payload retornado pela tarefa de função não corresponde ao cabeçalho configurado na função usada pela tarefa de função. Por exemplo, um payload com JSON inválido é retornado por uma função com a configuração de cabeçalho a seguir.

headers={"Content-Type": "application/json"} 

Este problema é indicado pela mensagem de erro Expected JSON response from function, but received a different type

Remédio: Reconfigurar a função

Altere a configuração do cabeçalho ou atualize a função para retornar um payload JSON válido.

Desativação por Motivos Desconhecidos

Diagnostique e solucione problemas em um conector desativado.

O status de um conector é Deactivated e você não o desativou.

Alguém Também Desativou o Conector

O conector foi desativado por outra pessoa:

  • Outro usuário em sua organização
  • do Oracle Cloud Infrastructure

    Para determinadas condições de falha, um conector que falha continuamente é desativado automaticamente pela equipe de serviço da Oracle Cloud Infrastructure. Uma falha contínua de longo prazo pode indicar uma configuração inválida da origem ou do destino do conector.

Reativar o Conector

  1. Atualize o conector para garantir a configuração válida de sua origem e destino.
  2. (Opcional) Para obter detalhes sobre o fluxo de dados da origem de um conector para seu destino, ative logs para o conector.
  3. Reative o conector.
  4. Confirme se o conector move os dados com sucesso verificando os resultados esperados no serviço de destino.

Anúncio: Conector Desativado

Um anúncio na console indica "Conector Desativado".

Causa: Para determinadas condições de falha, um conector que falha continuamente é desativado automaticamente pela equipe de serviço no Oracle Cloud Infrastructure. Uma falha contínua de longo prazo pode indicar uma configuração inválida da origem ou do destino do conector.

Reativar o Conector

  1. Atualize o conector para garantir a configuração válida de sua origem e destino.
  2. (Opcional) Para obter detalhes sobre o fluxo de dados da origem de um conector para seu destino, ative logs para o conector.
  3. Reative o conector.
  4. Confirme se o conector move os dados com sucesso verificando os resultados esperados no serviço de destino.

Não é Possível Exibir a Consulta no Modo Básico

Diagnostique e solucione problemas ao exibir a consulta no modo Básico na Console.

A Console não permite a seleção do modo Básico depois que você edita a consulta no modo Avançado.

Causa: A consulta é muito complexa

A consulta inclui um ou mais dos seguintes itens não suportados no modo Básico:

  • Operador OR (exceto com filtros baseados em tipo quando você só usa logs do serviço Audit)
  • Funções (por exemplo: isNull())
  • select
  • summarize

Solução: Atualize a consulta

Atualize a consulta de modo que inclua apenas elementos suportados no modo Básico:

  • Logs de auditoria somente: Os filtros baseados em tipos podem usar o operador OR. Outros filtros devem usar o operador AND.
    Exemplo:
    ((type = value1 OR type = value2) AND field = value3 AND field1 = value4)
  • Qualquer combinação de logs (Logs de serviço, Logs personalizados e Logs do serviço Audit): Filtros unidos ao operador AND.
    Exemplo:
    (field = value AND field1 != value1)

Erro: Resposta JSON esperada da função, mas recebeu um tipo diferente

Esta mensagem de erro ocorre durante a execução de um conector.

Causa: Payload não corresponde à configuração da função

O payload retornado pela tarefa de função não corresponde ao cabeçalho configurado na função usada pela tarefa de função. Por exemplo, um payload com JSON inválido é retornado por uma função com a configuração de cabeçalho a seguir.

headers={"Content-Type": "application/json"} 

Este problema é indicado pela mensagem de erro Expected JSON response from function, but received a different type

Remédio: Reconfigurar a função

Altere a configuração do cabeçalho ou atualize a função para retornar um payload JSON válido.

Como Sei Quando Ocorreram os Problemas?

Identifique quando ocorrem problemas com conectores.

Procure os seguintes indicadores de problemas com conectores.

  • Atualização dos dados para um único conector: procure atrasos inesperados entre a movimentação de dados.
    1. Abra o menu de navegação e selecione Análise e IA. Em Mensagens, selecione Connector Hub.
    2. Escolha um Compartimento.
    3. Selecione o nome do conector desejado.
    4. Em Recursos, selecione Métricas.
    5. Revise o gráfico de métricas de Atualização de dados.
  • Atualização dos dados entre conectores: procure atrasos inesperados entre a movimentação de dados.
    1. Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Monitoramento, selecione Métricas do Serviço.
    2. Escolha o Compartimento para o qual você deseja exibir a atualização dos dados.
    3. Para Namespace da métrica, selecione oci_service_connector_hub.

    4. Analise os seguintes gráficos de métricas:
      • Atualização dos dados
  • Origem do log: se o conector recuperar dados de um log, ele poderá estar tentando obter mais do que a quantidade máxima de recuperação de dados por hora por conector (1 GB). Os dados de log no destino não são fornecidos se este problema continuar a ocorrer nas últimas 24 horas (a duração máxima para capturar dados ausentes nas transmissões anteriores pelo conector). Para determinar se esse problema está ocorrendo, crie alarmes para monitorar os indicadores a seguir.

    Observação

    Para saber as etapas para editar consultas de alarme no MQL, consulte Editando a Expressão MQL ao Atualizar um Alarme.
    Indicador (Métrica) Consulta de alarme no MQL, com comentários
    Dados com mais de 12 horas (Atualização dos dados)
    DataFreshness[1h].mean() > 43200000

    Comentários:

    • O valor 43200000 é o número de milissegundos em 12 horas.
    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.
    Erro na origem (qualquer erro) (Erros na origem
    ErrorsAtSource[15m].groupby(errorCode,connectorId).min() > 0

    Comentários:

    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.
    • Os resultados são agrupados por código de erro e conector.
    Erro interno na origem que não é resolvido após 15 minutos (5xx) (Erros na origem)
    ErrorsAtSource[15m]{errorCode =~ "5*"}.groupby(connectorId).sum() > 0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Comentários:

    • Erros internos podem indicar um problema na origem, o que pode atrasar a entrega dos dados.
    • Para acionar o alarme em intervalos mais curtos, altere o intervalo ([15m]).
    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.
    Erros de disparo na origem (429) (Erros na origem)
    ErrorsAtSource[15m]{errorCode = "429"}.groupby(connectorId).sum() >0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Comentários:

    • Para obter mais informações sobre erros de aceleração, consulte os limites documentados para o serviço relevante.
    • Por exemplo, para erros de aceleração relacionados à origem do serviço Streaming, consulte Limites de Recursos do Streaming. O disparo na origem do Streaming ocorre quando um conector tenta ler um stream de uma partição, outras chamadas para a mesma também estão ocorrendo e o número de chamadas excede os limites de serviço.
    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.
    Erros de comunicação de serviço na origem (-1) (Erros na origem)
    ErrorsAtSource[15m]{errorCode = "-1"}.groupby(connectorId).sum() >0 && 
    ErrorsAtSource[15m].groupby(connectorId).min() > 0
    Erro 404 na origem (Erros na origem)
    ErrorsAtSource[15m]{errorCode = "404"}.groupby(connectorId).sum() >0

    Comentários:

    • O conector não pode acessar o log ou ele não existe.
    • Certifique-se de que existam políticas para acessar o log especificado. Consulte Autenticação e Autorização.
    • Confirme se o log especificado existe pesquisando-o no Serviço Logging.
    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.
    Zero (0) bytes lidos (quando os dados são esperados) (Bytes lidos da origem)
    BytesReadFromSource[15m].groupby(connectorId).sum() == 0

    Comentários:

    • Se não ocorrerem erros na origem, destino ou tarefa, o log poderá não existir. Confirme se o log especificado existe pesquisando-o no Serviço Logging.
    • Ignore falhas ocasionais. Recomendamos definir o atraso do trigger de alarme como 30 minutos ou mais. Com essa configuração, o alarme só o alerta quando ocorrerem várias falhas consecutivas durante o período especificado.