Freigeben über


Ereignisse

CycleCloud 8.0 generiert Ereignisse , wenn bestimmte Änderungen vorgenommen werden (z. B. beim Erstellen eines Knotens oder beim Löschen eines Clusters). Einige Ereignisse sind sofort (z. B. das Löschen eines Clusters) und einige Ereignisse stellen Übergänge dar (z. B. das Erstellen eines Knotens, der das Erstellen einer VM impliziert). In diesen Fällen wird das Ereignis am Ende des Übergangs gesendet, ob erfolgreich oder nicht.

Sie können CycleCloud so konfigurieren, dass es in einem Ereignisrasterthema veröffentlicht wird, indem Sie es auf der Seite " CycleCloud-Einstellungen" verbinden. Um die Ereignisse an ein Ziel weiterzuleiten, z. B. eine Speicherwarteschlange, fügen Sie Event Grid Ereignisabonnements an das Thema an. Ein Programm kann Ereignisse nutzen und verarbeiten.

Ereignisobjekte

Die Ereignisse folgen dem standardmäßigen Ereignisrasterschema, wobei alle CycleCloud-spezifischen Details in der data Eigenschaft enthalten sind.

Name Typ BESCHREIBUNG
eventId Schnur Identifiziert das Ereignis eindeutig.
Ereigniszeit Schnur Die Uhrzeit dieses Ereignisses (yyyy-MM-ddTHH:mm:ss). SSSZZ)
Ereignistyp Schnur Die Art des Zustandsübergangs, der aufgetreten ist (z. B Microsoft.CycleCloud.NodeCreated. )
subject Schnur Die betroffene Ressource (siehe Ereignisbetreff)
dataVersion Schnur Das schema, das für data (derzeit "1") verwendet wird

Darüber hinaus gibt es in data für fast alle Ereignisse mehrere benutzerdefinierte Eigenschaften.

Eigentum Typ BESCHREIBUNG
status Status (Zeichenfolge) Ob dieser Übergang erfolgreich war oder nicht
Grund Reason (Zeichenstring) Warum dieses Ereignis initiiert wurde
Nachricht Schnur Eine lesbare Zusammenfassung dieses Ereignisses
Fehlercode Schnur Der Code für diesen Vorgang, wenn er fehlgeschlagen ist oder nicht verfügbar war. Beachten Sie, dass dieser Code möglicherweise direkt aus Azure-Aufrufen stammt und möglicherweise nicht für alle Fehler vorhanden ist.

Clusterereignisse

CycleCloud sendet Ereignisse, wenn Cluster geändert werden. Clusterereignisse enthalten die folgenden allgemeinen Eigenschaften in data:

Eigentum Typ BESCHREIBUNG
clusterName Schnur Der Name des Clusters

Microsoft.CycleCloud.ClusterStarted

Dieses Ereignis wird ausgelöst, wenn ein Cluster gestartet wird.

Microsoft.CycleCloud.ClusterTerminated

Dieses Ereignis wird ausgelöst, wenn ein Cluster beendet wird.

Microsoft.CycleCloud.ClusterDeleted

Dieses Ereignis wird ausgelöst, wenn ein Cluster gelöscht wird.

Microsoft.CycleCloud.ClusterSizeIncreased

Dieses Ereignis wird ausgelöst, wenn knoten dem Cluster hinzugefügt werden. Es gibt ein Ereignis für jede hinzugefügte Gruppe von Knoten. (Knoten in einem Satz weisen alle dieselbe Definition auf.)

Eigentum Typ BESCHREIBUNG
nodesRequested Integer Wie viele Knoten für diesen Satz angefordert wurden
nodesAdded Integer Anzahl der Knoten, die dem Cluster hinzugefügt wurden
nodeArray Schnur Das Knotenarray, aus dem diese Knoten erstellt wurden
Abonnement-ID Schnur Die Abonnement-ID für die Ressourcen dieses Knotens
region Schnur Die Position dieses Knotens
vmSku Schnur Die SKU (d. a. Computertyp) für den virtuellen Computer
Priorität Schnur Das geltende VM-Preismodell (entweder „normal“ oder „spot“)
placementGroupId Schnur Die Platzierungsgruppe, in der sich diese Knoten befinden, falls vorhanden

Knotenereignisse

CycleCloud sendet Ereignisse, wenn Knoten zwischen Zuständen wechseln. Diese Knotenereignisse enthalten zusätzlichen Kontext innerhalb der data Eigenschaft:

