Initiation à IBM Cloud Metrics Routing

Utilisez IBM Cloud® Metrics Routing pour configurer le routage des métriques de plateforme générées dans votre compte IBM Cloud.

Vous pouvez utiliser IBM Cloud Metrics Routing, un service de plateforme, pour gérer les métriques de la plateforme au niveau du compte en configurant des cibles et des itinéraires qui définissent où les points de données sont acheminés. IBM Cloud Metrics Routing peut acheminer les mesures générées dans les régions prises en charge par les services activés. Pour plus d'informations sur IBM Cloud Metrics Routing, voir A propos de IBM Cloud Metrics Routing.

Un diagramme qui montre un exemple IBM Cloud Metrics Routing d'architecture — IBM Cloud Metrics Routing échantillon d'

Prérequis

Installez l'interface de ligne de commande IBM Cloud.
Installez l'interface de ligne de commande IBM Cloud Metrics Routing.
Vous devez disposer d'un ID utilisateur disposant des droits permettant de gérer IBM Cloud Metrics Routing. Pour plus d'informations sur les rôles IAM et leur affectation, voir Gestion de l'accès avec IAM et Affectation de l'accès à IBM Cloud Metrics Routing.
Pour configurer IBM Cloud Metrics Routing afin d'acheminer les métriques vers une instance Monitoring, vous devez configurer une autorisation de service à service. Il n'est pas nécessaire de fournir des données d'identification à IBM Cloud Metrics Routing.

Pour plus d'informations sur la configuration de l'authentification de service à service, voir Gestion des autorisations d'accès entre les services.

Étape 1. Configuration des paramètres de compte

Définissez ces paramètres de compte pour définir où et comment les métriques sont collectées, acheminées et gérées dans votre compte à l'aide de IBM Cloud Metrics Routing.

Lorsque vous configurez IBM Cloud Metrics Routing dans votre compte, vous pouvez configurer des paramètres de compte tels que les emplacements de métadonnées, le type de noeuds finaux autorisés à gérer la configuration, les emplacements où les cibles peuvent être définies et les cibles par défaut pour la collecte des métriques dans les régions que vous n'avez pas explicitement configurées pour acheminer les métriques. Pour plus d'informations, voir Configuration des paramètres de compte IBM Cloud Metrics Routing.

Avant de pouvoir configurer des cibles et des routes dans le compte, vous devez configurer l'emplacement des métadonnées principales qui définit la région dans laquelle sont stockées toutes vos définitions de ressource IBM Cloud Metrics Routing.

Exécutez la commande suivante pour configurer l'emplacement des métadonnées primaires :

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

Où <REGION> est défini sur une région prise en charge où IBM Cloud Metrics Routing est disponible. Pour plus d'informations, voir Emplacements.

Avant de définir l'emplacement des métadonnées, vérifiez les règles de conformité ou les réglementations sectorielles qui s'appliquent à l'emplacement des données.

Étape 2. Configurer 1 cible

Une cible définit l'emplacement de collecte des métriques. Pour plus d'informations sur les cibles, voir Description du fonctionnement des cibles dans votre compte.

Lorsque vous configurez une cible, vous définissez la destination dans laquelle vous prévoyez d'envoyer les métriques de plateforme qui sont collectées dans une région de votre compte.

Effectuez les étapes suivantes pour configurer une cible :

Définissez une cible où acheminer les métriques.
```
ibmcloud metrics-router target create --name TARGET_NAME --destination-crn DESTINATION_TARGET_CRN [--region REGION]
```
Où

--name

Définit le nom à donner à la cible.

--destination-crn

Définit le CRN de l'instance IBM Cloud Monitoring dans laquelle vous prévoyez d'acheminer les métriques. Les cibles IBM Cloud Monitoring sont les seules prises en charge.

--region

[Facultatif] Définit la région dans laquelle la définition cible est créée. Vous ne pouvez spécifier qu'une région prise en charge. Définissez cette option si vous souhaitez créer une cible dans une région et que vous êtes connecté à une autre cible.
Définissez une autorisation de service à service entre le service IBM Cloud Metrics Routing et l'instance IBM Cloud Monitoring que vous avez configurée comme destination dans la cible. Pour plus d'informations, voir Gestion des autorisations d'accès entre les services.

Étape 3. Configurer 1 route

Un itinéraire définit les règles qui indiquent quelles métriques sont acheminées dans une région et où les stocker. Les routes sont globales sous un compte et sont évaluées dans toutes les régions où IBM Cloud Metrics Routing est déployé. Pour plus d'informations, voir Présentation du fonctionnement des routes dans votre compte.

Au cours de cette étape, vous allez configurer une route pour rediriger les métriques vers la destination cible que vous avez configurée à l'étape précédente.

Exécutez la commande suivante pour créer la route :

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

Où

--name ROUTE_NAME: Définit le nom à donner à l'itinéraire.
--rules RULES: Définit une définition de règle au format JSON entre guillemets simples. En savoir plus.

Après avoir configuré une route, il peut s'écouler jusqu'à une heure avant que la configuration ne soit activée.

Par exemple, pour créer une route afin d'envoyer les métriques générées en us-east vers la cible que vous avez créée à l'étape précédente, exécutez la commande suivante.

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

Où " TARGETID est l'ID de la cible que vous avez créée à l'étape précédente.

Étape 4. Vérifier la collecte des métriques

Une fois la cible et la route configurées, vous devez vérifier que des métriques sont disponibles.

Lancez l'interface utilisateur IBM Cloud Monitoring pour l'instance Monitoring que vous avez configurée comme cible et explorez les métriques.