Zum Hauptinhalt springen

Run on Mesh

Eine Krankenhausgruppe verfügt häufig über Daten an mehreren Standorten, die nicht zentralisiert werden können. Mit Run on Mesh können Sie einen Workflow erstellen und verschiedene Teile davon an unterschiedlichen Standorten ausführen. Der Datenaustausch zwischen den Standorten erfolgt über Connect.

So funktioniert es​

Jeder Knoten in einem Workflow kann eine Platzierung enthalten: den Ort, an dem er ausgeführt wird. Beim Start eines Mesh-Laufs teilt der Koordinator den Workflow in Segmente auf – eine Gruppe von Knoten pro Platzierung. Jedes Segment wird auf der Workflow-Engine an diesem Ort (einem Spoke) ausgeführt. Die Ausgabe eines Segments wird über Connect als Hop zum nächsten Segment übertragen.

Läuft auf Mesh-Topologie: ein Koordinator, Executors an Standort A und Standort B, ein Connect-Hop zwischen ihnen und Statusereignisse, die an den Koordinator zurückgegeben werden.

  • Der Koordinator ist eine Rolle desselben Workflow-Engine-Servers (HYDRA_ROLE=coordinator oder Flag -coordinator). Er erstellt den Plan, protokolliert jeden Lauf und jedes Segment in Postgres und versendet nur das erste (Einstiegs-)Segment. Die Spokes führen die restlichen Segmente nacheinander aus.
  • Pläne und Umschläge enthalten Ed25519-Signaturen über kanonischem JSON. Die Signaturprüfung ist standardmäßig aktiviert.
  • Die an den Koordinator zurückgesendeten Statusereignisse sind standardmäßig frei von PHI: Es gibt keine knotenspezifischen Ein- oder Ausgaben, und Fehler werden auf einen geschlossenen Satz von Codes reduziert.
  • Daten, die über die Schnittstelle eine datenführende Website verlassen, werden pseudonymisiert, nicht anonymisiert. Sie können dennoch personenbezogene Daten im Sinne der DSGVO darstellen.

Was das Netz unterstützt​

Eigentümererklärung

Diese Funktionen sind laut Eigentümerbestätigung verfügbar. Den Funktionsstatus für die Quelle und die Verifizierungsgrenze, einschließlich älterer, noch nicht abgeglichener Konstruktionsdatensätze, finden Sie unter „Funktionsstatus“. Klären Sie die unterstützte Bereitstellung mit Ihrem Administrator ab.

  • Verknüpfungen, die Daten, einschließlich PHI, von mehreren Standorten kombinieren.
  • Zuverlässige, exakt einmalige Lieferung zwischen den Standorten.
  • Standortübergreifendes föderiertes Lernen.

Führe einen Workflow auf dem Mesh aus​

  1. Öffnen Sie den Workflow in Tiet · Studio → Workflows → Builder.
  2. Wählen Sie einen Knoten aus und öffnen Sie den Abschnitt Runtime des zugehörigen Inspektors. Wählen Sie unter Abschnitt Runs on (placement) einen Standort aus oder geben Sie einen ein. Das Feld schlägt den Hub und alle registrierten Spokes vor. Lassen Sie es leer, um den Knoten auf der Hydra-Plattform-VM außerhalb des Mesh auszuführen.
  3. Wiederholen Sie dies für die Knoten, die zu anderen Standorten gehören.
  4. Öffnen Sie das Menü Run Die Option Run on mesh (Beschreibung „Verteilt auf Standorte“) ist nun aktiviert. Solange kein Knoten eine Platzierung hat, ist diese Option deaktiviert, mit dem Hinweis „Setzen Sie die Runs-on-Platzierung eines Knotens auf aktivieren“.
  5. Wählen Sie Run on mesh. Ein Dialogfeld fordert Eingaben an, anschließend wird der Workflow gespeichert und die Ausführung gestartet.

