A propos des cibles

Vous pouvez gérer les cibles Monitoring dans votre compte en utilisant l'interface utilisateur IBM Cloud Metrics Routing, le CLI IBM Cloud Metrics Routing, l'API REST IBM Cloud Metrics Routing, le fournisseur Terraform IBM Cloud Metrics Routing et les modules Terraform IBM(TIM)pour IBM Cloud Metrics Routing. Un objectif est une ressource où vous pouvez collecter des données. La ressource peut être située dans le même compte IBM Cloud que celui où les mesures sont générées ou dans un compte différent.

Description du fonctionnement des cibles dans votre compte

Notez les informations suivantes sur les cibles :

Les cibles sont régionales sous un compte et sont accessibles à partir de n'importe quel noeud final d'API IBM Cloud Metrics Routing régional.
Vous pouvez définir une cible dans n'importe lequel des emplacements pris en charge où IBM Cloud Metrics Routing est disponible. Pour plus d'informations, voir Emplacements.
Vous pouvez configurer jusqu'à 16 cibles par compte.
Vous pouvez configurer jusqu'à deux cibles par défaut pour chaque compte IBM Cloud.

Les cibles par défaut collectent des métriques à partir d'emplacements où vous ne spécifiez pas dans le compte où acheminer les métriques générées à cet emplacement.
Les informations sur les cibles sont stockées sous forme de métadonnées dans les emplacements principal et de sauvegarde que vous définissez pour le compte IBM Cloud. Les informations stockées incluent des détails sur la ressource destinatiion et les données d'identification permettant d'envoyer des métriques.

L'emplacement principal des métadonnées doit être défini avant de configurer une cible.

Si vous ne configurez pas d'emplacement de métadonnées principal, l'emplacement est celui où vous définissez votre première cible dans le compte. Pour plus d'informations, voir Configuration des paramètres de compte.
Vous pouvez utiliser des noeuds finaux privés et publics pour gérer les cibles. Pour plus d'informations sur la liste des points de terminaison disponibles, voir Points de terminaison.
- Vous pouvez gérer les cibles à partir du réseau privé en utilisant un point de terminaison API au format suivant : https://private.REGION.metrics-router.cloud.ibm.com
- Vous pouvez gérer des cibles à partir du réseau public en utilisant un point de terminaison API au format suivant : https://REGION.metrics-router.cloud.ibm.com
- Vous pouvez désactiver les noeuds finaux publics en mettant à jour les paramètres du compte. Pour plus d'informations, voir Application de noeuds finaux privés.
Le nom de la cible ne doit pas dépasser 1000 caractères et ne peut inclure aucun caractère spécial autre que l'espace, le tiret -, le point ., le trait de soulignement _ et les deux points :.

Le nom ne doit pas inclure d'informations d'identification personnelle (PII).

Types de cible

Vous pouvez configurer l'un des types de cibles suivants :

Liste des cibles
Cible	Type	Portée	Description
IBM Cloud Monitoring	`sysdig-monitor`	`Account`	Utilisez cette cible pour consolider les données de séries temporelles dans la région de vos opérations principales.

Accès IAM

Pour gérer les cibles, vérifiez que vous disposez des droits IAM appropriés pour configurer IBM Cloud Metrics Routing.

Pour permettre au service IBM Cloud Metrics Routing d'envoyer des métriques à vos destinations Monitoring, vous devez disposer d'une autorisation de service à service configurée dans le compte où se trouve la cible. Pour plus d'informations, voir Gestion des autorisations d'accès entre les services.

Autorisations IAM

Le tableau suivant répertorie les actions IAM, leur portée et les rôles requis pour gérer les routes.

Périmètre d'action et rôle de l'IAM pour la gestion des objectifs
Tâche	Action IAM	Portée de la règle IAM	Rôles IAM
Création d'une cible	`metrics-router.target.create`	Région	`Administrator` `Editor`
Répertorier toutes les cibles	`metrics-router.target.list`	Compte	`Administrator` `Editor` `Operator` `Viewer`
Obtenir les détails d'une cible	`metrics-router.target.read`	Région	`Administrator` `Editor` `Operator` `Viewer`
Modifier une cible	`metrics-router.target.update`	Région	`Administrator` `Editor`
Supprimer une cible	`metrics-router.target.delete`	Région	`Administrator` `Editor`

