gebeurtenis

CycleCloud 8.0 genereert gebeurtenissen wanneer bepaalde wijzigingen plaatsvinden (bijvoorbeeld wanneer een knooppunt wordt gemaakt of een cluster wordt verwijderd). Sommige gebeurtenissen zijn onmiddellijk (bijvoorbeeld het verwijderen van een cluster) en sommige gebeurtenissen vertegenwoordigen overgangen (bijvoorbeeld het maken van een knooppunt, wat het maken van een VM impliceert). In deze gevallen wordt de gebeurtenis aan het einde van de overgang verzonden, ongeacht of deze is geslaagd of niet.

CycleCloud kan worden geconfigureerd om te publiceren naar een Event Grid-onderwerp door het te verbinden op de pagina CycleCloud-instellingen in CycleCloud. Event Grid-gebeurtenisabonnementen kunnen aan het onderwerp worden gekoppeld om de gebeurtenissen te routeren naar een bestemming, zoals een opslagwachtrij, waar een programma gebeurtenissen kan gebruiken en verwerken.

Gebeurtenisobjecten

De gebeurtenissen bevinden zich in het standaard-Event Grid-schema. Alle CycleCloud-specifieke elementen bevinden zich in de data eigenschap van de gebeurtenis.

Naam	Type	Description
eventId	Tekenreeks	De gebeurtenis wordt uniek geïdentificeerd
eventTime	Tekenreeks	De tijd van deze gebeurtenis (jjjj-MM-ddTHH:mm:ss. SSSZZ)
eventType	Tekenreeks	Het type statusovergang dat is opgetreden (bijvoorbeeld Microsoft.CycleCloud.NodeCreated)
onderwerp	Tekenreeks	De betrokken resource (zie Gebeurtenisonderwerp)
dataVersion	Tekenreeks	Het schema dat wordt gebruikt voor data (momenteel '1')

Daarnaast zijn er verschillende aangepaste eigenschappen in data voor bijna alle gebeurtenissen:

Eigenschap	Type	Description
status	Status (tekenreeks)	Of deze overgang is geslaagd of niet
reason	Reden (tekenreeks)	Waarom deze gebeurtenis is gestart
message	Tekenreeks	Een voor mensen leesbare samenvatting van deze gebeurtenis
errorCode	Tekenreeks	De code voor deze bewerking als deze is mislukt of niet beschikbaar is. Houd er rekening mee dat dit rechtstreeks afkomstig is van Azure-aanroepen en mogelijk niet aanwezig is voor alle fouten

Clustergebeurtenissen

CycleCloud verzendt gebeurtenissen wanneer clusters worden gewijzigd. Clustergebeurtenissen bevatten de volgende algemene eigenschappen in data:

Eigenschap	Type	Description
clusterName	Tekenreeks	De naam van het cluster

Microsoft.CycleCloud.ClusterStarted

Deze gebeurtenis wordt geactiveerd wanneer een cluster wordt gestart.

Microsoft.CycleCloud.ClusterTerminated

Deze gebeurtenis wordt geactiveerd wanneer een cluster wordt beëindigd.

Microsoft.CycleCloud.ClusterDeleted

Deze gebeurtenis wordt geactiveerd wanneer een cluster wordt verwijderd.

Microsoft.CycleCloud.ClusterSizeIncreased

Deze gebeurtenis wordt geactiveerd wanneer knooppunten worden toegevoegd aan het cluster. Er is één gebeurtenis voor elke set knooppunten die wordt toegevoegd. (Knooppunten in een set hebben allemaal dezelfde definitie.)

Eigenschap	Type	Description
nodesRequested	Geheel getal	Hoeveel knooppunten zijn aangevraagd voor deze set
nodesAdded	Geheel getal	Hoeveel knooppunten er daadwerkelijk aan het cluster zijn toegevoegd
nodeArray	Tekenreeks	De nodearray van deze knooppunten zijn gemaakt op basis van
subscriptionId	Tekenreeks	De abonnements-id voor de resources van dit knooppunt
regio	Tekenreeks	De locatie van dit knooppunt
vmSku	Tekenreeks	De SKU (dat wil zeggen, machinetype) voor de VM
priority	Tekenreeks	Het VM-prijsmodel dat van kracht is ('normaal' of 'spot')
placementGroupId	Tekenreeks	De plaatsingsgroep waarin deze knooppunten zich bevinden, indien aanwezig

Knooppunten

CycleCloud verzendt gebeurtenissen wanneer knooppunten van status veranderen. Knooppunten bevatten aanvullende informatie in de data eigenschap:

