Comprendre comment les routes fonctionnent dans votre compte

Notez les informations suivantes à propos des routes :

• Les itinéraires sont globaux sous un compte et sont évalués dans toutes les régions où IBM Cloud Logs Routing est déployé.

• Il est possible d'accéder aux itinéraires à partir de n'importe quel point d'accès régional de l'API IBM Cloud Logs Routing.

• Vous pouvez définir jusqu'à 30 routes pour un compte.

• Par défaut, le compte n'a aucune route configurée.

• Vous pouvez configurer jusqu'à 10 règles pour chaque route.

• Vous pouvez configurer jusqu'à 8 emplacements pour chaque règle.

• Vous pouvez configurer jusqu'à 3 cibles ({ "targets": [{ "id": ID1 },{ "id": ID2 },{ "id": ID3 }] }) pour chaque règle.

• Les routes sont traitées de façon indépendante. Si vous avez plusieurs itinéraires avec des règles qui correspondent aux mêmes données d'enregistrement de la plate-forme, ces données seront envoyées à plusieurs cibles.

• Les règles d'une même définition d'itinéraire sont traitées dans l'ordre. La première règle de correspondance (par exemple, location) qui correspond aux données d'enregistrement de la plate-forme est utilisée pour traiter ces données. Lorsque les journaux de plate-forme sont traités, ils ne seront pas traités par une règle ultérieure dans la définition de cet itinéraire.

• Les règles correspondent à un journal de plate-forme si l'emplacement du journal de plate-forme se trouve à l'intérieur de l'emplacement d'une règle. Par exemple, l'emplacement de la règle eu-de correspondra aux emplacements des journaux de la plate-forme : eu-de, eu-de-1, eu-de-2, et eu-de-3. Ou la règle location jp correspondra à tous les journaux de plate-forme au Japon. Lancez ibmcloud catalog locations pour voir les hiérarchies d'emplacements du nuage.

• Si les données des journaux de la plate-forme ne correspondent à aucune règle et qu'aucune cible par défaut n'est configurée, les journaux de la plate-forme sont abandonnés et ne sont pas acheminés vers une cible.

• Toute mise à jour d'une ou plusieurs règles dans une définition d'itinéraire annule l'ensemble de règles existant et le remplace par la configuration spécifiée. Lorsque vous mettez à jour un itinéraire, vous devez définir toutes les règles existantes de l'ensemble de règles qui ne changent pas et ajouter les modifications aux règles qui doivent être mises à jour.

• Les informations sur les itinéraires sont stockées sous forme de métadonnées dans l'emplacement principal que vous avez défini pour le compte IBM Cloud.

• Vous pouvez utiliser des noeuds finaux privés et publics pour gérer les routes. Pour plus d'informations sur la liste des ENDPOINTS disponibles, voir Noeuds finaux.

  • Vous pouvez gérer des itinéraires à partir du réseau privé en utilisant un point de terminaison API avec le format suivant : https://api.private.REGION.logs-router.cloud.ibm.com

  • Vous pouvez gérer des itinéraires à partir du réseau public en utilisant un point de terminaison API avec le format suivant : https://api.REGION.logs-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 Renforcer les points de terminaison privés.

• Le nom de l'itinéraire 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 comporter d'informations d'identification personnelle (PII).

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

Accès IAM

Assurez-vous que vous disposez des autorisations IAM correctes pour configurer IBM Cloud Logs Routing

Autorisations IAM

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

Audit des évènements

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