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 eenreason
en/oferrorCode
set. -
Canceled
: de bewerking is geannuleerd.
Reden
Sommige gebeurtenissen hebben een reden dat ze zijn gestart. Tenzij anders aangegeven, worden deze ingesteld op de ClusterSizeIncreased
gebeurtenissen , NodeAdded
, NodeCreated
, NodeDeallocated
NodeStarted
, 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:
- 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 NodeCreated
gebeurtenissen , NodeDeallocated
, NodeStarted
en 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.