Documentación de Oracle Cloud Infrastructure

Solución de Problemas de los Conectores

Utilice la información de solución de problemas para identificar y resolver las incidencias comunes que se pueden producir al trabajar con Connector Hub.

Consulte también Problemas conocidos de Connector Hub.

No se están moviendo datos

Solucione problemas con el movimiento de datos a través de conectores.

El conector no está moviendo datos. Por ejemplo, conectores, consulte Escenarios de Connector Hub.

Causa: los datos no existen

El origen no contiene datos que coincidan con la consulta en la configuración de origen del conector.

Para averiguar si existen datos en el origen, realice una de las siguientes acciones:

  • Obtenga registros de servicio para el conector. (Si es necesario, active los logs primero). A continuación, se muestra un mensaje de log de ejemplo que indica una ejecución correcta del conector, incluida la cantidad de datos movidos:
    Service connector run succeeded - <number> messages (<number> bytes) written to target
  • Para los logs de origen, busque los logs mediante la consulta de la configuración de origen del conector.
  • Para las métricas de origen, consulte las métricas.
  • Para flujos de origen, consulte las métricas de productor por defecto del flujo.

Solución: Actualizar el conector

Cambie la configuración del servicio de origen para especificar los datos que existen. Consulte Actualización de un conector.

Causa: error de nivel de servicio

Un error en el servicio de origen, el servicio de destino o el servicio Connector Hub está impidiendo el movimiento de datos.

Para averiguar si existe un error de nivel de servicio, realice una de las siguientes acciones:

  • Obtenga registros de servicio para el conector. (Si es necesario, active los logs primero). A continuación, se muestra un mensaje de log de ejemplo que indica un error de nivel de servicio:
    Connector run failed due to <type> error, Error Code : XXX <exception>
  • Consulte los siguientes gráficos de métricas para el conector:
    • Errores en origen
    • Errores en el destino
    • Errores de hub de conector

Solución: Actualizar el conector

Cambie la configuración del servicio de origen o de destino. Consulte Actualización de un conector.

Solución: Póngase en contacto con soporte

Si ve 5xx o -1 en Errores del hub de conector, póngase en contacto con los Servicios de Soporte. Consulte Obtención de ayuda y contacto con los Servicios de Soporte.

Causa: falta autorización

No tiene autorización para escribir en el servicio de destino.

Para averiguar si falta la autorización, obtenga logs de servicio para el conector. (Si es necesario, active los logs primero). A continuación, se muestra un mensaje de log de ejemplo que indica que falta autorización:

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

Solución: obtener autorización

Asegúrese de tener autorización, ya sea mediante la política por defecto que se ofrece al crear o actualizar el conector o mediante una política basada en grupos. Consulte Acceso a los servicios Origen, Tarea y Destino.
Nota

Las políticas por defecto aceptadas podrían tardar varios minutos en propagarse a regiones que no sean su región principal. El conector no mueve datos hasta que se propaguen las políticas.

Desactivación para motivos desconocidos

Solucionar problemas de un conector desactivado.

El estado de un conector es Deactivated y no lo ha desactivado.

Alguien desactivó el conector

Otra persona desactivó el conector:

  • Otro usuario de su organización
  • Oracle Cloud Infrastructure

    Para determinadas condiciones de fallo, el equipo de servicio de Oracle Cloud Infrastructure desactiva automáticamente un conector que falla continuamente. Este fallo continuo a largo plazo puede indicar una configuración no válida del origen o destino del conector.

Reactivar el conector

  1. Actualice el conector para garantizar una configuración válida de su origen y destino.
  2. (Opcional) Para obtener detalles sobre el flujo de datos desde el origen de un conector hasta su destino, active los logs para el conector.
  3. Vuelva a activar el conector.
  4. Confirme que el conector mueve datos correctamente comprobando los resultados esperados en el servicio de destino.

Anuncio: Conector desactivado

Un anuncio de consola indica "Conector desactivado".

Causa: para determinadas condiciones de fallo, el equipo de servicio de Oracle Cloud Infrastructure desactiva automáticamente un conector que falla continuamente. Este fallo continuo a largo plazo puede indicar una configuración no válida del origen o destino del conector.

Reactivación del conector

  1. Actualice el conector para garantizar una configuración válida de su origen y destino.
  2. (Opcional) Para obtener detalles sobre el flujo de datos desde el origen de un conector hasta su destino, active los logs para el conector.
  3. Vuelva a activar el conector.
  4. Confirme que el conector mueve datos correctamente comprobando los resultados esperados en el servicio de destino.

No se puede ver la consulta en modo Básico

Solucione problemas al ver la consulta en modo Básico en la consola.

La consola no permite seleccionar el modo básico después de editar la consulta en modo avanzado.

Causa: la consulta es demasiado compleja

La consulta incluye uno o más de los siguientes elementos no soportados en modo básico:

  • Operador OR (excepto con filtros basados en tipos cuando solo se utilizan logs de auditoría)
  • Funciones (por ejemplo: isNull())
  • select
  • summarize

