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
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
Solução: Entre em contato com o suporte
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
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
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
- Atualize o conector para garantir a configuração válida de sua origem e destino.
- (Opcional) Para obter detalhes sobre o fluxo de dados da origem de um conector para seu destino, ative logs para o conector.
- Reative o conector.
- 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
- Atualize o conector para garantir a configuração válida de sua origem e destino.
- (Opcional) Para obter detalhes sobre o fluxo de dados da origem de um conector para seu destino, ative logs para o conector.
- Reative o conector.
- Confirme se o conector move os dados com sucesso verificando os resultados esperados no serviço de destino.
Anúncio: Ação Necessária para Impedir a Desativação do Conector
Um anúncio na console declara "Ação Necessária para Impedir a Desativação do Conector".
Causa: O conector está falhando consistentemente.
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 operadorAND
.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
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.
- Abra o menu de navegação e selecione Análise e IA. Em Mensagens, selecione Connector Hub.
- Escolha um Compartimento.
- Selecione o nome do conector desejado.
- Em Recursos, selecione Métricas.
- 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.
- Abra o menu de navegação e selecione Observabilidade e Gerenciamento. Em Monitoramento, selecione Métricas do Serviço.
- Escolha o Compartimento para o qual você deseja exibir a atualização dos dados.
-
Para Namespace da métrica, selecione oci_service_connector_hub.
- 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.
- O valor