Eigenschap	Type	Description
status	Status (tekenreeks)	Of deze gebeurtenis is geslaagd of niet
clusterName	Tekenreeks	De naam van het cluster waarin dit knooppunt zich bevindt. Namen zijn na verloop van tijd niet uniek
nodeName	Tekenreeks	De naam van het knooppunt dat wordt beïnvloed. Namen zijn na verloop van tijd niet uniek
nodeId	Tekenreeks	De id van dit knooppunt. Knooppunt-id's zijn na verloop van tijd uniek en zodra een knooppunt is verwijderd, wordt de id niet opnieuw gebruikt
nodeArray	Tekenreeks	De naam van de knooppuntmaarray van waaruit dit knooppunt is gemaakt
resourceId	Tekenreeks	De Azure-resource voor de VM, als er een is gemaakt
subscriptionId	Tekenreeks	De abonnements-id voor de resources van dit knooppunt
regio	Tekenreeks	De locatie van dit knooppunt
vmSku	Tekenreeks	De SKU (machinetype) voor de VM
priority	Tekenreeks	Het VM-prijsmodel dat van kracht is ('normaal' of 'spot')
placementGroupId	Tekenreeks	De plaatsingsgroep waarin dit knooppunt zich bevindt, indien aanwezig
retryCount	Geheel getal	Hoe vaak is deze specifieke actie eerder geprobeerd (zie Aantal nieuwe pogingen)
Timing	(Object)	Een kaart met fasen in deze gebeurtenis en de duur ervan (zie Timing)

Microsoft.CycleCloud.NodeAdded

Deze gebeurtenis wordt geactiveerd voor elk knooppunt dat wordt toegevoegd aan een cluster. (Zie ClusterSizeIncreased als u een gebeurtenis voor een set knooppunten tegelijk wilt ophalen.) Dit wordt verzonden wanneer het knooppunt voor het eerst wordt weergegeven in de gebruikersinterface, zodat het geen tijdsinformatie heeft.

Microsoft.CycleCloud.NodeCreated

Deze gebeurtenis wordt telkens geactiveerd wanneer een knooppunt voor het eerst wordt gestart (dat wil zeggen dat er een VM voor wordt gemaakt). Deze gebeurtenis bevat de volgende informatie over timing:

• Create: De totale tijd voor het maken van het knooppunt. Dit omvat het maken van de VM en het configureren van de VM.
• CreateVM: hoe lang het duurde om de virtuele machine te maken.
• Configure: hoe lang het duurde om software te installeren en het knooppunt te configureren.

Microsoft.CycleCloud.NodeDeallocated

Deze gebeurtenis wordt telkens geactiveerd wanneer de toewijzing van een knooppunt ongedaan wordt gemaakt. Deze gebeurtenis bevat de volgende informatie over timing:

• Deallocate: de totale tijd voor het ongedaan maken van de toewijzing van het knooppunt.
• DeallocateVM: hoe lang het duurde om de toewijzing van de VM ongedaan te maken.

Microsoft.CycleCloud.NodeStarted

Deze gebeurtenis wordt telkens geactiveerd wanneer een knooppunt opnieuw wordt gestart vanuit een status waarvoor de toewijzing ongedaan is gemaakt. Deze gebeurtenis bevat de volgende informatie over timing:

• Start: de totale tijd die nodig was om het toewijzingsknooppunt opnieuw op te starten.
• StartVM: hoe lang het duurde om de vm te starten die de toewijzing ongedaan heeft gemaakt.

Microsoft.CycleCloud.NodeTerminated

Deze gebeurtenis wordt steeds geactiveerd wanneer een knooppunt wordt beëindigd en de VM wordt verwijderd. Deze gebeurtenis bevat de volgende informatie over timing:

• Terminate: de totale tijd die nodig was om het knooppunt te beëindigen.
• DeleteVM: hoe lang het duurde om de VM te verwijderen.

Onderwerp

Elke gebeurtenis heeft een 'onderwerp' dat kan worden gebruikt voor het filteren in Event Grid. Gebeurtenissen in CycleCloud hebben onderwerpen in het volgende patroon:

• /sites/SITENAME: voor gebeurtenissen die specifiek zijn voor een bepaalde CycleCloud-installatie
• /sites/SITENAME/clusters/CLUSTERNAME: voor gebeurtenissen op clusterniveau
• /sites/SITENAME/clusters/CLUSTERNAME/nodes/NODENAME: voor gebeurtenissen op knooppuntniveau

Hiermee kunt u een Event Grid-abonnement 'instellen' op een specifiek voorvoegsel om een subset van gebeurtenissen te verzamelen. Dit kan worden gebruikt in combinatie met het filteren van gebeurtenistype.

Status

• Succeeded: de bewerking is geslaagd.
• Failed: de bewerking is mislukt. Er is vaak een reason en/of errorCode set.
• Canceled: de bewerking is geannuleerd.

Reden

Sommige gebeurtenissen hebben een reden dat ze zijn gestart. Tenzij anders aangegeven, worden deze ingesteld op de ClusterSizeIncreasedgebeurtenissen , NodeAdded, NodeCreated, NodeDeallocatedNodeStarted, en NodeTerminated .

