Creación de un conector con un origen de registro

• Consola
• CLI
• API

• 1. En la página de lista Conectores, seleccione Crear conector. Si necesita ayuda para buscar la página de lista, consulte Listado de conectores.
  2. 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.
  3. Seleccione el compartimento en el que desea almacenar el nuevo conector.
  4. En Configurar conector, en Origen, seleccione Registro.
  5. Para Destino, seleccione el servicio al que desea transferir los datos de log:
     • Functions: envía datos de log a una función.
     • Logging Analytics: envía datos de log a un grupo de logs.
     • Monitoring: envía datos de log a puntos de datos de métrica al servicio de Monitoring.
     • Notifications: envía datos de log a un topic.
     • Object Storage: envía datos de log a un bucket.
     • Streaming: envía datos de log a un flujo.
  6. (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).
  7. En Configurar conexión de origen, seleccione el log de origen:
     • 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.
  8. (Opcional) En Tarea de filtro de log, introduzca valores para filtrar el grupo de logs y el log seleccionados.

     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):

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

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

  9. (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 las siguientes 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 gestionan de forma secuencial.
     • Las funciones se pueden ejecutar durante un máximo de cinco minutos. Consulte Detalles de entrega.
     • Las tareas de función están limitadas a funciones escalares.
  10. 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 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 gestionan de forma secuencial.
      • 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.
  11. 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 logs: seleccione el grupo de logs que desee.
  12. Si ha seleccionado Supervisión como destino, en Configurar destino, configure la métrica a la que enviar los datos del log. A continuación, salte al paso 17.
      • Compartimento: seleccione el compartimento que contiene la métrica que desea.
      • pace 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 uno nuevo.

        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.

        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.

           Las rutas se muestran 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.

  13. Si ha seleccionado Notificaciones como destino, en Configurar destino, configure el tema al que enviar los datos de 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.
  14. Si ha seleccionado Object Storage como destino, en Configurar destino, configure el cubo al que enviar los datos del 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: opcionalmente, 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.

  15. Si ha seleccionado Flujo como destino, en Configurar destino, configure el flujo al que enviar los datos de log.
      Nota
      
      Para seleccionar un pool de flujos y un flujo para un conector, debe tener autorización para leer el pool de flujos y el flujo. Consulte Políticas de IAM (protección de Connector Hub). La configuración de punto final privado está soportada. 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.
  16. 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.

  17. (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.
  18. Haga clic en Crear.

  Comienza el proceso de creación y se muestra su progreso. Al finalizar, se abre la página de detalles del conector.

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

  oci sch service-connector create --display-name "<display_name>" --compartment-id <compartment_OCID> --source [<logging_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.

  Para crear un conector con un origen de registro, rellene source en la solicitud (CreateServiceConnectorDetails) con los detalles de registro. Por ejemplo, consulte LoggingSourceDetails.