Activation du contexte de projet dans le Syslog NSX Edge

Les messages de journal générés pour les objets créés dans le projet NSX contiennent le contexte du projet (locataire) dans un libellé qui est ajouté à chaque message de journal. Ce libellé correspond à l'identifiant de journal court unique qui a été défini lors de la création du projet.

Par exemple, les messages de journal générés dans le fichier Syslog du dispositif Edge pour les services centralisés, qui s'exécutent sur la passerelle de niveau 1 du projet, contiennent le contexte du projet.

Par défaut, les messages de journal générés dans le fichier Syslog du dispositif Edge pour les services centralisés, qui s'exécutent sur les passerelles de niveau 0/VRF utilisées par le projet, ne contiennent pas le contexte du projet. Cela est dû au fait que les passerelles de niveau 0/VRF appartiennent à l'espace par défaut et qu'elles n'appartiennent à aucun projet. Lorsque vous allouez une passerelle de niveau 0/VRF à un projet (A, par exemple), cela ne vous empêche pas d'allouer la même passerelle de niveau 0/VRF à d'autres projets (B, C et D, par exemple) dans le système. Il s'agit du comportement par défaut de NSX.

À partir de NSX 4.1.2, le système prend en charge l'affectation d'une passerelle de niveau 0/VRF à un seul projet uniquement à des fins de journalisation. Lorsqu'une passerelle de niveau 0/VRF est dédiée à un projet, les messages de journal pour les services centralisés sur cette passerelle de niveau 0/VRF contiennent le contexte du projet dans le Syslog Edge. N'oubliez pas qu'une passerelle de niveau 0/VRF dédiée à un projet (A, par exemple) peut toujours être utilisée par d'autres projets (B, C et D, par exemple) dans le système. Toutefois, le contexte des projets B, C et D qui utilisent la même passerelle de niveau 0/VRF ne sera pas stocké dans le Syslog Edge, sauf si ces projets disposent d'une passerelle de niveau 0/VRF dédiée différente qui n'est pas déjà dédiée à un autre projet dans le système.

Pour affecter une passerelle de niveau 0/VRF à un projet, un administrateur d'entreprise doit configurer le paramètre dedicated_resources dans la configuration du projet à l'aide de l'API project. Actuellement, cette fonctionnalité est prise en charge uniquement avec l'API. L'interface utilisateur de NSX Manager ne prend pas en charge l'affectation d'une passerelle de niveau 0/VRF à un projet.

Les validations suivantes s'appliquent à l'affectation d'une passerelle de niveau 0/VRF dans un projet :

Pour affecter une passerelle de niveau 0/VRF à un projet, elle doit être allouée au projet. Par exemple, si vous avez alloué les passerelles X et Y de niveau 0 à un projet, vous ne pouvez pas affecter la passerelle Z de niveau 0 à ce projet. Pour affecter la passerelle Z à ce projet, vous devez d'abord l'allouer au projet.
Une passerelle de niveau 0/VRF ne peut être dédiée qu'à un seul projet. Cependant, un projet peut avoir plusieurs passerelles de niveau 0/VRF qui lui sont dédiées. Par exemple, supposons que les deux passerelles X et Y de niveau 0 soient allouées au projet A. Vous pouvez dédier les passerelles X et Y de niveau 0 au projet A. Toutefois, les passerelles X et Y ne peuvent pas être dédiées à un autre projet dans le système. Cependant, les passerelles X et Y peuvent être utilisées par d'autres projets dans le système.
Lorsque vous supprimez la configuration dedicated_resources d'un projet ou lorsque vous supprimez le projet, la passerelle de niveau 0/VRF qui était dédiée à ce projet peut être dédiée à n'importe quel autre projet dans le système. Par exemple, supposons que vous ayez alloué la passerelle X de niveau 0 aux projets A et B et configuré la passerelle X comme ressource dédiée dans le projet A. Si nécessaire, vous pouvez par la suite supprimer la configuration dedicated_resources du projet A et ajouter la passerelle X en tant que ressource dédiée dans le projet B.

Exemple

Supposons que vous ayez créé deux projets nommés Ventes et Finance, comme indiqué dans le diagramme suivant. L'identifiant court du journal du projet Ventes est salespro et, pour le projet Finance, est finanpro. Vous avez configuré le paramètre dedicated_resources pour dédier la passerelle N0-Ventes au projet Ventes et la passerelle N0-Fin au projet Finance. Les deux passerelles de niveau 0 s'exécutent sur le même cluster Edge.

Ce diagramme est décrit dans le texte qui s'y rapporte.

Les messages de journal pour les services de niveau 0 dans le Syslog Edge contiennent la chaîne suivante pour vous aider à identifier le contexte du projet :

org="default" proj="salespro"
org="default" proj="finanpro"

Par exemple, supposons que vous ayez activé le routage BGP sur les passerelles N0-Ventes et N0-Fin. *Les messages de journal pour ces deux passerelles de niveau 0 dans le Syslog Edge auront le contexte du projet, comme suit :

nsx-edge> 2023-06-27T03:31:38.717Z Edge NSX 6 ROUTING [nsx comp="nsx edge" subcomp="rcpm" s2comp="rcpm-db" level="INFO" org="default" proj="salespro"] BGP update request: Bgp Config
nsx-edge> 2023-06-27T03:31:39.717Z Edge NSX 6 ROUTING [nsx comp="nsx edge" subcomp="rcpm" s2comp="rcpm-db" level="INFO" org="default" proj="finanpro"] BGP update request: Bgp Config

Workflow d'API pour dédier une passerelle de niveau 0/VRF à un projet

Par exemple, supposons que vous ayez créé un projet nommé Ventes et alloué deux passerelles de niveau 0 nommées N0Ventes1 et N0Ventes2 à ce projet. Vous souhaitez dédier N0Ventes1 à ce projet. Pour ce faire, vous devez utiliser l'API project et ajouter le chemin d'accès à la passerelle N0Ventes1 dans la configuration dedicated_resources du projet Ventes.

Procédure

Récupérez la configuration du projet actuel en exécutant l'API GET suivante :
```
GET https://<nsx-mgr>/policy/api/v1/orgs/default/projects/Sales
```
Copiez la charge utile de la réponse de l'API GET et collez-la dans un éditeur de texte.
Dans la charge utile de la réponse, ajoutez le chemin d'accès à la passerelle N0Ventes1 dans la configuration dedicated_resources, comme suit :
```
"tier_0s": [
   "/infra/tier-0s/T0Sales1",
   "/infra/tier-0s/T0Sales2"
],
"dedicated_resources": {
   "tier_0s": ["/infra/tier-0s/T0Sales1"]
}
```
Pour en savoir plus sur le paramètre dedicated_resources dans l'API project, reportez-vous au Guide de NSX API.
Collez la charge utile de l'API mise à jour complète dans le corps de la demande de l'API PATCH suivante :
```
PATCH https://<nsx-mgr>/policy/api/v1/orgs/default/projects/Sales
```
Lorsque cette API s'exécute correctement, le projet Ventes est configuré pour utiliser N0Ventes1 comme passerelle de niveau 0 par défaut. Les messages de journal pour les services de niveau 0 exécutés sur cette passerelle dédiée auront désormais le contexte du projet Ventes dans le Syslog Edge.