Conectores

• Consola
• CLIENTE
• API

• 1. Abra el menú de navegación y seleccione Observación y gestión. En Registro, seleccione Conectores.
  2. En la página Conectores, seleccione un compartimento.
  3. Haga clic en Crear conector.
  4. En la página Crear conector, introduzca un nombre fácil de recordar para el nuevo conector y una descripción opcional. Evite introducir información confidencial.
  5. Seleccione el compartimento en el que desea almacenar el nuevo conector.
  6. Seleccione el servicio Origen que contiene los datos que desea transferir:
     • Logging (Registro): transferir datos del log del servicio Logging. Consulte Registro.
     • Monitoring: transferencia de puntos de datos de métricas desde el servicio Monitoring. Consulte Supervisión.
     • Cola: transfiere mensajes de una cola en el servicio. Consulte Queue.
     • Streaming: transfiere datos de flujo del servicio Streaming. Consulte Streaming.
  7. En Destino, seleccione el servicio al que desea transferir los datos:
     • Functions: envía datos a una función.
     • Logging Analytics: envía datos a un grupo de logs.
     • Monitoring: envía puntos de datos de métrica al servicio de Monitoring.
     • Notifications: envía datos a un tema.
     • Object Storage: envía datos a un cubo.
     • Streaming: envía datos a un flujo.
  8. (Opcional) Para activar los logs de servicio para el nuevo conector, seleccione el conmutador Logs y proporcione los siguientes valores:
     • Categoría de log: el valor Seguimiento de conector se selecciona automáticamente.
     • Compartimento: seleccione el compartimento que desea para almacenar los logs de servicio para el conector.
     • Grupo de logs: seleccione el grupo de logs para el que desea almacenar los logs de servicio. Para crear un nuevo grupo de logs, seleccione Create new group y, a continuación, introduzca un nombre.
     • Nombre de log: si lo desea, introduzca un nombre para el log.
     • Mostrar opciones avanzadas:
       • Retención de logs: si lo desea, especifique el tiempo que se conservarán los logs de servicio (valor por defecto: 30 días).
  9. En Configurar conexión de origen, introduzca valores para el origen seleccionado.

     Registro

     • Nombre de compartimento: compartimento que contiene el log que desea.
     • Grupo de logs: grupo de logs que contiene el log que desea.

       Para obtener información sobre el esquema de entrada de log, consulte LogEntry.

     • Logs: log que desea. Para filtrar los logs que aparecen en este campo, consulte el siguiente paso.

     Supervisión

     • Compartimento de métricas: seleccione el compartimento que contiene las métricas que desea.
     • Espacios de nombres: seleccione uno o más espacios de nombres de métricas que incluyan las métricas que desee. Se recuperan todas las métricas de los espacios de nombres seleccionados.

       Los espacios de nombres deben empezar por "oci_". Ejemplo: oci_computeagent.

     • Para agregar espacios de nombres de métricas de otro compartimento, seleccione + Otro compartimento.

       El número máximo de compartimentos de métricas por origen de Monitoring es 5. El número máximo de espacios de nombres por origen de Monitoring (en todos los compartimentos de métricas) es 50. A continuación, se muestran ejemplos de juegos de compartimentos en un único origen que permanecen dentro de este máximo:

       • 5 compartimentos de métricas con 10 espacios de nombres cada uno
       • 3 compartimentos de métricas con un número variable de espacios de nombres (20, 20, 10)
       • 1 compartimento de métricas con 50 espacios de nombres

     Cola

     • Compartimento: seleccione el compartimento que contiene la cola que desea.
     • Cola: seleccione la cola que contiene los mensajes que desea.

     • Filtro de canal (en Filtrado de mensajes) (opcional): para filtrar mensajes de canales de la cola, introduzca un valor.

       Por ejemplo, para filtrar mensajes por ID de canal, introduzca el ID de canal.

       Para conocer los valores soportados, consulte channelFilter en GetMessages (API de Queue).

     Nota
     
     Un mensaje que se ha transferido al destino del conector se considera "consumido". Para cumplir los requisitos del servicio Queue, el conector suprime los mensajes transferidos de la cola de origen. Para obtener más información, consulte Uso de mensajes.

     Streaming

     Nota
     
     Se soporta la configuración de punto final privado. Para utilizar un punto final privado, consulte Requisitos previos de punto final privado para flujos.

     • Compartimento: seleccione el compartimento que contiene el flujo que desea.
     • Pool de flujos: seleccione el pool de flujos que contiene el flujo que desea.
     • Stream: seleccione el nombre del stream del que desea recibir datos.
     • Leer posición: especifique la posición del cursor desde la que empezar a leer el flujo.
       • Más reciente: inicia la lectura de los mensajes publicados después de crear el conector.
         • Si la primera ejecución de un nuevo conector con esta configuración es correcta, mueve los datos de la hora de creación del conector. Si falla la primera ejecución (como las políticas que faltan), después de la resolución, el conector mueve los datos de la hora de creación del conector o, si la hora de creación está fuera del período de retención, los datos más antiguos disponibles en el flujo. Por ejemplo, considere un conector creado a las 10 a.m. para un flujo con un período de retención de dos horas. Si las ejecuciones fallidas se resuelven a las 11 a. m., el conector mueve los datos de las 10 a. m. Si las ejecuciones fallidas se resuelven a las 1 p.m., el conector mueve los datos disponibles más antiguos del flujo.
         • Las ejecuciones posteriores mueven los datos desde la siguiente posición del flujo. Si falla una ejecución posterior, después de la resolución, el conector mueve los datos de la siguiente posición del flujo o de los datos más antiguos disponibles del flujo, según el período de retención del flujo.
       • Recortar horizonte: inicia la lectura desde el mensaje más antiguo disponible del flujo.
         • Si la primera ejecución de un nuevo conector con esta configuración se realiza correctamente, mueve los datos de los datos más antiguos disponibles en el flujo. Si falla la primera ejecución (como las políticas que faltan), después de la resolución, el conector mueve los datos más antiguos disponibles en el flujo, independientemente del período de retención del flujo.
         • Las ejecuciones posteriores mueven los datos desde la siguiente posición del flujo. Si falla una ejecución posterior, después de la resolución, el conector mueve los datos de la siguiente posición del flujo o de los datos más antiguos disponibles del flujo, según el período de retención del flujo.

  10. (Opcional) En Tarea de filtro de log (disponible para el origen de Logging), introduzca valores para filtrar los logs.

      Para especificar valores de atributo para logs de auditoría (_Audit):

      • Tipo de filtro: seleccione Atributo.
      • Nombre de atributo: seleccione el atributo de log de auditoría que desea.
      • Valores de atributo: especifique valores para el atributo de log de auditoría seleccionado.

      Para especificar eventos para logs de auditoría (_Audit):

      • Tipo de filtro: seleccione Tipo de evento.
      • Nombre de servicio: seleccione el servicio que contiene el evento que desea.
      • Tipo de evento: seleccione el evento que desea.

      Para especificar valores de propiedad para logs de servicio o logs personalizados (no _Audit):

      • Propiedades: seleccione la propiedad que desee.
      • Operador: seleccione el operador que desea utilizar para filtrar los valores de propiedad.
      • Valor: especifique el valor de propiedad que desea.

      Para revisar las consultas soportadas para filtrar logs de origen, consulte Referencia de consulta de log para Connector Hub.

  11. (Opcional) En Configurar tarea de función, configure una tarea de función para procesar datos del origen mediante el servicio de funciones:
      • Seleccionar tarea: seleccione Función.
      • Compartimento: seleccione el compartimento que contiene la función que desea.
      • Aplicación de función: seleccione el nombre de la aplicación de función que incluye la función que desea.
      • Función: seleccione el nombre de la función que desea utilizar para procesar los datos recibidos del origen.

        Para que lo utilice el conector como una tarea, la función debe estar configurada para devolver una de estas respuestas:

        • Lista de entradas JSON (debe definir la cabecera de respuesta Content-Type=application/json)
        • Entrada JSON única (debe definir la cabecera de respuesta Content-Type=application/json)
        • Objeto binario único (debe definir la cabecera de respuesta Content-Type=application/octet-stream)
      • Mostrar opciones adicionales: seleccione este enlace y especifique límites para cada lote de datos enviado a la función. Para utilizar la configuración manual, proporcione valores para el límite de tamaño de lote (KB) y el límite de tiempo de lote (segundos).

      Consideraciones para las tareas de función:

      • Connector Hub no analiza la salida de la tarea de función. La salida de la tarea de función se escribe tal cual en el destino. Por ejemplo, al utilizar un destino de Notifications con una tarea de función, todos los mensajes se envían como blobs de JSON no procesados.
      • Las funciones se llaman de forma síncrona con 6 MB de datos por llamada. Si los datos superan los 6 MB, el conector llama de nuevo a la función para mover los datos que superen el límite. Estas llamadas se manejan secuencialmente.
      • Las funciones se pueden ejecutar durante un máximo de cinco minutos. Consulte Detalles de entrega.
      • Las tareas de función se limitan a funciones escalares.
  12. Si ha seleccionado Funciones como destino, en Configurar destino, configure la función a la que enviar los datos de log. A continuación, salte al paso 17.
      • Compartimento: seleccione el compartimento que contiene la función que desea.
      • Aplicación de función: seleccione el nombre de la aplicación de función que contiene la función que desea.
      • Función: seleccione el nombre de la función a la que desea enviar los datos.
      • Mostrar opciones adicionales: seleccione este enlace y especifique límites para cada lote de datos enviado a la función. Para utilizar la configuración manual, proporcione valores para el límite de tamaño de lote (ya sea KB o número de mensajes) y el límite de tiempo de lote (segundos).

        Por ejemplo, limite el tamaño del lote seleccionando 5.000 kilobytes o 10 mensajes. Un límite de tiempo de lote de ejemplo es de 5 segundos.

      Consideraciones para destinos de Functions:

      • El conector vacía los datos de origen como una lista de JSON en lotes. El tamaño máximo de lote o carga útil es de 6 MB.
      • Las funciones se llaman de forma síncrona con 6 MB de datos por llamada. Si los datos superan los 6 MB, el conector llama de nuevo a la función para mover los datos que superen el límite. Estas llamadas se manejan secuencialmente.
      • Las funciones se pueden ejecutar durante un máximo de cinco minutos. Consulte Detalles de entrega.
      • No devuelve datos de destinos de Functions a conectores. El hub de conector no lee los datos devueltos de los destinos de Functions.
  13. Si ha seleccionado Logging Analytics como destino, en Configurar destino, configure el grupo de logs al que enviar los datos de log. A continuación, salte al paso 17.
      • compartimento: seleccione el compartimento que contiene el grupo de logs que desea.
      • Grupo de registros: seleccione el grupo de registros que desee.
      • Identificador de origen de log (solo para el origen de Streaming): seleccione el origen de log.
  14. Si ha seleccionado Supervisión como destino, en Configurar destino, configure la métrica a la que enviar los datos de log. A continuación, salte al paso 17.
      • Compartimento: seleccione el compartimento que contiene la métrica que desea.
      • Espacio de nombre de métrica: seleccione los espacios de nombre de métrica que incluyen la métrica que desea. Puede seleccionar un espacio de nombres existente o introducir un nuevo espacio de nombres.

        Al escribir un nuevo espacio de nombres, pulse Intro para enviarlo.

        Para un nuevo espacio de nombres de métrica, no utilice el prefijo oci_ reservado. Las métricas no se ingieren cuando se utilizan prefijos reservados. Consulte Publicación de métricas personalizadas y Referencia de PostMetricData (API).

      • Métrica: seleccione el nombre de la métrica a la que desea enviar los datos. Puede seleccionar una métrica existente o introducir una nueva métrica.

        Al escribir un nuevo nombre de métrica, pulse Intro para enviarlo.

        Para una nueva métrica, no utilice el prefijo oci_ reservado. Las métricas no se ingieren cuando se utilizan prefijos reservados. Consulte Publicación de métricas personalizadas y Referencia de PostMetricData (API).

      • Agregar dimensiones: seleccione este botón para configurar las dimensiones de forma opcional. Se abre el panel Agregar dimensiones.

        Las seis últimas filas de datos de log se recuperan del log especificado en Configurar origen.

        Especifique un par de claves nombre-valor para cada dimensión a la que desee enviar datos. El nombre puede ser personalizado y el valor puede ser estático o una ruta para evaluar. Utilice dimensiones para filtrar los datos después de mover los datos del log a una métrica. Para obtener un caso de uso de una dimensión de ejemplo, consulte Escenario: crear dimensiones para un destino de Monitoring.

        Para extraer datos (valor de ruta)

        1. En Seleccionar ruta, seleccione la flecha hacia abajo para el log que desea.

           Se muestran las rutas para el log ampliado.

        2. Seleccione la casilla de control de la ruta que desee.

           En la siguiente imagen se muestra un ejemplo de una ruta seleccionada (bucketName) y una ruta no seleccionada (eTag):

           

           En Editar ruta, los campos Nombre de dimensión y Valor se rellenan automáticamente desde la ruta seleccionada.

           Si no hay datos de log disponibles, puede introducir manualmente un valor de ruta con un nombre de dimensión personalizado en Editar ruta. La ruta debe empezar por logContent, utilizando la notación de puntos (.) o de índice ([]). El punto y el índice son los únicos selectores de JMESPath soportados. Por ejemplo:

           • logContent.data (notación de puntos)
           • logContent.data[0].content (notación de índice)

           Para obtener más información sobre la notación de ruta válida, consulte JmesPathDimensionValue.

        3. También puede editar el nombre de dimensión.

        Para etiquetar datos (valor estático)

        • En Valores estáticos, seleccione + Otro valor estático y, a continuación, introduzca un nombre y un valor de dimensión. Por ejemplo, introduzca traffic y customer.

      Nota
      
      Para nuevas métricas (personalizadas), el espacio de nombres y la métrica especificados se crean la primera vez que el conector mueve datos del origen al servicio Monitoring. Para comprobar la existencia de datos movidos, consulte la nueva métrica mediante la consola, la CLI o la API. Consulte Creación de una consulta para una métrica personalizada.

      Elementos incluidos en la métrica

      Además de cualquier par de clave de nombre-valor de dimensión que especifique en Configurar dimensiones, se incluyen las siguientes dimensiones con la métrica:

      • connectorId: OCID del conector al que se aplican las métricas.
      • connectorName: nombre del conector al que se aplican las métricas.
      • connectorSourceType: servicio de origen al que se aplican las métricas.

      El registro de hora de cada punto de datos de métrica es el registro de hora del mensaje de log correspondiente.

  15. Si ha seleccionado Notificaciones como destino, en Configurar destino, configure el tema al que desea enviar los datos del log. A continuación, salte al paso 17.
      • Compartimento: seleccione el compartimento que contiene el tema que desea.
      • Tema: seleccione el nombre del tema al que desea enviar los datos.
      • Formato de mensaje: seleccione la opción que desea:
        Nota
        
        Las opciones de formato de mensaje están disponibles para conectores con origen de Logging únicamente. Estas opciones no están disponibles para conectores con tareas de función. Cuando las opciones de Formato de mensaje no están disponibles, los mensajes se envían como blobs JSON sin formato.
        • Enviar mensajes con formato: diseño simplificado y fácil de recordar.

          Para ver los protocolos de suscripción y los tipos de mensajes soportados para los mensajes con formato, consulte Formato fácil de recordar.

        • Enviar mensajes sin formato: blob JSON sin formato.

      Consideraciones para los destinos de Notifications:

      • El tamaño máximo de mensaje para el destino Notifications es 128 KB. Cualquier mensaje que exceda el tamaño máximo se borra.
      • Los mensajes SMS muestran resultados inesperados para determinadas configuraciones de conector. Este problema se limita a los temas que contienen suscripciones de SMS para las configuraciones de conector indicadas. Para obtener más información, consulte Varios mensajes SMS para una sola notificación.
  16. Si ha seleccionado Object Storage como destino, en Configurar destino, configure el cubo al que enviar los datos de log. A continuación, salte al paso 17.
      • Compartimento: seleccione el compartimento que contiene el cubo que desea.
      • Cubo: seleccione el nombre del cubo al que desea enviar los datos.
      • Prefijo de nombre de objeto: si lo desea, introduzca un valor de prefijo.
      • Mostrar opciones adicionales: seleccione este enlace y, opcionalmente, introduzca valores para el tamaño de lote (en MB) y el tiempo de lote (en milisegundos).

      Consideraciones para destinos de Object Storage:

      • Detalles de renovación de lote:

        • Tamaño de renovación de lote: 100 MB
        • Tiempo de renovación de lote: 7 minutos

      • Los archivos guardados en Object Storage se comprimen con gzip.

      • Formato de los datos movidos desde un origen de supervisión: objetos. El conector particiona los datos de origen de Monitoring por espacio de nombres de métrica y escribe los datos de cada grupo (espacio de nombres) en un objeto. Cada nombre de objeto incluye los siguientes elementos.

        <object_name_prefix>/<service_connector_ocid>/<metric_compartment_ocid>/<metric_namespace>/<data_start_timestamp>_<data_end_timestamp>.<sequence_number>.<file_type>.gz

        Dentro de un objeto, cada juego de puntos de datos se agrega a una nueva línea.

  17. Si ha seleccionado Flujo como destino, en Configurar destino, configure el flujo al que enviar los datos de log.
      Nota
      
      Está soportada la configuración de punto final privado. Para utilizar un punto final privado, consulte Requisitos previos de punto final privado para flujos.

      • Compartimento: seleccione el compartimento que contiene el flujo que desea.
      • Flujo: seleccione el nombre del flujo al que desea enviar los datos.

      Consideraciones para destinos de Streaming:

      • Formato de los datos movidos desde un origen de Monitoring: cada objeto se escribe como un mensaje independiente.
  18. Para aceptar políticas por defecto, seleccione el enlace Crear proporcionado para cada política por defecto.

      Las políticas por defecto se ofrecen para cualquier autorización necesaria para que este conector acceda a los servicios de origen, tarea y destino.

      Puede obtener esta autorización mediante estas políticas por defecto o mediante políticas basadas en grupos. Las políticas por defecto se ofrecen cada vez que utiliza la consola para crear o editar un conector. La única excepción es cuando la política exacta ya existe en IAM, en cuyo caso no se ofrece la política por defecto. Para obtener más información sobre este requisito de autorización, consulte Autenticación y autorización.

      • Si no tiene permisos para aceptar políticas por defecto, póngase en contacto con el administrador.
      • Las políticas creadas automáticamente permanecen cuando se suprimen los conectores. Como mejor práctica, suprima las políticas asociadas al suprimir el conector.

      Para revisar una política recién creada, seleccione el enlace de vista asociado.

  19. (Opcional) Agregue una o más etiquetas al conector: seleccione Mostrar opciones avanzadas para mostrar la sección Agregar etiquetas.
      Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
  20. Haga clic en Crear.

• Utilice el comando oci sch service-connector create y los parámetros necesarios para crear un conector:

  Comando

  CopiarProbar

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<source_in_JSON>] --target [<target_in_JSON>]

  Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI.

• Ejecute la operación CreateServiceConnector para crear un conector.