Lorsque vous utilisez l'interface de ligne de commande, notez que vous avez besoin du rôle metrics-router.target.list pour créer, lire, mettre à jour ou supprimer une cible.

Audit des évènements

Le tableau suivant répertorie les actions IAM, leur portée et les rôles requis pour gérer les routes.

Suivi de l'activité, audit, événement, action
Tâche	Suivi de l'activité, audit, événement, action
Création d'une cible	`metrics-router.target.create`
Répertorier toutes les cibles	`metrics-router.target.list`
Obtenir les détails d'une cible	`metrics-router.target.read`
Modifier une cible	`metrics-router.target.update`
Supprimer une cible	`metrics-router.target.delete`

Gestion des cibles à l'aide de l'interface utilisateur

Vous pouvez gérer votre définition de cible à l'aide de l'interface utilisateur IBM Cloud Metrics Routing. Pour plus d'informations, voir Gestion des cibles.

Prérequis pour l'interface de ligne de commande (CLI)

Avant d'utiliser l'interface de ligne de commande pour gérer les cibles, procédez comme suit :

Vérifiez que vous disposez des droits IAM appropriés pour configurer IBM Cloud Metrics Routing.
Installez l'interface de ligne de commande IBM Cloud.
Installez l'interface de ligne de commande IBM Cloud Metrics Routing.

Commandes de l'interface de ligne de commande

Le tableau suivant répertorie les actions que vous pouvez exécuter pour gérer les cibles :

Actions ciblées
Action	Commande
`Create a target`	`ibmcloud metrics-router target create`
`Update a target`	`ibmcloud metrics-router target update`
`Delete a target`	`ibmcloud metrics-router target rm`
`Read a target`	`ibmcloud metrics-router target get`
`List all targets`	`ibmcloud metrics-router target ls`

Pour plus d'informations, voir Interface de ligne de commandeIBM Cloud Metrics Routing v3.

Prérequis d'API

Avant d'utiliser l'API pour gérer les cibles, effectuez les étapes suivantes :

Vérifiez que vous disposez des droits IAM appropriés pour configurer IBM Cloud Metrics Routing.
Obtenez un jeton d'accès IAM. Pour plus d'informations, voir Extraction des jetons d'accès IAM.
Identifiez le nœud final d'API dans la région dans laquelle vous prévoyez de configurer ou de gérer une cible. Pour plus d'informations, voir Nœuds finaux.

Méthodes d'API

Le tableau suivant répertorie les actions que vous pouvez exécuter pour gérer les cibles :

Ciblez des actions en utilisant l'IBM Cloud Metrics Routing API REST
Action	Méthode d'API REST	URL d'API
`Create a target`	`POST`	`<ENDPOINT>/api/v3/targets`
`Update a target`	`PATCH`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Delete a target`	`DELETE`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`Read a target`	`GET`	`<ENDPOINT>/api/v3/targets/<TARGET_ID>`
`List all targets`	`GET`	`<ENDPOINT>/api/v3/targets`

Pour plus d'informations, voir IBM Cloud Metrics Routing v3 API.

Codes de réponse HTTP

Lorsque vous utilisez l'API REST IBM Cloud Metrics Routing, vous pouvez obtenir des codes de réponse HTTP normaux indiquant si une méthode a abouti.

Une réponse 200 indique toujours le succès.
Une réponse 4xx indique un incident.
Une réponse 5xx indique généralement une erreur système interne.

Voir le tableau suivant pour certains codes de réponse HTTP :

Liste des codes de réponse HTTP
Code d'état	Statut	Description
`200`	OK	La demande a abouti.
`201`	OK	La demande a abouti. Une ressource est créée.
`204`	OK	La cible a été supprimée avec succès.
`400`	Demande incorrecte	La demande n'a pas abouti. Il vous manque peut-être un paramètre obligatoire.
`401`	Non autorisé	La demande d'autorisation échoue.
`403`	Interdit	L'opération est interdite en raison de droits insuffisants.
`404`	Introuvable	La ressource demandée n'existe pas ou est déjà supprimée.
`429`	Trop de demandes	Trop de demandes atteignent l'API trop rapidement.
`500`	Erreur de serveur interne	Une erreur s'est produite lors du traitement d'IBM Cloud Metrics Routing.