Eigentum Typ BESCHREIBUNG
status Status (Zeichenfolge) Ob dieses Ereignis erfolgreich war
clusterName Schnur Der Name des Clusters, in dem sich dieser Knoten befindet. Namen sind nicht dauerhaft eindeutig.
nodeName Schnur Der Name des Knotens, der betroffen ist. Namen sind nicht dauerhaft eindeutig.
nodeId Schnur Die ID des Knotens Knoten-IDs sind eindeutig. Wenn ein Knoten gelöscht wird, steht die ID nicht zur Wiederverwendung zur Verfügung.
nodeArray Schnur Der Name des Knotenarrays, aus dem dieser Knoten erstellt wurde
Ressourcen-ID Schnur Die Azure-Ressource für den virtuellen Computer, wenn eine erstellt wurde
Abonnement-ID Schnur Die Abonnement-ID für die Ressourcen dieses Knotens
region Schnur Die Position dieses Knotens
vmSku Schnur Die SKU (d. a. Computertyp) für den virtuellen Computer
Priorität Schnur Das geltende VM-Preismodell (entweder „normal“ oder „spot“)
placementGroupId Schnur Die Platzierungsgruppe, in der sich dieser Knoten befindet, falls vorhanden
retryCount Integer Wie oft diese bestimmte Aktion zuvor versucht wurde (siehe Wiederholungsanzahl)
Zeitplanung (Objekt) Eine Karte der Phasen in diesem Ereignis und deren Dauer (siehe Timing)

Microsoft.CycleCloud.NodeAdded

Dieses Ereignis wird für jeden Knoten ausgelöst, der einem Cluster hinzugefügt wurde. Informationen zum Empfangen eines einzelnen Ereignisses für mehrere gleichzeitig hinzugefügte Knoten finden Sie unter ClusterSizeIncreased. Dieses Ereignis wird gesendet, wenn der Knoten zuerst in der Benutzeroberfläche angezeigt wird und besitzt daher keine zeitlichen Informationen.

Microsoft.CycleCloud.NodeCreated

Dieses Ereignis wird jedes Mal ausgelöst, wenn ein Knoten zum ersten Mal gestartet wird (d. a. wenn ein virtueller Computer für den Knoten erstellt wird). Es enthält die folgenden zeitlichen Details:

  • Create: Die Gesamtzeit zum Erstellen des Knotens. Diese Zeit umfasst das Erstellen des virtuellen Computers und das Konfigurieren des virtuellen Computers.
  • CreateVM: Wie lange es dauerte, um den virtuellen Computer zu erstellen.
  • Configure: Wie lange es dauerte, software zu installieren und den Knoten zu konfigurieren.

Microsoft.CycleCloud.NodeDeallocated

Dieses Ereignis wird jedes Mal ausgelöst, wenn die Zuordnung eines Knotens aufgehoben wird. Es enthält die folgenden zeitlichen Details:

  • Deallocate: Gesamtzeit für die Zuordnung des Knotens
  • DeallocateVM: Zeitaufwand für die Aufhebung der VM-Zuordnung

Microsoft.CycleCloud.NodeStarted

Dieses Ereignis wird jedes Mal ausgelöst, wenn ein nicht zugeordneter Knoten neu gestartet wird. Es enthält die folgenden zeitlichen Details:

  • Start: Die Gesamtzeit, die zum Neustart des freigegebenen Knotens benötigt wurde.
  • StartVM: Wie lange es dauerte, um die zugeordnete VM zu starten.

Microsoft.CycleCloud.NodeTerminated

Dieses Ereignis wird jedes Mal ausgelöst, wenn ein Knoten beendet wird und seine VM gelöscht wird. Es enthält die folgenden zeitlichen Details:

  • Terminate: Die Gesamtzeit, die zum Beenden des Knotens benötigt wurde.
  • DeleteVM: Wie lange es dauerte, um den virtuellen Computer zu löschen.

Betreff

Jedes Ereignis verfügt über einen Betreff, den Sie zum Filtern im Ereignisraster verwenden können. Ereignisse in CycleCloud haben Themen im folgenden Muster:

  • /sites/SITENAME: für Ereignisse, die für eine bestimmte CycleCloud-Installation spezifisch sind
  • /sites/SITENAME/clusters/CLUSTERNAME: für Ereignisse auf Clusterebene
  • /sites/SITENAME/clusters/CLUSTERNAME/nodes/NODENAME: für Ereignisse auf Knotenebene

Mit diesem Muster können Sie ein Event Grid-Abonnement auf ein spezifisches Präfix einschränken, um eine Teilmenge von Ereignissen zu erfassen. Verwenden Sie dieses Muster mit der Ereignistypfilterung.

Der Status

  • Succeeded: Der Vorgang war erfolgreich.
  • Failed: Der Vorgang war nicht erfolgreich. Häufig gibt es ein reason und/oder errorCode Set.
  • Canceled: Der Vorgang wurde abgebrochen.

Ursache

