Iniciación a IBM Cloud Metrics Routing

Utilice IBM Cloud® Metrics Routing para configurar el enrutamiento de las métricas de la plataforma generadas en su cuenta de IBM Cloud.

Puede usar IBM Cloud Metrics Routing, un servicio de plataforma, para administrar las métricas de la plataforma a nivel de cuenta mediante la configuración de destinos y rutas que definen dónde se enrutan los puntos de datos. IBM Cloud Metrics Routing puede enrutar métricas generadas en regiones compatibles por servicios habilitados. Para obtener más información sobre IBM Cloud Metrics Routing, consulte Acerca de IBM Cloud Metrics Routing.

Diagrama que muestra una arquitectura de muestra IBM Cloud Metrics Routing. — Arquitectura de muestra IBM Cloud Metrics Routing

Requisitos previos

Instale la CLI de IBM Cloud.
Instale la CLI de IBM Cloud Metrics Routing.
Debe tener un ID de usuario con permisos para administrar IBM Cloud Metrics Routing. Para obtener más información sobre los roles de IAM y cómo asignarlos, consulte Administrar el acceso con IAM y Asignar acceso a IBM Cloud Metrics Routing.
Para configurar IBM Cloud Metrics Routing para enrutar métricas a una instancia de Monitoring, debe configurar una autorización de servicio a servicio. No es necesario proporcionar credenciales a IBM Cloud Metrics Routing.

Para obtener información sobre cómo configurar la autenticación de servicio a servicio, consulte Administrar autorizaciones para otorgar acceso entre servicios.

Paso 1. Configurar los valores de la cuenta

Establezca estas configuraciones de cuenta para definir dónde y cómo se recopilan, enrutan y administran las métricas en su cuenta mediante IBM Cloud Metrics Routing.

Cuando configura IBM Cloud Metrics Routing en su cuenta, puede configurar ajustes de la cuenta como ubicaciones de metadatos, tipo de puntos finales que pueden administrar la configuración, ubicaciones donde se pueden definir objetivos y objetivos predeterminados para recopilar métricas en regiones en las que no ha configurado explícitamente cómo enrutar métricas. Para obtener más información, consulte Configurar los ajustes de la cuenta IBM Cloud Metrics Routing.

Antes de poder configurar destinos y rutas en la cuenta, debe configurar la ubicación de metadatos principal que define la región donde se almacenan todas las definiciones de recursos de IBM Cloud Metrics Routing.

Ejecute el siguiente comando para configurar la ubicación primaria de metadatos:

ibmcloud metrics-router setting update --primary-metadata-region <REGION>

Donde <REGION> se establece en una región compatible donde IBM Cloud Metrics Routing está disponible. Para obtener más información, consulte Ubicaciones.

Antes de establecer la ubicación de los metadatos, comprueba si existen normativas sectoriales o de cumplimiento que se apliquen a la ubicación de los datos.

Paso 2. Configurar 1 objetivo

Un destino define dónde se recopilan las métricas. Para obtener más información sobre los objetivos, consulte Comprender cómo funcionan los objetivos en su cuenta.

Cuando configura un objetivo, está definiendo el destino al que planea enviar las métricas de la plataforma que se recopilan en una región de su cuenta.

Complete los siguientes pasos para configurar un objetivo:

Definir un objetivo hacia donde enrutar las métricas.
```
ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
```
Donde

--name

Define el nombre que se dará al objetivo.

--destination-crn

Define el CRN de la instancia IBM Cloud Monitoring donde planea enrutar las métricas. Los destinos IBM Cloud Monitoring son los únicos compatibles.

--region

[Opcional] Define la región donde se crea la definición de destino. Sólo puedes especificar una región compatible. Configure esta opción si desea crear un objetivo en una región y está conectado a otra diferente.
Defina una autorización de servicio a servicio entre el servicio IBM Cloud Metrics Routing y la instancia IBM Cloud Monitoring que configuró como su destino en el target. Para obtener más información, consulte Administrar autorizaciones para otorgar acceso entre servicios.

Paso 3. Configurar 1 ruta

Una ruta define las reglas que indican qué métricas se enrutan en una región y dónde almacenarlas. Las rutas son globales bajo una cuenta y se evalúan en todas las regiones en las que se despliega IBM Cloud Metrics Routing. Para obtener más información, consulte Comprender cómo funcionan las rutas en su cuenta.

En este paso, configurará una ruta para redirigir las métricas al destino que configuró en el paso anterior.

Ejecute el mandato siguiente para crear la ruta:

ibmcloud metrics-router route create --name ROUTE_NAME  --rules RULES

Donde

--name ROUTE_NAME: Define el nombre que se dará a la ruta.
--rules RULES: Define una regla con formato JSON entre comillas simples. Más información.

Después de configurar una ruta, la configuración puede tardar hasta una hora en habilitarse.

Por ejemplo, para crear una ruta que envíe las métricas generadas en us-east al destino que creó en el paso anterior, ejecute el siguiente comando.

ibmcloud metrics-router route create --name "my-route" --rules '[{"action": "send", "targets":[{"id":"TARGETID"}], "inclusion_filters":[{"operand": "location","operator": "is","values": "us-east"}]}]''

Donde ' TARGETID ' es el ID del objetivo que creó en el paso anterior.

Paso 4. Verificar la recopilación de métricas

Una vez configurados el objetivo y la ruta, debes verificar que las métricas estén disponibles.

Inicie la interfaz de usuario de IBM Cloud Monitoring para la instancia de Monitoring que configuró como destino y explore las métricas.