Solución: Actualizar la consulta

Actualice la consulta para que solo incluya elementos soportados en modo Básico:

  • Solo logs de auditoría: los filtros basados en tipo pueden utilizar el operador OR. Otros filtros deben utilizar el operador AND.
    Ejemplo: 
    ((type = value1 OR type = value2) AND field = value3 AND field1 = value4)
  • Cualquier combinación de logs (logs de servicio, logs personalizados y logs de auditoría): filtros unidos con el operador AND.
    Ejemplo:
    (field = value AND field1 != value1)

¿Cómo sé cuándo ocurren los problemas?

Identifique cuándo se producen problemas con los conectores.

Busque los siguientes indicadores de problemas con conectores.

  • Actualización de datos para un único conector: busque tiempos inesperados entre el movimiento de datos.
    1. Abra el menú de navegación y seleccione Análisis e IA. En Mensajería, seleccione Hub de conector.
    2. Seleccione un Compartimento.
    3. Seleccione el nombre del conector que desea.
    4. En Recursos, seleccione Métricas.
    5. Revise el gráfico de métricas Actualización de datos.
  • Actualización de datos en los conectores: busque tiempos inesperados entre el movimiento de datos.
    1. Abra el menú de navegación y seleccione Observación y gestión. En Supervisión, seleccione Métricas de servicio.
    2. Seleccione el compartimento que contiene los conectores cuya actualización de datos desea ver.

    3. Para Espacio de nombre de métrica, seleccione oci_service_connector_hub.

    4. Revise los siguientes gráficos de métricas: 
      • Actualización de datos

  • Origen de registro: si el conector recupera datos de un log, puede estar intentando más de la cantidad máxima de recuperación por hora de datos por conector (1 GB). Los datos de registro en el destino no se entregan si este problema continúa ocurriendo después de 24 horas (la duración máxima para capturar datos perdidos en transmisiones anteriores por el conector). Para determinar si se está produciendo este problema, cree alarmas para supervisar los siguientes indicadores.

    Nota

    Para conocer los pasos para editar consultas de alarma en MQL, consulte Edición de la expresión MQL al actualizar una alarma.
    Indicador (Métrica) Consulta de alarma en MQL, con comentarios
    Datos con más de 12 horas (Actualización de datos 
    DataFreshness[1h].mean() > 43200000

    Comentarios:

    • El valor 43200000 es el número de milisegundos en 12 horas.
    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.
    Error en el origen (cualquier error) (Errores en el origen) 
    ErrorsAtSource[15m].groupby(errorCode,connectorId).min() > 0

    Comentarios:

    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.
    • Los resultados se agrupan por código de error y conector.
    Errores internos en el origen que no se resuelven después de 15 minutos (5xx) (Errores en el origen) 
    ErrorsAtSource[15m]{errorCode =~ "5*"}.groupby(connectorId).sum() > 0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Comentarios:

    • Los errores internos podrían indicar un problema en el origen, lo que podría retrasar la entrega de datos.
    • Para activar la alarma a intervalos más cortos, cambie el intervalo ([15m]).
    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.
    Errores de limitación en el origen (429) (Errores en el origen) 
    ErrorsAtSource[15m]{errorCode = "429"}.groupby(connectorId).sum() >0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0

    Comentarios:

    • Para obtener más información sobre los errores de limitación, consulte los límites documentados para el servicio correspondiente.
    • Por ejemplo, para los errores de limitación relacionados con el origen de Streaming, consulte Límites sobre los recursos de Streaming. La limitación en el origen de Streaming se produce cuando un conector intenta leer un flujo de una partición, también se producen otras llamadas a la misma partición y el número de llamadas supera los límites de servicio.
    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.
    Errores de comunicación de servicio en el origen (-1) (Errores en el origen) 
    ErrorsAtSource[15m]{errorCode = "-1"}.groupby(connectorId).sum() >0 && 
ErrorsAtSource[15m].groupby(connectorId).min() > 0
    Error 404 en el origen (Errores en el origen) 
    ErrorsAtSource[15m]{errorCode = "404"}.groupby(connectorId).sum() >0

    Comentarios:

    • El conector no puede acceder al log o no existe.
    • Asegúrese de que existen políticas para acceder al log especificado. Consulte Acceso a los servicios Origen, Tarea y Destino.
    • Para confirmar que el log especificado existe, búsquelo en Logging.
    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.
    Lectura de cero (0) bytes (cuando se esperan datos) (Bytes leídos de origen) 
    BytesReadFromSource[15m].groupby(connectorId).sum() == 0

    Comentarios:

    • Si no se producen errores en origen, destino o tarea, es posible que el log no exista. Para confirmar que el log especificado existe, búsquelo en Logging.
    • Ignore los fallos ocasionales. Se recomienda configurar el retraso del disparador de alarma en 30 minutos o más. Con esta configuración, la alarma solo le avisa cuando se producen varios fallos consecutivos durante el período de tiempo especificado.