Einige Ereignisse haben einen Grund, initiiert zu werden. Sofern nicht anders angegeben, werden diese Gründe bei den ClusterSizeIncreased, NodeAdded, NodeCreated, NodeDeallocated, NodeStarted und NodeTerminated Ereignissen festgelegt.

  • Autoscaled: Der Knoten wurde als Reaktion auf eine über die API vorgenommene automatische Skalierungsanforderung geändert.
  • UserInitiated: Der Vorgang wurde direkt über die Benutzeroberfläche oder CLI durchgeführt.
  • System: CycleCloud hat den Vorgang initiiert (z. B. werden ausführungsknoten standardmäßig automatisch aus dem Cluster entfernt, wenn er beendet wird)
  • SpotEvicted: Das Ereignis wurde durch das Entfernen einer Spot-VM-ausgelöst (nur NodeTerminated-Ereignisse)
  • VMDisappeared: Das Verschwinden einer Nicht-Spot-VM löste das Ereignis aus (nur NodeTerminated-Ereignisse)
  • AllocationFailed: Der virtuelle Computer konnte aufgrund von Platzierungs- oder Kapazitätsbeschränkungen nicht zugeordnet werden (nur NodeTerminated/NodeDeallocated-Ereignisse, wobei der Status das Ergebnis des Terminierungs-/Deallocate-Vorgangs angibt)

Hinweis

Die reason Einstellung ist für NodeTerminated-Ereignisse festgelegt, um anzugeben, warum der Knoten beendet wurde. Wenn ein Knoten aufgrund der Kapazität nicht erstellt werden kann, schlägt er mit dem spezifischen Fehlercode aus Azure fehl (von denen mehrere vorhanden sind). Der Knoten wird dann automatisch beendet, und der Grund für die Beendigung ist AllocationFailed. Wenn eine ausgeführte Spot-VM entfernt wird, war der Erstellungsvorgang bereits erfolgreich. Der Knoten wird dann automatisch beendet, und der für das Beendigungsereignis angegebene Grund lautet SpotEvicted.

Zeitplanung

Einige Ereignisse enthalten Zeitinformationen. Der timing Eintrag in data ist ein Objekt mit Schlüsseln, die Phasen des Ereignisses entsprechen, und Werte in Gesamtsekunden. Jedem Ereignis können mehrere Zeitphasen zugeordnet sein. Angenommen, ein Knoten wird einem Cluster hinzugefügt, gestartet und beendet:

!Ereignisgitter-Zeitdiagramm

  • T1: Der Benutzer fügt einen Knoten hinzu. Ein NodeAdded Ereignis wird ohne Anzeigedauer gesendet.
  • T2: Der Erstellen-VM-Vorgang schlägt fehl, daher wird NodeCreated mit dem Status "Fehlgeschlagen" und den folgenden Zeitinformationen gesendet.
    • Create: T2-T1
    • CreateVM: T2-T1
  • T3: Der Benutzer klickt auf "Wiederholen".
  • T4: Der Create-VM-Vorgang ist erfolgreich, sodass der Knoten mit der Installation von Software beginnt.
  • T5. Da die Software erfolgreich installiert wird, wird NodeCreated mit dem Status "Erfolgreich" und den folgenden Zeitinformationen gesendet.
    • Create: (T5-T3)
    • CreateVM: (T4-T3)
    • Configure: (T5-T4)
  • T6: Der Benutzer klickt auf "Beenden".
  • T7: Der Vorgang "Delete-VM" gelingt, sodass NodeTerminated mit dem Status "Erfolgreich" und den folgenden Zeitinformationen gesendet wird.
    • Started: T6-T5
    • Terminate: T7-T6
    • DeleteVM: T7-T6

Dauer des vorherigen Zustands

Wenn ein Knoten zum ersten Mal in einen Zustand übergibt (ob erfolgreich oder nicht), hat er keinen vorherigen Zustand. Wenn sich der Zielstatus nach diesem Punkt ändert, wird die im vorherigen Zustand aufgewendete Zeit im Ereignis für den neuen Zielzustand eingeschlossen. Diese Zeitmessung ist nur enthalten, wenn der Knoten den vorherigen Zustand erfolgreich erreicht hat. Diese Zeiteinträge messen die Zeitdauer für die folgenden Zustände:

  • Started: Vor diesem Ereignis war der Knoten aktiv (d. h. grün)
  • Deallocated: Vor diesem Ereignis wurde die Zuordnung des Knotens aufgehoben
  • Terminated: Vor diesem Ereignis war der Knoten deaktiviert.

Sie können diese Zeitmessung verwenden, um nachzuverfolgen, wie lange eine Spot-VM ausgeführt wurde, bevor sie entfernt wurde.

Anzahl der Wiederholungsversuche

In CycleCloud können Sie einige Vorgänge wiederholen, wenn sie fehlschlagen. Diese Vorgänge werden in den NodeCreated, NodeDeallocated, NodeStarted und NodeTerminated Ereignissen widergespiegelt. Diese Ereignisse enthalten eine optionale retryCount Eigenschaft in der Eigenschaft data des Ereignisses, die angibt, wie oft der Vorgang vor diesem Ereignis versucht wurde. Diese Eigenschaft ist in nachfolgenden Wiederholungen enthalten, unabhängig davon, ob diese Versuche erfolgreich oder fehlerhaft waren.