Iniciación a IBM® Cloud Logs Routing
Utilice el servicio IBM Cloud Logs Routing para dirigir los registros de la plataforma desde su cuenta IBM Cloud al destino elegido.
Con el lanzamiento de IBM Cloud Logs Routing REST API V3, puede migrar su cuenta para utilizar la API V3 de modo que pueda enrutar los registros de la plataforma a varios destinos y gestionar el servicio a nivel de cuenta de empresa utilizando controles de acción de IAM de empresa. Para obtener más información sobre la migración, consulte Migración para utilizar IBM Cloud Logs Routing REST API V3. Si tiene una cuenta nueva, siga los pasos indicados en Introducción a varios destinos.
Complete los siguientes pasos para empezar a utilizar IBM® Cloud Logs Routing:
Antes de empezar
-
Si no tiene una cuenta en IBM Cloud, regístrese en IBM Cloud. Necesita un IBMid para trabajar en IBM Cloud.
-
Para configurar los registros de la plataforma, debe configurar los inquilinos y los destinos en su cuenta IBM Cloud.
Un tenant es la configuración específica de la cuenta de IBM Cloud Logs Routing que se ejecuta dentro de una región. Puede definir hasta 1 destino por inquilino y por región. El objetivo define hacia dónde se dirigen los registros.
Para obtener más información, consulte Más información sobre IBM Cloud Logs Routing.
-
Compruebe las regiones en las que está disponible el servicio IBM Cloud Logs Routing. Identifique una región en la que opere en IBM Cloud y compruebe que está en la lista de regiones admitidas.
-
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 servicio lector para ver inquilinos y objetivos.
Necesita el rol de servicio gestor para crear, eliminar, actualizar inquilinos y destinos.
-
Instale las siguientes herramientas:
-
Descargue e instale la CLI de IBM Cloud®.
-
Suministrar una instancia de IBM Cloud Logs. Para obtener más información, consulte Suministro de una instancia.
-
Descargue e instale jq para procesar la salida y consultar los resultados deseados.
-
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 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:
-
En la consola de IBM Cloud, pulse Gestionar > Acceso (IAM) y seleccione Autorizaciones.
-
Pulse Crear.
-
Configure la cuenta de origen. Seleccione Esta cuenta.
-
Seleccione Enrutamiento de registros como servicio de origen. A continuación, establece el ámbito del acceso en Todos los recursos.
-
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 IBM Cloud Logs, o a una única instancia configurando Recursos basados en atributos seleccionados > Instancia de servicio.
No se admiten otros atributos para este tipo de autorización.
-
En la sección Acceso al servicio, seleccione Emisor para asignar acceso al servicio de origen que accede al servicio de destino.
-
Pulse Autorizar.
Para obtener más información, consulte Creación de una autorización S2S para conceder acceso para enviar registros a IBM Cloud Logs.
Crear un inquilino
Cuando se muestra por primera vez la consola IBM Cloud Logs Routing, se muestra cualquier información de destino existente.
Si no hay ningún objetivo configurado para una región, ésta muestra la opción Configurar objetivo.
Desde la consola IBM Cloud Logs Routing, puede crear un tenant y un destino de destino configurando la opción Set target para la región que desee configurar.
Complete los pasossiguientes:
-
Haga clic en el icono Menú
> Observabilidad.
-
Haga clic en Registro > Enrutamiento.
-
Haz clic en Fijar objetivo.
-
Haga clic en la pestaña Cloud Logs y seleccione una instancia IBM Cloud Logs de la lista. Esta es la instancia en la que desea recibir los registros enrutados por IBM Cloud Logs Routing.
Puede seleccionar una instancia de IBM Cloud Logs de la lista.
La instancia IBM Cloud Logs debe estar ubicada en la misma cuenta que está configurando.
-
Pulse Guardar.
Verificación de que los registros se envían al objetivo de destino
Compruebe que los registros de su clúster se dirigen a su instancia IBM Cloud Logs.
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.
Complete los pasossiguientes:
- Inicie la IBM Cloud Logs interfaz web para la instancia IBM Cloud Logs configurada como destino para recopilar registros de plataforma en una región. Esta es la instancia que seleccionó en el paso en el que configuró un objetivo.
- Visualice los registros a través de vistas personalizadas. Para obtener más información, consulte Visualización de registros.