• Autoscaled: het knooppunt is gewijzigd als reactie op een aanvraag voor automatisch schalen via de API
• UserInitiated: de bewerking is rechtstreeks via de gebruikersinterface of CLI uitgevoerd
• System: de bewerking is geïnitieerd door CycleCloud (bijvoorbeeld: standaard worden uitvoeringsknooppunten automatisch verwijderd uit het cluster wanneer deze wordt beëindigd)
• SpotEvicted: de gebeurtenis is geactiveerd omdat een spot-VM is verwijderd (alleen NodeTerminated-gebeurtenissen)
• VMDisappeared: de gebeurtenis is geactiveerd omdat een niet-spot-VM is verdwenen (alleen NodeTerminated-gebeurtenissen)
• AllocationFailed: de VM kan niet worden toegewezen vanwege plaatsing of capaciteitsbeperkingen (alleen NodeTerminated/NodeDeallocated-gebeurtenissen, waarbij de status het resultaat aangeeft van de bewerking beëindigen/toewijzing ongedaan maken)

Notitie

De reason wordt ingesteld op NodeTerminated-gebeurtenissen om aan te geven waarom het knooppunt is beëindigd. Wanneer een knooppunt niet kan worden gemaakt vanwege capaciteit, mislukt het met de specifieke foutcode van Azure (waarvan er meerdere zijn). Het knooppunt wordt vervolgens automatisch beëindigd en de reden voor de beëindiging is AllocationFailed. Wanneer een actieve spot-VM wordt verwijderd, is de maakbewerking al voltooid. Het knooppunt wordt vervolgens automatisch beëindigd en de reden voor de beëindigingsgebeurtenis is SpotEvicted.

Timing

Sommige gebeurtenissen bevatten tijdsinformatie. De timing vermelding in data is een object met sleutels die overeenkomen met fasen van de gebeurtenis en waarden als totaal aantal seconden. Aan elke gebeurtenis kunnen meerdere timingfasen zijn gekoppeld. Stel dat een knooppunt wordt toegevoegd aan een cluster, gestart en beëindigd:

! Tijdsdiagram van Event Grid

• T1: Gebruiker voegt een knooppunt toe. Er wordt een NodeAdded gebeurtenis verzonden, zonder timing.
• T2: De bewerking create-VM mislukt, dus NodeCreated wordt verzonden met de status Mislukt en de volgende tijdsinformatie:
  • Create: T2-T1
  • CreateVM: T2-T1
• T3: Gebruiker klikt op Opnieuw
• T4: De bewerking Create-VM slaagt, dus het knooppunt begint met het installeren van software.
• T5. De software wordt geïnstalleerd, dus NodeCreated wordt verzonden met de status Geslaagd en de volgende tijdsgegevens:
  • Create: (T5-T3)
  • CreateVM: (T4-T3)
  • Configure: (T5-T4)
• T6: Gebruiker klikt op Beëindigen.
• T7: De bewerking delete-VM slaagt, dus NodeTerminated wordt verzonden met de status Geslaagd en de volgende tijdsinformatie:
  • Started: T6-T5
  • Terminate: T7-T6
  • DeleteVM: T7-T6

Tijdsinstellingen voor vorige status

De eerste keer dat een knooppunt overgaat naar een status (of dit nu lukt of niet), heeft het geen vorige status. Wanneer de doelstatus na dat punt wordt gewijzigd, wordt de tijd die in de vorige status is besteed, opgenomen in de gebeurtenis voor de nieuwe doelstatus. Houd er rekening mee dat dit alleen wordt opgenomen als de vorige status is bereikt. Deze tijdsvermeldingen meten dus de tijdsduur voor het volgende:

• Started: vóór deze gebeurtenis werd het knooppunt uitgevoerd (dat wil zeggen groen)
• Deallocated: vóór deze gebeurtenis was de toewijzing van het knooppunt ongedaan gemaakt
• Terminated: vóór deze gebeurtenis was het knooppunt uitgeschakeld

Dit kan bijvoorbeeld worden gebruikt om bij te houden hoe lang een spot-VM werd uitgevoerd voordat deze werd verwijderd.

Aantal nieuwe pogingen

Sommige bewerkingen kunnen opnieuw worden uitgevoerd in CycleCloud als ze mislukken. Deze bewerkingen worden weergegeven in de NodeCreatedgebeurtenissen , NodeDeallocated, NodeStarteden NodeTerminated . Deze gebeurtenissen bevatten een optionele retryCount eigenschap voor de eigenschap van data de gebeurtenis die aangeeft hoe vaak eerder de bewerking is geprobeerd. Deze eigenschap is opgenomen in volgende nieuwe pogingen, ongeacht of deze pogingen zijn geslaagd of mislukt.