Recuperación del token de portador IAM

Debe obtener un token de acceso IBM Cloud® Identity and Access Management (IAM) para autenticar sus solicitudes al servicio IBM® Cloud Logs Routing. Para obtener más información, consulte Recuperación de una señal de acceso.

Por ejemplo, puede recuperar su token de portador IAM y exportarlo como una variable de entorno ejecutando el siguiente comando CLI:

export IAM_TOKEN=`ibmcloud iam oauth-tokens --output json | jq -r '.iam_token'`

Elegir el punto final de gestión

Un tenant es la configuración específica de la cuenta de IBM Cloud Logs Routing que se ejecuta dentro de una región.

Para obtener los detalles de un inquilino en una región, debe utilizar el punto final de gestión URL para la región en la que está configurado el inquilino.

Puede utilizar puntos finales privados o públicos.

Para obtener más información, consulte Las URL de los puntos finales de gestión.

Crear un inquilino y un objetivo a través de la interfaz de usuario

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. Cuando el objetivo se configura por primera vez, un IBM Cloud Logs Routing tenant es creados(incorporados) y el objetivo configurado.

Para crear un inquilino y un destino para una región, siga estos pasos:

1. Inicia sesión en tu cuenta IBM Cloud.

2. Haga clic en el ícono Menú Ícono > Observabilidad.

3. Haga clic en Registro > Enrutamiento.

4. Haz clic en Fijar objetivo.

5. Seleccione una instancia de IBM Cloud Logs. 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. Antes de hacerlo, compruebe que tiene definida una autorización de servicio a servicio entre el servicio IBM Cloud Logs Routing y la instancia IBM Cloud Logs. Para obtener más información, consulte Creación de una autorización S2S para conceder acceso para enviar registros a IBM Cloud Logs.

6. Pulse Guardar.

Cuando se fija un objetivo en la interfaz de usuario, se crea un inquilino en esa región. El nombre del inquilino se establece como region-ID donde región se establece en la región donde se encuentra cuando se crea el objetivo.

Creación de un inquilino y un objetivo mediante la API

Ejecute el siguiente comando para crear un tenant para el servicio IBM Cloud Logs Routing utilizando el private endpoint:

curl -X POST  https://management.private.${REGION}.logs-router.cloud.ibm.com/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H "IBM-API-Version: API_VERSION_DATE" \
--data '{TARGET_DATA}'

Ejecute el siguiente comando para crear un tenant para el servicio IBM Cloud Logs Routing mediante el public endpoint:

curl -X POST  https://management.${REGION}.logs-router.cloud.ibm.com/v1/tenants \
--H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H "IBM-API-Version: API_VERSION_DATE" \
--data '{TARGET_DATA}'

Donde

• REGION define la ubicación donde se configura el inquilino.
• IAM_TOKEN define las credenciales que utilizas para autenticar tus peticiones.
• API_VERSION_DATE define la fecha de la versión de la API que desea utilizar para consultar su definición de inquilino. El formato debe ser el siguiente: YYYY-MM-DD
• TARGET_DATA define la información sobre el destino de destino.

{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_CRN",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": CLOUD_LOGS_INSTANCE_TARGET_PORT
            }
        }
    ]
}

Creación de un inquilino y un objetivo mediante Terraform

provider "ibm" {
  ibmcloud_api_key = "IBMCLOUD_API_KEY"
  region = "some-region"
}

resource "ibm_logs_router_tenant" "logs_router_tenant_instance_1" {
	name = "TENANT_NAME"
  region = "TENANT_REGION"
	targets {
	  log_sink_crn = "CLOUD_LOGS_INSTANCE_CRN"
	  name = "TARGET_NAME"
	  parameters {
		host = "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT"
		port = CLOUD_LOGS_INSTANCE_TARGET_PORT
	  }
	}
  }