Événements

2025-06-13

CycleCloud 8.0 génère des événements lorsque certains changements se produisent (par exemple, lorsqu'un nœud est créé ou qu'un cluster est supprimé). Certains événements sont instantanés (par exemple, la suppression d'un cluster) et certains événements représentent des transitions (par exemple, la création d'un nœud qui implique la création d'une VM). Dans ces cas, l'événement est envoyé à la fin de la transition, qu'elle soit réussie ou non.

Vous pouvez configurer CycleCloud pour publier sur une rubrique Event Grid en le connectant dans la page Paramètres de CycleCloud. Pour acheminer les événements vers une destination, telle qu'une file d'attente de stockage, attachez les abonnements aux événements Event Grid à la rubrique. Un programme peut consommer des événements et les traiter.

Objets d'événement

Les événements suivent le schéma Event Grid standard, avec tous les détails spécifiques à CycleCloud contenus dans la data propriété.

Nom	Catégorie	Descriptif
eventId	Chaîne	Identifie de manière unique l'événement
Heure de l'événement	Chaîne	L'heure de cet événement (aaaa-MM-jjTHH:mm:ss.SSSZZ)
typeÉvénement	Chaîne	Le type de transition d'état qui s'est produit (par exemple, `Microsoft.CycleCloud.NodeCreated`)
Objet	Chaîne	La ressource affectée (voir Objet de l'événement)
version des données	Chaîne	Le schéma utilisé pour `data` (actuellement « 1 »)

De plus, il existe plusieurs propriétés personnalisées data pour presque tous les événements :

Propriété	Catégorie	Descriptif
statut	Statut (Chaîne)	Que cette transition ait été réussie ou non
raison	Raison (Chaîne)	Pourquoi cet événement a été initié
Message	Chaîne	Un résumé lisible par l'homme de cet événement
code d'erreur	Chaîne	Le code de cette opération si elle a échoué ou n'était pas disponible. Notez que ce code peut provenir directement des appels Azure et peut ne pas être présent pour tous les échecs

Événements de cluster

CycleCloud envoie des événements lorsque les clusters sont modifiés. Les événements de cluster contiennent les propriétés communes suivantes dans data :

Propriété	Catégorie	Descriptif
nom du cluster	Chaîne	Le nom du cluster

Microsoft.CycleCloud.ClusterStarted

Cet événement est déclenché lorsqu'un cluster est démarré.

Microsoft.CycleCloud.ClusterTerminated

Cet événement est déclenché lorsqu'un cluster est terminé.

Microsoft.CycleCloud.ClusterDeleted

Cet événement est déclenché lorsqu'un cluster est supprimé.

Microsoft.CycleCloud.ClusterSizeIncreased

Cet événement est déclenché lorsque des nœuds sont ajoutés au cluster. Il y a un événement pour chaque ensemble de nœuds ajouté. (Les nœuds d’un ensemble ont tous la même définition.)

Propriété	Catégorie	Descriptif
nodeRequested	Nombre entier	Combien de nœuds ont été demandés pour cet ensemble
nodeAdded	Nombre entier	Combien de nœuds ont été ajoutés au cluster
nodeArray	Chaîne	Le réseau de nœuds à partir duquel ces nœuds ont été créés
ID d'abonnement	Chaîne	L'ID d'abonnement pour les ressources de ce nœud
région	Chaîne	L'emplacement de ce nœud
vmSku	Chaîne	Le SKU (c'est-à-dire le type de machine) de la machine virtuelle
priorité	Chaîne	Le modèle de tarification VM en vigueur (soit « régulier » ou « spot »)
placementGroupId	Chaîne	Le groupe de placement dans lequel se trouvent ces nœuds, le cas échéant

Événements du nœud

CycleCloud envoie des événements chaque fois que les nœuds passent d’un état à l’autre. Ces événements de nœud incluent un contexte supplémentaire dans la data propriété :

Propriété	Catégorie	Descriptif
statut	Statut (Chaîne)	Si cet événement a été un succès
nom du cluster	Chaîne	Le nom du cluster dans lequel se trouve ce nœud. Les noms ne sont pas uniques au fil du temps
nodeName	Chaîne	Le nom du nœud affecté. Les noms ne sont pas uniques au fil du temps
nodeId	Chaîne	L'ID du nœud. Les IDs de nœud sont uniques. Lorsqu'un nœud est supprimé, l'ID n'est pas disponible pour être réutilisé.
nodeArray	Chaîne	Le nom du tableau de nœuds à partir duquel ce nœud a été créé
identifiant de ressource	Chaîne	La ressource Azure pour la machine virtuelle, si une a été créée
ID d'abonnement	Chaîne	L'ID d'abonnement pour les ressources de ce nœud
région	Chaîne	L'emplacement de ce nœud
vmSku	Chaîne	Le SKU (c'est-à-dire le type de machine) de la machine virtuelle
priorité	Chaîne	Le modèle de tarification VM en vigueur (soit « régulier » ou « spot »)
placementGroupId	Chaîne	Le groupe de placement dans lequel se trouve ce nœud, le cas échéant
retryCount	Nombre entier	Combien de fois cette action spécifique a été tentée précédemment (voir Nombre de tentatives)
timing	(Objet)	Une carte des étapes de cet événement et de leurs durées (voir Timing)

Microsoft.CycleCloud.NodeAdded

Cet événement est déclenché pour chaque nœud ajouté à un cluster. Pour recevoir un événement unique pour plusieurs nœuds ajoutés simultanément, consultez ClusterSizeIncreased. Cet événement est envoyé lorsque le nœud apparaît pour la première fois dans l’interface utilisateur ; il ne contient donc aucune information de minutage.

Microsoft.CycleCloud.NodeCreated

Cet événement est déclenché chaque fois qu’un nœud démarre pour la première fois (c’est-à-dire lorsqu’une machine virtuelle est créée pour le nœud). Il inclut les détails de minutage suivants :

Create : Le temps total nécessaire pour créer le nœud. Cette période comprend la création de la VM et sa configuration.
CreateVM : Combien de temps il a fallu pour créer la VM.
Configure : Combien de temps a-t-il fallu pour installer le logiciel et configurer le nœud.

Microsoft.CycleCloud.NodeDeallocated

Cet événement est déclenché chaque fois qu’un nœud est désalloué. Il inclut les détails de minutage suivants :

Deallocate : Le temps total nécessaire pour désallouer le nœud.
DeallocateVM : Combien de temps il a fallu pour désallouer la machine virtuelle.

Microsoft.CycleCloud.NodeStarted

Cet événement est déclenché chaque fois qu’un nœud redémarre d’un état de désallocation. Il inclut les détails de minutage suivants :

Start : Le temps total nécessaire pour redémarrer le nœud désalloué.
StartVM : Combien de temps il a fallu pour démarrer la machine virtuelle désallouée.

Microsoft.CycleCloud.NodeTerminated

Cet événement est déclenché chaque fois qu’un nœud est arrêté et que sa machine virtuelle est supprimée. Il inclut les détails de minutage suivants :

Terminate : Le temps total nécessaire pour terminer le nœud.
DeleteVM : Combien de temps il a fallu pour supprimer la VM.

Sujet

Chaque événement a un sujet que vous pouvez utiliser pour filtrer dans Event Grid. Les événements dans CycleCloud ont des sujets selon le modèle suivant :

/sites/SITENAME : pour les événements spécifiques à une installation CycleCloud donnée
/sites/SITENAME/clusters/CLUSTERNAME : pour les événements au niveau du cluster
/sites/SITENAME/clusters/CLUSTERNAME/nodes/NODENAME : pour les événements au niveau du nœud

Ce modèle vous permet de « limiter » un abonnement Event Grid à un préfixe spécifique pour collecter un sous-ensemble d'événements. Utilisez ce modèle avec le filtrage de type d’événement.

Statut

Succeeded : l'opération a réussi.
Failed : l'opération n'a pas réussi. Il y a souvent un ensemble reason et/ou errorCode.
Canceled : l'opération a été annulée.

Motif

Certains événements ont une raison d’être. Sauf indication contraire, ces raisons sont fixées sur les événements ClusterSizeIncreased, NodeAdded, NodeCreated, NodeDeallocated, NodeStarted, et NodeTerminated.

Autoscaled : le nœud a été modifié en réponse à une requête de mise à l'échelle automatique effectuée via l'API
UserInitiated : l'opération a été effectuée directement via l'interface utilisateur ou la CLI
System : CycleCloud a initié l'opération (par exemple, par défaut, les nœuds d'exécution sont automatiquement supprimés du cluster une fois terminés)
SpotEvicted : une éviction de VM spot a déclenché l'événement (événements NodeTerminated uniquement)
VMDisappeared : une disparition de VM non ponctuelle a déclenché l'événement (événements NodeTerminated uniquement)
AllocationFailed : la VM n'a pas pu être allouée en raison de contraintes de placement ou de capacité (événements NodeTerminated/NodeDeallocated uniquement, avec le statut indiquant le résultat de l'opération de terminaison/désallocation)

Remarque

Le reason est défini sur les événements NodeTerminated pour indiquer pourquoi le nœud a été terminé. Lorsqu’un nœud ne parvient pas à être créé en raison de la capacité, il échoue avec le code d’erreur spécifique d’Azure (dont il existe plusieurs). Le nœud est alors automatiquement terminé, et la raison de la fin est AllocationFailed. Lorsqu'une machine virtuelle Spot en cours d'exécution est expulsée, l'opération de création a déjà réussi. Le nœud est alors automatiquement terminé et la raison donnée pour l'événement de terminaison est SpotEvicted.

Synchronisation

Certains événements contiennent des informations de minutage. L'entrée timing dans data est un objet avec des clés correspondant aux étapes de l'événement et des valeurs en secondes totales. Chaque événement peut avoir plusieurs étapes de minutage associées. Par exemple, supposons qu’un nœud soit ajouté à un cluster, démarré et terminé :

!Diagramme de minutage Event Grid

T1 : L’utilisateur ajoute un nœud. Un événement NodeAdded est envoyé, sans minutage.
T2 : L'opération de création de VM échoue, NodeCreated est donc envoyée avec un statut Échec et les informations de minutage suivantes :
- Create : T2-T1
- CreateVM : T2-T1
T3 : L'utilisateur clique sur Réessayer
T4 : L’opération Create-VM réussit, le nœud commence donc l’installation du logiciel.
T5. Le logiciel s'installe avec succès, NodeCreated est donc envoyé avec le statut Réussi et les informations de minutage suivantes :
- Create : (T5-T3)
- CreateVM : (T4-T3)
- Configure : (T5-T4)
T6 : L’utilisateur clique sur Terminer.
T7 : L'opération de suppression de la machine virtuelle réussit, NodeTerminated est donc envoyée avec un état Réussi et les informations de minutage suivantes :
- Started : T6-T5
- Terminate : T7-T6
- DeleteVM : T7-T6

Minutage de l’état précédent

La première fois qu'un nœud passe à un état (avec succès ou non), il n'a aucun état précédent. Lorsque l’état cible change après ce point, le temps passé dans l’état précédent est inclus dans l’événement pour le nouvel état cible. Ce minutage n'est inclus que si le nœud a atteint avec succès l'état précédent. Ces entrées de minutage mesurent la durée des états suivants :

Started : avant cet événement, le nœud était en cours d'exécution (c'est-à-dire vert)
Deallocated : avant cet événement, le nœud a été désalloué
Terminated : avant cet événement, le nœud était éteint

Vous pouvez utiliser ce minutage pour suivre la durée d'exécution d'une machine virtuelle Spot avant son expulsion.

Nombre de nouvelles tentatives

Dans CycleCloud, vous pouvez réessayer certaines opérations si elles échouent. Ces opérations se reflètent dans les événements NodeCreated, NodeDeallocated, NodeStarted, et NodeTerminated. Ces événements contiennent une propriété retryCount facultative sur la propriété data de l'événement qui indique combien de fois l'opération a été tentée avant cet événement. Cette propriété est incluse lors des tentatives ultérieures, que ces tentatives aient réussi ou échoué.