Nach dem Start des Laufs öffnet sich im unteren Bereich ein MESH Tab. Wenn Sie von einem leeren Bereich aus starten, wird dort „Noch kein Mesh-Lauf. Markieren Sie die Position eines Knotens und wählen Sie „Auf Mesh ausführen“ aus.“ angezeigt.

Ablauf: Studio, Koordinator, Connect und zwei Speichen

Lesen Sie den MESH-Tab​

Der Tab fragt den Koordinator alle zwei Sekunden ab, bis der Lauf beendet ist. Er zeigt den Laufstatus, die Lauf-ID und die Plan-ID sowie die nach Platzierung gruppierten Segmente an. Jede Segmentzeile enthält ihre ID, den Speichenknoten (@spoke), eine ×N, wenn der Lauf mehrfach versucht wurde, ihren Status und einen Fehlercode im Fehlerfall.

AusführungsstatusBedeutung
pending, runningIm Gange
doneAlle Segmente abgeschlossen
failedEin Segment ist ausgefallen
stalledKein Fortschritt vor Ablauf der Frist (die Standard-Zeitpläne, Ausführungs- und Beitritts-Timeouts betragen 15 Minuten).
revokedDie Zugriffsrichtlinie des Fluges wurde widerrufen und der Not-Aus-Schalter stoppte ihn beim nächsten Sprung.
cancelledVon einem Benutzer gestoppt

Die Segmentstatus sind pending, running, done, skipped, failed, dlq und cancelled. Ergebnisse pro Knoten werden nur dann unter einem Segment angezeigt, wenn der Prozess mit HYDRA_MESH_STATUS_DETAIL=full konfiguriert ist. Dateninhaberseiten senden diese niemals.

Die Verwendung der Stopp-Funktion des Builders während eines aktiven Mesh-Laufs bricht diesen ab.

Wo soll ich sonst noch suchen?​

OrtWas Sie sehen
Tiet · Connect → Network → MeshStandorte, Speichen und deren Gesundheit
Tiet · Studio → Workflows → Builder, untere Leiste MESH RegisterkarteStatus des einzelnen Segments des von Ihnen gestarteten Laufs

Tiet · Connect → Netzwerk → Mesh: die Nabe und die registrierten Speichen

Sicherheitskontrollen​

KontrolleWirkung
Authentifizierung fehlgeschlagen/api/mesh Routen außer /api/mesh/health benötigen ein Bearer-Token. Eine leere Token-Konfiguration lehnt alle Verbindungen ab.
Unterschriebene Pläne und UmschlägeEs wurde eine Manipulation festgestellt. Ein Mesh-Prozess ohne seinen Truststore startet nicht.
Platzierungsbezogene TokenEin Site-Token kann nur Segmente seiner eigenen Platzierung abrufen, darüber berichten und sich mit ihnen verbinden.
Zugriffsrichtlinien-GatewayEin Lauf, der sich über mehrere Platzierungen erstreckt, benötigt eine veröffentlichte, nicht widerrufene und gültige Richtlinie, die zur Pipeline, dem Hash des kompilierten Plans und den Platzierungen passt. Andernfalls wird der Start mit SEAM_POLICY_MISSING, SEAM_POLICY_REVOKED, SEAM_POLICY_MISMATCH oder SEAM_REGIME_MIXED abgelehnt.
Not-Aus-SchalterDie Aufhebung einer Richtlinie beendet die zuvor zugelassenen Aktionen (revoked).
PHI-freie StatusereignisseDie Überwachung gibt keine Patientendaten preis.

Grenzen​

  • Run on mesh wird nur für einen gespeicherten Workflow angeboten (einen Workflow mit einer Pipeline-ID).
  • Durch die Stornierung werden die weiteren Arbeiten gestoppt, die Nebenwirkungen am Einsatzort werden jedoch nicht rückgängig gemacht.

Etwas unklar? Senden Sie Feedback zur Dokumentation per E-Mail..