Objetivos

En este tutorial aprenderás:

• Configure IBM Cloud Logs Routing para enrutar los registros de la plataforma a una instancia de IBM Cloud Logs en una región.

• Compruebe que los registros de la plataforma se dirigen a su instancia IBM Cloud Logs.

Antes de empezar

Complete los pasossiguientes:

1. Repasa Acerca de IBM® Cloud Logs Routing para entender conceptos.

2. Instale todas las herramientas necesarias tal y como se describe en comenzar.

3. Para obtener detalles sobre un inquilino mediante la API, compruebe que puede conectarse a IBM Cloud Logs Routing mediante la API de gestión. Para obtener más información, consulte Conexión a IBM® Cloud Logs Routing.

4. Los registros de la plataforma que se enrutan a IBM Cloud Logs incluyen campos de metadatos que puede utilizar para gestionar los datos y configurar funciones en su instancia de IBM Cloud Logs.

   El nombre de la aplicación es el entorno que produce y envía registros a IBM Cloud Logs. Los registros de la plataforma tienen el nombre de la aplicación establecido en ibm-platform-log.

   El nombre del subsistema es el servicio o la aplicación que produce y envía registros o métricas a IBM Cloud Logs. Los registros de plataforma tienen el nombre del subsistema establecido en CRNserviceName:instanceID. Para los registros de la plataforma VPC, los campos se establecen en is:resourceType.

5. Configure los permisos para gestionar los objetivos en la cuenta. Para obtener más información, consulte Concesión de permisos de IAM.

   Antes de poder configurar el servicio IBM Cloud Logs Routing para enrutar los registros de su plataforma, necesita un token de acceso IBM Cloud® Identity and Access Management (IAM) para la autenticación. La IBM Cloud CLI se utiliza para obtener esta información.

   1. Inicie sesión en la cuenta de IBM Cloud. Incluya la opción --sso si utiliza un ID federado.

      ibmcloud login [--sso]
      

      La salida incluirá su nombre de usuario similar a:

      Targeted account Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
      
      
       API endpoint:     https://cloud.ibm.com
       Region:           us-south
       User:             Jane.Doe@ibm.com
       Account:          Jane Doe\'s Account (111111111112a21af53a2aeed19a1542a44) <-> 11111156
       Resource group:   No resource group targeted, use 'ibmcloud target -g RESOURCE_GROUP'
      

   2. Para conceder acceso para utilizar IBM Cloud Logs Routing a su usuario, recopile el nombre de usuario de la salida generada anteriormente. En nuestro ejemplo, sería Jane.Doe@ibm.com. Sustituye <username> por tu nombre de usuario en el siguiente comando:

      ibmcloud iam user-policy-create <username> --roles Manager --service-name logs-router
      

      En lugar de asignar funciones directamente a las identidades, una estrategia común es asignar funciones a grupos de acceso y añadir identidades como miembros de esos grupos de acceso. Para más información sobre grupos de acceso, consulte Configuración de grupos de acceso.

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.

Recuperación de su información IBM Cloud Logs

Para enrutar datos a una instancia IBM Cloud Logs, necesita información sobre el destino al que desea que se entreguen los registros. Necesita la siguiente información para su instancia IBM Cloud Logs:

• La instancia CRN
• El punto final y el puerto de ingestión (entrada)

Utilice este comando para recuperar la dirección IP ( URL ) y el ID:

ibmcloud resource service-instances --service-name logs --long --output JSON | jq '[.[] | {name: .name, id: .id, region: .region_id, ingestion_endpoint: .extensions.external_ingress}]'

Si tiene varias instancias, elija una que desee utilizar para recibir los registros de la plataforma y guarde la información para más tarde.

El punto final es similar a:

ingestion_endpoint: 3a622101-7521-4002-bf91-8c26e17eedcf.ingress.eu-de.logs.cloud.ibm.com

La identificación es similar a:

"crn:v1:bluemix:public:logs:eu-es:a/15ff25632a21af53a2aeed19a1542a44:3a622101-7521-4002-bf91-8c26e17eedcf::"

Para obtener toda la información sobre la instancia, puede ejecutar ibmcloud resource service-instances --service-name logs --long --output JSON Este comando enumera todas sus instancias IBM Cloud Logs. Necesita los siguientes campos: ID que contiene el CRN de la instancia, extensions.external_ingress que contiene el endpoint de entrada y extensions.virtual_private_endpoints.endpoints.ports.port_max que contiene el valor del puerto.

Crear un inquilino y un objetivo

Para recibir los registros de su plataforma, debe crear un tenant con el servicio IBM Cloud Logs Routing.

Debe crear su tenant en la región en la que desea recopilar y enrutar los registros de la plataforma a la instancia IBM Cloud Logs.

curl -X POST https://<MANAGEMENT-API-ENDPOINT>:443/v1/tenants \
-H "Content-Type: application/json" \
-H "Authorization: ${IAM_TOKEN}" \
-H 'IBM-API-Version: DATE' \
--data '{
    "name": "TENANT_NAME",
    "targets": [
        {
            "log_sink_crn": "CLOUD_LOGS_INSTANCE_ID",
            "name": "TARGET_NAME",
            "parameters": {
                "host": "CLOUD_LOGS_INSTANCE_INGRESS_ENDPOINT",
                "port": PORT
            }
        }
    ]
}'

{
    "id": "3517d2ed-9429-af34-ad52-34278391cbc8:",
    "created_at": "2023-10-20T18:30:00.143156Z",
    "updated_at": "2023-10-20T18:30:00.143156Z",
    "crn": "crn:v1:bluemix:public:logs-router:eu-de:a/3516b8fa0a174a71899f5affa4f18d78:3517d2ed-9429-af34-ad52-34278391cbc8::",
    "name": "tenant",
    "etag": "\"822b4b5423e225206c1d75666595714a11925cd0f82b229839864443d6c3c049\"",
    "targets": [
    {
        "id": "86432b-66a6-df12-7003-888a21a2b3",
        "log_sink_crn": "crn:v1:bluemix:public:logs:eu-gb:a/91d1d1e42f9b684df920bbd06461c222:743e3b4f-72bc-4669-9fa6-0e6621d0b232::",
        "name": "my-log-sink",
        "etag": "\"c3a43545a7f2675970671ac3a57b8db067a1866b2222e1b950ee8da612e347c6\"",
        "type": "logs",
        "created_at": "2023-10-20T18:30:00.143156Z",
        "updated_at": "2023-10-20T18:30:00.143156Z",
        "parameters": {
            "host": "743e3b4f-72bc-4669-9fa6-0e6621d0b232.ingress.eu-gb.logs.cloud.ibm.com",
            "port": 443
        }
    }
    ]
}

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

Para asegurarse de que los registros de su plataforma fluyen correctamente a IBM Cloud Logs, realice los siguientes pasos:

1. Inicie la IBM Cloud Logs interfaz web 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.