_NGA_Backend

_NGA_Backend-Datenpunkt ist wie folgt strukturiert (Defaultwerte basieren auf InfluxDB®-Backend):

Elementame Typ Default Beschreibung
general struct - Enthält die Unterelemente
active bool true Backend (ist aktiviert (kann verwendet werden oder nicht).
isLicensed bool false Wird für interne Lizenzüberprüfung verwendet und ist nur gültig, wenn ein Backend/Gruppe aktiv ist. Die Lizenzinformation wird im User Interface angezeit. Siehe Kapitel Backend-Liste.
discardIncomingValues bool false Werte/Alarme sollen nicht gespeichert werden (Lesezugriff).
discardReads bool false Leseanforderungen sollen nicht beantwortet werden (nur Schreiben).
pluginName string Name des Backends.
backendProcCtrl bool true Start / stop Backend.
backendProcMgmt bool true Wird derzeit nicht verwendet.
backendType int 0

0: Wird für den NGA-Manager und "direct read" verwendet.

1: Wird nur für den NGA-Manager verwendet.

2: Wird nur für "direct read" verwendet.
profile string Backend-Profil auf dem das Backend basiert.
directReadDistPartner dyn_string Enthält den Namen des verteilten Partner-Backends.
comm struct - Enthält die Unterelemente
zmqAddress string inproc://influxDB ZMQ-Verbindungsadresse des Backends.
sendDpeWithName bool true Der DPE-Namen soll mit Daten miteinbezogen werden (Gebrauch hängt von Profileinstellung ab).
sendDpeWithId bool true Die DP ID soll mit Daten miteinbezogen werden (Gebrauch hängt von Profileinstellung ab).
sendDpeWithAlias bool true Das Alias soll mit Daten miteinbezogen werden (Gebrauch hängt von Profileinstellung ab).
splitSize unsigned 1000 Maximale Nachrichtengröße (Zeilen) für Leseantworten (sollte > 10 sein).
buffering struct - Enthält die Unterelemente
bufferFilesLocation string Festplatten-Speicherstelle für Pufferdateien.
bufferFilesPrefix string Dateiname-Präfix für Pufferdateien.
bufferingLevel unsigned 2 Puffer auf Speicher und /oder Platte.
memoryBufferSize unsigned 20 Maximale Anzahl von Puffern im Speicher (>0).
blockSize int 1000 Größe der einzelnen Datenblöcke (Ereignisse / Alarme).
timeoutUntilBlockIsWrittenToDisk unsigned 1000 Wartezeit bevor ein Block auf die Platte geschrieben wird (ms).
processOldBlocksAtStartup bool true Lese existierende gepufferte Blöcke von der Platte beim Startup.
timing struct - Enthält die Unterelemente
sendTimeout int 500 Polling-Intervall in ms. für ZMQ, ein hoher Wert wird die Performanz senken (aber die Antwortzeit erhöhen, um NGA zu stoppen). Ein niedriger Wert wird mehr CPU benötigen.
maxBufferTime unsigned 1000 Wartezeit in ms. für eingehende Nachrichten bevor ein Block erstellt wird.
waitForDBWrite unsigned 10000 Maximale Wartezeit in ms. für Backendantwort einer Schreiboperation. Wenn die Operation länger dauert, wird eine Fehlermeldung im LogViewer angezeigt und dieser Wert sollte erhöht werden.
timeToWaitForFinishingAsyncOperInMilisecs unsigned 10 Zeit um eine DB-Schreiboperation abzuschließen. Wenn diese Periode abläuft, schreibt NGA den aktuellen Datenpuffer auf die Platte (wenn Diskpuffer aktiv ist).
database struct - Enthält die Unterelemente
connection string http://127.0.0.1:8086 Verbindungsstring zur Datenbank.
user string etm Benutzername für die DB-Verbindung.
password string Password für die DB-Verbindung (verschlüsselt gespeichert).
dbSpecific dyn_string DB-spezifische Konfiguration mit Komma getrennte Schlüssel/Werte-Paare.
dbProcCtrl bool false Start (true) / stop (false) Datenbank.
dbProcMgmt bool true DB wurde von Backend gestartet /gestoppt .
privateKeyFile string Der Pfad für den privaten Schlüssel für die Asymmetrische Verschlüsselung des Passwortes. Der private Schlüssel für die Asymmetrische Verschlüsselung des Passwortes soll hier gespeichert werden. Für die Asymmetrische Verschlüsselung, siehe Kapitel Asymmetrische Verschlüsselung
publicKey string Der Public-Schlüssel (public key) für die Asymmetrische Verschlüsselung des Passwortes wird hier gespeichert. Für die Asymmetrische Verschlüsselung, siehe Kapitel Asymmetrische Verschlüsselung
monitor struct - Enthält die Unterelemente
backendConnectedToDB bool Backend hat eine valide DB-Verbindung.
backendConnectedToFrontend bool Frontend hat eine valide DB-Verbindung zum Backend.
lastError int Letzte Fehlernummer, die von der Datenbank empfangen wurde (DB-spezifisch).
lastErrorMsg string Letzte Fehlermeldung, die von der Datenbank empfangen wurde (DB-spezifisch).
lastWrite time Zeitstempel der letzten Schreiboperation.
lastDpWritten dpId DP ID des zuletzt geschriebenen Datenpunktelements.
currentDiskBufferSize int Aktuelle Größe des Plattenpuffers (Anzahl der Puffer).
currentMemoryBufferSize int Aktuelle Größe der Speicherpuffer (Anzahl der Puffer).
bufferGrowthIndicator int 1: Puffer-Zählerstand wächst, -1 Puffer-Zählerstand sinkt.
blockWriteDuration int Dauer der letzten Schreiboperation in ms.
pendingBuffers struct - Enthält die Unterelemente
startTime dyn_time Der älteste Zeitstempel eines Ereignisses/Alarms im Puffer, d. h. der erste Wert.
endTime dyn_time Der neueste Zeitstempel eines Ereignisses/Alarms im Puffer, d. h. der letzte Wert.
itemCount dyn_int Die Anzahl der kombinierten Ereignisse und Alarme im Puffer. 4 Ereignisse und 2 Alarme entsprechen 6 Einträgen.
itemReduState dyn_int

Der Redundanzstatus bei der Erstellung des Puffers.

0 = Aktiv

1 = Passiv

Bedeutung: Aktive Puffer werden vom aktiven oder vom passiven System geschrieben.

Passive Puffer werden nur auf das aktive System geschrieben.

bufferLocation dyn_int

Die logische Stelle, an der sich der Puffer befindet

  • 0 = Schreiben

    Der Puffer wird gerade in die Datenbank geschrieben und wartet auf eine Bestätigung.

  • 1 = Aktuell

    Der aktuelle Puffer, in den neue Ereignisse/Alarme eingefügt werden.

  • 2 = Speicher

    Der Puffer befindet sich im Speicher und geht verloren, wenn der NGA beendet wird.

  • 3 = Festplatte

    Der Puffer befindet sich auf der Festplatte und ist noch verfügbar, wenn der NGA beendet wird.
cmdShowAllOnce bool FALSE (Max. 32 Puffer)

Sie können auf Kommando alle anstehenden Puffer anzeigen lassen, anstatt sich auf die ersten 32 zu beschränken.

Wenn dieser Datenpunkt auf FALSE gesetzt ist, werden maximal 32 Puffer angezeigt und ein Invalid-Bit wird gesetzt, um anzuzeigen, dass die Daten unvollständig sind.

Wenn der Datenpunkt zur Laufzeit auf TRUE gesetzt wird:

Im nächsten Pufferaktualisierungszyklus werden alle Puffer einmal angezeigt. Nach Ausführung des Kommandos wird die automatische Aktualisierung der ausstehenden Puffer gestoppt.

Wird der Kommando wieder auf TRUE gesetzt, erfolgt eine erneute Aktualisierung mit allen ausstehenden Puffern.

Der NGA ist auf eine Aktualisierung im Sekundentakt beschränkt, so dass zwischen dem Setzen des Kommandos auf TRUE und dem Erhalt des Ergebnisses eine gewisse Latenzzeit besteht (maximal eine Sekunde plus die tatsächliche Verarbeitungszeit des Kommandos)

HINWEIS: Dieser Kommandostatus wird beim Starten nicht gelesen. Selbst wenn der Kommando auf TRUE gesetzt wurde, verwendet ein Neustart des NGA also den eingeschränkten Aktualisierungsmodus (maximal 32 Puffer). Dies ist beabsichtigt, um zu verhindern, dass eine potenziell große Operation die Startzeit verlängert.
actual struct - Enthält die Unterelemente
activeZmqAddress string Die aktuelle ZMQ-Verbindungsadresse des Backends.
displayName langString Name des Backends im User Interface.