Antes de empezar

1. Si no tiene una cuenta en IBM Cloud, regístrese en IBM Cloud. Necesita un IBMid para trabajar en IBM Cloud.

2. Compruebe las regiones en las que está disponible el servicio IBM Cloud Logs Routing.

3. Compruebe que el usuario que está configurando IBM Cloud Logs Routing para la cuenta IBM Cloud® tiene permisos suficientes para gestionar el servicio IBM Cloud Logs Routing. Para obtener más información, consulte Gestión del acceso IAM para IBM Cloud Logs Routing.

   Necesita el rol de plataforma Adminsitrator para gestionar los recursos.

4. Instale las siguientes herramientas:

   • Descargue e instale la CLI de IBM Cloud®.

   • Descargue e instale jq para procesar la salida y consultar los resultados deseados.

5. Proporcionar o tener acceso a una instancia de IBM Cloud Logs. Para obtener más información, consulte Suministro de una instancia.

Creación de una autorización de servicio a servicio

Debe utilizar IBM Cloud® Identity and Access Management (IAM) para crear una autorización que conceda a IBM Cloud Logs Routing acceso a IBM Cloud Logs para que el servicio IBM Cloud Logs Routing pueda enviar registros al destino (target) de su instancia IBM Cloud Logs.

Debe tener el rol de remitente para IBM Cloud Logs antes de configurar el servicio para la autorización del servicio.

Complete los pasossiguientes:

1. En la consola de IBM Cloud, pulse Gestionar > Acceso (IAM) y seleccione Autorizaciones.

2. Pulse Crear.

3. Configure la cuenta de origen. Seleccione Esta cuenta.

4. Seleccione Logs Routing como servicio de origen. A continuación, establezca el ámbito de acceso en Todos los recursos.

5. Seleccione Cloud Logs como servicio de destino. A continuación, establezca el alcance del acceso en Todos los recursos, que concede acceso a todas las instancias de IBM Cloud Logs, o en una única instancia configurando Recursos basados en atributos seleccionados > Instancia de servicio.

   No se admiten otros atributos para este tipo de autorización.

6. En la sección Acceso al servicio, seleccione Remitente para asignar el acceso al servicio de origen que accede al servicio de destino.

7. Pulse Autorizar.

Para obtener más información, consulte Creación de una autorización S2S para conceder acceso al envío de registros a IBM Cloud Logs.

Configurar la ubicación de los metadatos primarios y la versión de la API

Complete los pasossiguientes:

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro >Ruta.

4. Pulse el separador Valores.

5. Haga clic en Editar junto al ajuste que desee modificar.

   Introduzca una ubicación de metadatos primaria.

   Establezca la versión de la API en 3.

Crear un destino

Complete los siguientes pasos para crear un objetivo:

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Seleccione Registro > Enrutamiento.

4. En la sección Objetivos, haga clic en Crear para abrir el panel de creación.

5. En Elegir destino, seleccione Buscar por instancia o Especificar CRN.

   Seleccione Buscar por instancia para elegir una instancia de IBM Cloud Logs de la tabla disponible en la cuenta

   Seleccione Especificar CRN para añadir el CRN de instancia IBM Cloud Logs de una instancia que se encuentra en una cuenta diferente.

6. En la sección de detalles del objetivo, complete las siguientes tareas:

   Introduzca el nombre del objetivo.

   Habilite la opción No configurado para establecer automáticamente su nuevo objetivo como objetivo predeterminado en la configuración de IBM Cloud Logs Routing.

7. Haga clic en Crear objetivo.

Configurar una ruta

Complete los siguientes pasos para crear un objetivo:

1. Conéctese a su cuenta IBM Cloud.

2. Pulse el icono Menú > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. En la pestaña Rutas, haga clic en Crear.

5. En la sección Reglas de enrutamiento, modifique la Acción de la Regla 1:

   Seleccione una Acción para la Regla 1:

   • Seleccione Enviar registros desde para que la regla dirija los registros de la plataforma a los objetivos asociados.

   • Seleccione Drop logs from para que la regla elimine los registros de la plataforma que coincidan con esta regla.

   Añada los filtros de inclusión para determinar los registros de plataforma enrutados a los objetivos especificados en la regla.

   • Seleccione una condición y especifique los valores de ubicación que deben coincidir con el filtro de inclusión.

   • Para añadir varios filtros de inclusión, haga clic en Añadir filtro para añadir filtros adicionales.

   Añada los objetivos que desea asociar a la regla seleccionando un objetivo de la lista. Si no tiene ningún objetivo definido, haga clic en Añadir objetivo para crear uno nuevo.

6. Haga clic en Añadir regla para añadir reglas adicionales a la ruta.

   El orden de las reglas de ruta afecta al comportamiento del enrutamiento. Las reglas se procesan en orden y una vez que una regla coincide, las reglas siguientes no se procesan.

   El orden de las reglas de enrutamiento puede modificarse haciendo clic en las flechas arriba y abajo situadas a la derecha de cada definición de regla.

   Si necesita eliminar una regla o filtro, haga clic en el icono Eliminar asociado a la regla o filtro.

   Puede configurar hasta 10 reglas por ruta.

7. Pulse Siguiente.

8. Introduzca un nombre para la ruta.

9. Revise la definición de la ruta asegurándose de que el orden de las reglas es el previsto.

   Para obtener más información, consulte Comprender la precedencia de enrutamiento.

10. Pulse Crear.

Verificación de que los registros se envían al objetivo de destino

Compruebe que los registros se envían a su instancia IBM Cloud Logs.

Complete los pasossiguientes:

1. Inicie la interfaz de usuario web IBM Cloud Logs para la instancia IBM Cloud Logs configurada como objetivo para recopilar registros de plataforma en una región. Esta es la instancia que seleccionó en el paso en el que configuró un objetivo.

2. Visualice los registros a través de vistas personalizadas. Para obtener más información, consulte Visualización de registros.

   Todos los registros de la plataforma se generan en JSON. Puede filtrar los registros de plataforma en su instancia seleccionando el valor de ibm-platform-logs como applicationName o ejecutando la consulta Lucene: coralogix.metadata.applicationName:"ibm-platform-logs"