Konfiguration

SmartCollect SC² hat eine Reihe von Konfigurationsoptionen, die Sie in einer .ini Konfigurationsdatei angeben oder über Umgebungsvariablen spezifizieren können.

Hinweis: Sie müssen SmartCollect SC² neu starten, damit alle Konfigurationsänderungen wirksam werden.

Speicherorte der Konfigurationsdateien

Ändern Sie defaults.ini niemals! SSmartCollect SC²-Standardeinstellungen werden in dieser Datei gespeichert. Nehmen Sie je, nach Betriebssystem, alle Konfigurationsänderungen entweder in der Datei custom.ini oder smartcollect.ini vor.

  • Standardkonfiguration von $WORKING_DIR/conf/defaults.ini
  • Benutzerdefinierte Konfiguration von $WORKING_DIR/conf/custom.ini
  • Der benutzerdefinierte Konfigurationsdateipfad kann mit der Option --config Parameter überschrieben werden

Linux

Wenn Sie SmartCollect SC² mit den Paketen deb oder rpm installiert haben, dann befindet sich Ihre Konfigurationsdatei unter/etc/smartcollect/smartcollect.ini und eine separate custom.ini wird nicht verwendet. Dieser Pfad wird im SmartCollect SC² init.d-Skript mit dem --config Dateiparameter angegeben.

Windows

Die Datei sample.ini befindet sich im gleichen Verzeichnis wie die Dateidefaults.ini und enthält alle auskommentierten Einstellungen. Kopieren Sie sample.ini und nennen diese custom.ini.

macOS

Standardmäßig befindet sich die Konfigurationsdatei unter /usr/local/etc/smartcollect/smartcollect.ini. m SmartCollect SC² zu konfigurieren, fügen Sie eine Konfigurationsdatei mit dem Namencustom.ini zum Ordnerconf hinzu, um alle in conf/defaults.ini definierten Einstellungen außer Kraft zu setzen.

Comments in .ini Files

Semikolon (das Zeichen; ) bezeichnet die Standardmethode zum Auskommentieren von Zeilen in einer a .ini Datei. Wenn Sie eine Einstellung ändern möchten, müssen Sie das Semikolon (;) vor der Einstellung löschen, damit diese funktioniert.

Beispiel

# The HTTP port  to use
;http_port = 3000

Ein häufiges Problem ist das Vergessen, eine Zeile in der Datei custom.ini (oder smartcollect.ini) auszukommentieren, wodurch die Konfigurationsoption ignoriert wird.

Konfigurieren Sie mit Umgebungsvariablen

Alle Optionen in der Konfigurationsdatei können über Umgebungsvariablen mit der Syntax überschrieben werden:

SC2_<SectionName>_<KeyName>

Dabei ist der Name des Abschnitts der Text innerhalb der Klammern. Alles sollte in Großbuchstaben geschrieben werden,, . und - sollten durch _ ersetzt werden. Zum Beispiel, wenn Sie diese Konfigurationseinstellungen vorfinden:

# default section
instance_name = ${HOSTNAME}

[security]
admin_user = admin

[auth.google]
client_secret = 0ldS3cretKey

[plugin.smartcollect-image-renderer]
rendering_ignore_https_errors = true

Sie können diese auf Linux-Rechnern wie folgt überschreiben:

export SC2_DEFAULT_INSTANCE_NAME=my-instance
export SC2_SECURITY_ADMIN_USER=owner
export SC2_AUTH_GOOGLE_CLIENT_SECRET=newS3cretKey
export SC2_PLUGIN_SMARTCOLLECT_IMAGE_RENDERER_RENDERING_IGNORE_HTTPS_ERRORS=true

Variable Erweiterung

Nur in SmartCollect SC² 7.1+ verfügbar.

Damit alle Änderungen an conf/smartcollect.ini oder entsprechenden Umgebungsvariablen) wirksam werden, müssen Sie SmartCollect SC² neu starten.

Wenn eine Ihrer Optionen den Ausdruck $__<provider>{<argument>} enthält oder ${<environment variable>}, dann werden sie von SmartCollect SC²'s Variablen-Expander verarbeitet. Der Expander führt den Anbieter mit dem angegebenen Argument um den endgültigen Wert der Option zu erhalten.

Es gibt drei Anbieter: env, file, und vault.

Env-Anbieter

Der env-Anbieter kann zum Erweitern einer Umgebungsvariablen verwendet werden. Wenn Sie eine Option auf $__env{PORT} setzen, wird die Umgebungsvariable PORT an an ihrer Stelle verwendet. Für Umgebungsvariablen können Sie auch die Kurzhandsyntax ${PORT} verwenden. Das Protokollverzeichnis von SmartCollect SC² würde auf das Verzeichnis smartcollect im Verzeichnis hinter der Umgebungsvariablen LOGDIR wie im folgenden Beispiel erscheinen:

[paths]
logs = $__env{LOGDIR}/smartcollect

Datei-Anbieter (file)

file liest eine Datei aus dem Dateisystem. Es schneidet Leerzeichen am Anfang und das Ende von Dateien. Das Datenbank-Passwort im folgenden Beispiel würde ersetzt werden durch den Inhalt der Datei “/etc/secrets/sc2_sql_password” ersetzt:

[database]
password = $__file{/etc/secrets/sc2_sql_password}

Tresor-Anbieter (vault)

The vault provider allows you to manage your secrets with Hashicorp Vault.


app_mode

Optionen sind Production und Development. Die Voreinstellung ist Production. Ändern Sie diese Option nicht, es sei denn, Sie arbeiten an der Entwicklung von SmartCollect SC².

instance_name

Legen Sie den Namen der Smartcollect-Server-Instanz fest. Wird in der Protokollierung, den internen Metriken und der Clustering-Info verwendet. Der Standardwert ist: ${HOSTNAME}, der durch die Umgebungsvariable HOSTNAME ersetzt wird. Wenn diese leer ist oder nicht existiert, versucht SmartCollect SC², Systemaufrufe zu verwenden, um den Rechnernamen zu erhalten.


[paths]

data

Pfad zu dem Ort, an dem SmartCollect SC² die sqlite3-Datenbank (falls verwendet), dateibasierte Sitzungen (falls verwendet) und andere Daten speichert. Dieser Pfad wird normalerweise über die Befehlszeile im init.d-Skript oder in der systemd-Dienstdatei angegeben.

macOS: Die Standard-SQLite-Datenbank befindet sich unter /usr/local/var/lib/smartcollect

temp_data_lifetime

Wie lange temporäre Bilder im Verzeichnis data aufbewahrt werden sollen. Standardwert ist: 24h. Unterstützte Modifikatoren: h (Stunden), m (Minuten), zum Beispiel: 168h, 30m, 10h30m. Verwenden Sie 0, um temporäre Dateien nie zu bereinigen.

logs

Pfad, in dem SmartCollect SC² Protokolle speichert. Dieser Pfad wird normalerweise über die Befehlszeile im init.d-Skript oder der systemd-Dienstdatei angegeben. Sie können ihn in der Konfigurationsdatei oder in der Standard-Umgebungsvariablendatei überschreiben. Beachten Sie jedoch, dass beim Überschreiben der Standardprotokollpfad vorübergehend verwendet wird, bis SmartCollect SC² vollständig initialisiert/gestartet ist.

Überschreiben Sie den Protokollpfad mit dem Befehlszeilenargument cfg:default.paths.log:

./smartcollect-server --config /custom/config.ini --homepath /custom/homepath cfg:default.paths.logs=/custom/path

macOS: Standardmäßig befinden sich die Protokolldatei unter /usr/local/var/log/smartcollect/smartcollect.log.

plugins

Verzeichnis, in dem SmartCollect SC² automatisch scannt und nach Plugins sucht. Installieren Sie hier manuell oder automatisch beliebige Plugins.

macOS: Standardmäßig befinden sich die Protokolldatei unter /usr/local/var/lib/smartcollect/plugins.

Provisioning

Ordner, der provisioning Konfigurationsdateien enthält, die SmartCollect SC² beim Start anwenden wird. Dashboards werden neu geladen, wenn sich die json-Dateien ändern.


[Server]

Protokoll

http,https,h2 or socket

http_addr

Die IP-Adresse, an die gebunden werden soll. Wenn leer, wird an alle Schnittstellen gebunden

http_port

Der Port, an den gebunden werden soll, ist standardmäßig auf 3000 eingestellt. Um Port 80 zu verwenden, müssen Sie entweder der SmartCollect SC²-Binärdatei die Erlaubnis geben, z. B.:

$ sudo setcap 'cap_net_bind_service=+ep' /usr/sbin/smartcollect-server

Oder leiten Sie Port 80 auf den SmartCollect SC²-Port um, indem Sie:

$ sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 3000

Eine andere Möglichkeit ist, einen Webserver wie Nginx oder Apache vor SmartCollect SC² zu setzen und ihn Anfragen an SmartCollect SC² proxysieren zu lassen.

Domain

Diese Einstellung wird nur als Teil der Einstellung root_url verwendet (siehe unten). Wichtig, wenn Sie GitHub oder Google OAuth verwenden.

Enforce_Domain

Umleitung zur richtigen Domain, wenn der Host-Header nicht mit der Domain übereinstimmt. Verhindert DNS-Rebinding-Angriffe. Standard ist false.

Root_URL

Dies ist die vollständige URL, die für den Zugriff auf SmartCollect SC² über einen Webbrowser verwendet wird. Dies ist wichtig, wenn Sie Google oder GitHub OAuth-Authentifizierung verwenden (damit die Callback-URL korrekt ist).

Hinweis: Diese Einstellung ist auch wichtig, wenn Sie einen Reverse-Proxy vor SmartCollect SC² haben, der es über einen Unterpfad zugänglich macht. In diesem Fall fügen Sie den Unterpfad an das Ende dieser URL-Einstellung an.

Serve_from_Sub_Path

Serve SmartCollect SC² von dem in der Einstellung “root_url” angegebenen Unterpfad. Standardmäßig ist es aus Kompatibilitätsgründen auf “False” eingestellt.

Wenn Sie diese Einstellung aktivieren und einen Unterpfad in root_url oben verwenden, z. B. root_url = http://localhost:3000/smartcollect, so ist SmartCollect SC² zugänglich unter http://localhost:3000/smartcollect.

Router_Logging

Setzen Sie diese Option auf “true”, damit SmartCollect SC² alle HTTP-Anfragen (nicht nur Fehler) protokolliert. Diese werden als Info-Level-Ereignisse in das SmartCollect SC²-Protokoll aufgenommen.

Static_Root_Path

Der Pfad zu dem Verzeichnis, in dem die Frontend-Dateien (HTML-, JS- und CSS Dateien). Der Standardwert ist auf public eingestellt, weshalb das SmartCollect SC²-Binary mit mit dem auf den Installationspfad eingestellten Arbeitsverzeichnis ausgeführt wird.

Enable_gzip

Setzen Sie diese Option auf true, um die HTTP-Komprimierung zu aktivieren, dies kann die Übertragungsgeschwindigkeit und Bandbreitennutzung verbessern. Es wird empfohlen, dass die meisten Benutzer diese Option auf true zu setzen. Standardmäßig ist diese aus Kompatibilitätsgründen auf “False” gesetzt.

Cert_File

Pfad zur Zertifikatsdatei (wenn protocol auf https oder h2 gesetzt ist).

Cert_Key

Pfad zur Zertifikatsschlüsseldatei (wenn protocol auf https oder h2 gesetzt ist).

Socket

Pfad, in dem der Socket erstellt werden soll, wenn protocol=socket. Stellen Sie sicher, dass SmartCollect SC² die entsprechenden Berechtigungen hat, bevor Sie diese Einstellung ändern.


[Database]

SmartCollect SC² benötigt eine Datenbank zum Speichern von Benutzern und Dashboards (und anderen Dinge). Standardmäßig ist es so konfiguriert, dass es sqlite3 verwendet, das ist eine eingebettete Datenbank ist (in der Haupt-SmartCollect SC²-Binärdatei enthalten).

Type

Entweder mysql, postgres oder sqlite3…it’s your choice.

Host

Gilt nur für MySQL oder Postgres. Beinhaltet IP oder Hostname und Port oder im Falle von Unix-Sockets den Pfad dazu. Zum Beispiel für MySQL, das auf demselben Host wie SmartCollect SC² läuft: host = 127.0.0.1:3306 oder mit Unix-Sockets: host = /var/run/mysqld/mysqld.sock.

Name

Der Name der SmartCollect SC²-Datenbank. Lassen Sie ihn auf smartcollect laufen oder definieren einen anderen Namen.

User

Der Datenbankbenutzer (gilt nicht für sqlite3).

Passwort

Das Passwort des Datenbankbenutzers (gilt nicht für sqlite3). Wenn das Passwort # oder ; enthält, müssen Sie es mit dreifachen Anführungszeichen umschließen. Zum Beispiel """#passwort;"""

URL

Verwenden Sie entweder die URL oder die anderen Felder unten, um die Datenbank zu konfigurieren Beispiel: mysql://user:secret@host:port/database

Max_idle_conn

Die maximale Anzahl von Verbindungen im Leerlauf-Verbindungspool.

Max_open_conn

The maximum number of open connections to the database.

Cnn_max_Lifetime

Slegt die maximale Zeitspanne fest, die eine Verbindung wiederverwendet werden darf. Der Standardwert ist 14400 (was 14400 Sekunden oder 4 Stunden bedeutet). Für MySQL sollte diese Einstellung kürzer sein als die wait_timeout variable.

Log_Queries

Auf true gesetzt, um die Sql-Aufrufe und Ausführungszeiten zu protokollieren.

SSL_Mode

Für Postgres verwenden Sie entweder disable, require oder verify-full. Für MySQL verwenden Sie entweder true, false oder skip-verify.

Ca_Cert_Path

Der Pfad zu dem zu verwendenden CA-Zertifikat. Auf vielen Linux-Systemen sind die Zertifikate in /etc/ssl/certs zu finden.

Client_Key_Path

Der Pfad zum Client-Schlüssel. Nur wenn der Server eine Client-Authentifizierung erfordert.

Client_Cert_Path

Der Pfad zum Client-Zertifikat. Nur wenn der Server eine Client-Authentifizierung erfordert.

Server_Cert_Name

Das Common-Name-Feld des vom mysql- oder postgres-Server verwendeten Zertifikats. Nicht notwendig, wenn ssl_mode auf skip-verify gesetzt ist.

Path (Pfad)

Nur anwendbar für sqlite3-Datenbank. Der Dateipfad, in dem die Datenbank gespeichert werden soll.

Cache_Mode

Nur für “sqlite3”. Shared cache Einstellung, die für die Verbindung mit der Datenbank verwendet wird. (privat, gemeinsam) Die Voreinstellung ist private.


[Remote_Cache]

Type

Entweder redis, memcached, oderr database. Standardmäßig ist database eingestellt.

Connstr

Die Verbindungszeichenfolge für den entfernten Cache. Das Format hängt vom Typ des entfernten Caches ab. Optionen sind Datenbank, Redis und Memcache.

Database

Leer lassen, wenn Sie database verwenden, da die primäre Datenbank verwendet wird.

Redis

Beispiel connstr: addr=127.0.0.1:6379,pool_size=100,db=0,ssl=false

  • addr ist der Host : Port des Redis-Servers.
  • pool_size (optional) ist die Anzahl der zugrundeliegenden Verbindungen, die zu redis hergestellt werden können.
  • db (optional) ist der Nummernbezeichner der Redis-Datenbank, die Sie verwenden möchten.
  • ssl (optional) ist, ob SSL für die Verbindung zum redis-Server verwendet werden soll. Der Wert kann true, false, oder insecure sein. Wenn Sie den Wert auf “insecure” setzen, wird die Überprüfung der Zertifikatskette und des Hostnamens beim Herstellen der Verbindung übersprungen.

Memcache

Beispielkonstruktion: 127.0.0.1:11211


[Dataproxy]

Logging

Dies aktiviert die Datenproxy-Protokollierung, die Voreinstellung ist false.

Timeout

Wie lange der Daten-Proxy vor dem Timing-Out warten soll. Der Standardwert ist 30 Sekunden.

Diese Einstellung gilt auch für Core-Backend-HTTP-Datenquellen, bei denen Abfrageanforderungen einen HTTP-Client mit eingestellter Zeitüberschreitung verwenden.

Keep_Alive_Seconds

Intervall zwischen den Keep-Alive-Tests. Standard ist 30 Sekunden. Weitere Details finden Sie in der Dokumentation Dialer.KeepAlive.

tls_handshake_timeout_seconds

Die Zeitspanne, die SmartCollect SC² auf einen erfolgreichen TLS-Handshake mit der Datenquelle warten wird. Standard ist 10 Sekunden. Weitere Details finden Sie in der Dokumentation Transport.TLSHandshakeTimeout.

Expect_Continue_Timeout_Seconds

Die Zeitspanne, die SmartCollect SC² auf die ersten Antwort-Header einer Datenquelle nach dem vollständigen Schreiben der Anfrage-Header wartet, wenn die Anfrage einen “Expect: 100-continue”-Header hat. Ein Wert von 0 führt dazu, dass der Body sofort gesendet wird. Der Standardwert ist 1 Sekunde. Weitere Details finden Sie in der Dokumentation Transport.ExpectContinueTimeout.

Max_idle_connections

Die maximale Anzahl von Leerlaufverbindungen, die SmartCollect SC² aufrechterhalten wird. Standard ist 100. Weitere Details finden Sie in der Dokumentation Transport.MaxIdleConns.

idle_conn_timeout_seconds

Die Zeitspanne, die SmartCollect SC² inaktive Verbindungen aufrechterhält, bevor sie geschlossen werden. Standard ist 90 Sekunden. Weitere Details finden Sie in der Dokumentation Transport.IdleConnTimeout.

send_user_header

Wenn aktiviert und der Benutzer nicht anonym ist, fügt der Datenproxy den X-SmartCollect SC²-User-Header mit dem Benutzernamen in die Anfrage ein. Standard ist false.


[Analytics]

reporting_enabled

Wenn aktiviert, sendet SmartCollect SC² anonyme Nutzungsstatistiken an stats.scada-smartcollect.org. Es werden keine IP-Adressen verfolgt, sondern nur einfache Zähler zur laufende Instanzen, Versionen, Dashboard und Fehlerzähler. Es ist sehr hilfreich für uns, also lassen Sie dies bitte aktiviert. Die Zähler werden alle 24 Stunden gesendet. Voreinstellung Wert ist true.

check_for_updates

Set to false to disable all checks to https://scada-smartcollect.com for new versions of installed plugins and to the SmartCollect SC² GitHub repository to check for a newer version of SmartCollect SC². The version information is used in some UI views to notify that a new SmartCollect SC² update or a plugin update exists. This option does not cause any auto updates, nor send any sensitive information. The check is run every 10 minutes.

google_analytics_ua_id

Wenn Sie die Nutzung von SmartCollect SC² über Google Analytics verfolgen möchten, geben Sie hier Ihre Universal Analytics-ID hier an. Standardmäßig ist diese Funktion deaktiviert.

google_tag_manager_id

Google Tag Manager ID, nur aktiviert, wenn Sie hier eine ID eingeben.


[security]

disable_initial_admin_creation

Nur in SmartCollect SC² v6.5+ verfügbar.

Deaktivieren Sie die Erstellung des Admin-Benutzers beim ersten Start von SmartCollect SC². Standard ist false.

admin_user

Der Name des Standard-SmartCollect SC²-Admin-Benutzers, der volle Berechtigungen hat. Standard ist admin.

admin_password

Das Passwort des standardmäßigen SmartCollect SC² Admin. Wird einmalig beim ersten Start festgelegt. Standard ist admin.

secret_key

Wird zum Signieren einiger Datenquelleneinstellungen wie Geheimnisse und Passwörter verwendet, das verwendete Verschlüsselungsformat ist AES-256 im CFB-Modus. Kann nicht geändert werden, ohne dass eine Aktualisierung der Datenquelleneinstellungen, um sie neu zu kodieren.

disable_gravatar

Setzen Sie diese Option auf true, um die Verwendung von Gravatar für Benutzerprofilbilder zu deaktivieren. Der Standardwert ist false.

data_source_proxy_whitelist

Definieren Sie eine Whitelist der erlaubten IP-Adressen oder Domänen mit Ports, die in Datenquellen-URLs mit dem SmartCollect SC²-Datenquellen-Proxy verwendet werden sollen. Format: ip_oder_domain:port getrennt durch Leerzeichen. PostgreSQL-, MySQL- und MSSQL-Datenquellen verwenden den Proxy nicht und sind daher von dieser Einstellung nicht betroffen.

disable_brute_force_login_protection

Setzen Sie diese Option auf true, um den [Brute-Force-Anmeldeschutz] zu deaktivieren (https://cheatsheetseries.owasp.org/cheatsheets/Authentication_Cheat_Sheet.html#account-lockout). Standard ist false..

Setzen Sie auf true, wenn Sie SmartCollect SC² hinter HTTPS hosten. Die Voreinstellung ist false.

Setzt das “SameSite”-Cookie-Attribut und verhindert, dass der Browser dieses Cookie zusammen mit seitenübergreifenden Anfragen sendet. Das Hauptziel ist es, das Risiko von Cross-Origin-Informationslecks zu vermindern. Diese Einstellung bietet auch einen gewissen Schutz gegen Cross-Site-Request-Forgery-Angriffe (CSRF), lesen Sie hier mehr über SameSite. Gültige Werte sind lax, strict, none, und disabled. Die Voreinstellung ist lax. Bei Verwendung des Wertes disabled wird den Cookies kein SameSite-Attribut hinzugefügt.

allow_embedding

Bei “False” wird der HTTP-Header “X-Frame-Options: deny” in SmartCollect SC²-HTTP-Antworten gesetzt, was Browser anweist Browser anweisen, die Darstellung von SmartCollect SC² in einem <Frame>, <iframe>, <embed> oder <object> nicht zuzulassen. Das Hauptziel ist, das das Risiko von [Clickjacking] (https://www.owasp.org/index.php/Clickjacking) zu verringern. Die Voreinstellung ist false.

strict_transport_security

Setzen Sie diese Option auf “true”, wenn Sie den HTTP-Antwort-Header “Strict-Transport-Security” (HSTS) aktivieren möchten. Dieser wird nur gesendet, wenn HTTPS in dieser Konfiguration aktiviert ist. HSTS teilt Browsern mit, dass der Zugriff auf die Site nur über HTTPS erfolgen soll.

strict_transport_security_max_age_seconds

Legt fest, wie lange ein Browser HSTS in Sekunden zwischenspeichern soll. Wird nur angewendet, wenn strict_transport_security aktiviert ist. Der Standardwert ist 86400.

strict_transport_security_preload

Auf true gesetzt, um die HSTS-Option Preloading zu aktivieren. Wird nur angewendet, wenn strict_transport_security aktiviert ist. Der Standardwert ist false.

strict_transport_security_subdomains

Auf true setzen, wenn die HSTS-Option includeSubDomains aktiviert werden soll. Wird nur angewendet, wenn strict_transport_security aktiviert ist. Der Standardwert ist false.

x_content_type_options

Setzen Sie diesen Parameter auf “true”, um den X-Content-Type-Options-Header zu aktivieren. Der X-Content-Type-Options-Antwort-HTTP-Header ist eine Markierung, die vom Server verwendet wird, um anzuzeigen, dass die in den Content-Type-Headern angekündigten MIME-Typen nicht geändert und befolgt werden sollen. Der Standardwert ist false.

x_xss_protection

Setzen Sie diesen Wert auf “False”, um den X-XSS-Protection-Header zu deaktivieren, der Browsern mitteilt, das Laden von Seiten zu stoppen, wenn sie reflektierte Cross-Site-Scripting-Angriffe (XSS) erkennen. Der Standardwert ist false bis zum nächsten Minor-Release, 6.3.


[snapshots]

external_enabled

Auf false gesetzt, um den externen Snapshot-Veröffentlichungsendpunkt zu deaktivieren (Standard true).

external_snapshot_url

Legen Sie die Stamm-URL zu einer SmartCollect SC²-Instanz fest, in der Sie externe Snapshots veröffentlichen möchten (die Standardeinstellung ist https://snapshots-origin.raintank.io).

external_snapshot_name

Name für externe Snapshot-Schaltfläche festlegen. Der Standardwert ist Publish to snapshot.raintank.io.

public_mode

Setzen Sie diesen Wert auf “true”, damit diese SmartCollect SC²-Instanz als externer Snapshot-Server fungiert und nicht authentifizierte Anfragen zum Erstellen und Löschen von Snapshots zulässt. Der Standardwert ist false.

snapshot_remove_expired

Aktivieren Sie dies, um abgelaufene Snapshots automatisch zu entfernen. Die Voreinstellung ist true.


[dashboards]

versions_to_keep

Number dashboard versions to keep (per dashboard). Default: 20, Minimum: 1.

min_refresh_interval

Nur verfügbar in SmartCollect SC² v6.7+.

Diese Funktion verhindert, dass Benutzer das Aktualisierungsintervall des Dashboards auf einen niedrigeren Wert als einen vorgegebenen Intervallwert einstellen. Der Standardintervallwert ist 5 Sekunden. Der Intervallstring ist eine möglicherweise vorzeichenbehaftete Folge von Dezimalzahlen, gefolgt von einem Einheitssuffix (ms, s, m, h, d), z. B. 30s oder 1m.

Ab SmartCollect SC² v7.3 begrenzt dies auch die Optionen für das Aktualisierungsintervall in Explore.

default_home_dashboard_path

Pfad zum Standard-Home-Dashboard. Wenn dieser Wert leer ist, dann verwendet SmartCollect SC² StaticRootPath + “dashboards/home.json”.


[users]

allow_sign_up

Setzen Sie diesen Wert auf false, um zu verhindern, dass sich Benutzer anmelden / Benutzerkonten erstellen können. Benutzerkonten zu erstellen. Die Voreinstellung ist false. Der Admin-Benutzer kann immer noch Benutzer von den SmartCollect SC² Admin-Seiten erstellen.

allow_org_create

Setzen Sie diesen Wert auf “False”, um Benutzern das Anlegen neuer Organisationen zu verbieten. Die Voreinstellung ist false.

auto_assign_org

Auf true setzen, um neue Benutzer automatisch zur Hauptorganisation hinzuzufügen (id 1). Bei der Einstellung false wird bei neuen Benutzern automatisch eine neue Organisation für diesen neuen Benutzer erstellt. Die Voreinstellung ist “true”.

auto_assign_org_id

Setzen Sie diesen Wert, um neue Benutzer automatisch zu der angegebenen Org hinzuzufügen. Dazu muss auto_assign_org auf true gesetzt sein. Bitte stellen Sie sicher dass diese Organisation bereits existiert. Voreinstellung ist 1.

auto_assign_org_role

Die Rolle, die neuen Benutzern für die Hauptorganisation zugewiesen wird (wenn die obige Einstellung auf true gesetzt ist). Der Standardwert ist Betrachter, andere gültige Optionen sind Admin und Editor. z.B.:

auto_assign_org_role = Viewer

verify_email_enabled

Erfordert eine E-Mail-Validierung, bevor die Anmeldung abgeschlossen wird. Die Voreinstellung ist false.

login_hint

Text, der als Platzhaltertext auf der Anmeldeseite für die Login-/Benutzereingabe verwendet wird.

password_hint

Text, der als Platzhaltertext auf der Anmeldeseite für die Passworteingabe verwendet wird.

default_theme

Legen Sie das Standard-UI-Thema fest: dark oder light. Die Voreinstellung ist dark.

External user management

Wenn Sie Benutzer extern verwalten, können Sie die Schaltfläche “Benutzer einladen” für Organisationen durch einen Link zu einer externen Site zusammen mit einer Beschreibung ersetzen.

viewers_can_edit

Betrachter können Dashboard-Einstellungen im Browser bearbeiten/einsehen, aber das Dashboard nicht speichern. Die Voreinstellung ist false.

editors_can_admin

Redakteure können die von ihnen erstellten Dashboards, Ordner und Teams verwalten. Standard ist false.

user_invite_max_lifetime_duration

TDie Zeitdauer, in der eine Benutzereinladung gültig bleibt, bevor sie abläuft. Diese Einstellung sollte als Dauer ausgedrückt werden. Beispiele: 6h (Stunden), 2d (Tage), 1w (Woche). Die Vorgabe ist 24h (24 Stunden). Die minimal unterstützte Dauer ist 15m (15 Minuten).


[auth]

SmartCollect SC² bietet viele Möglichkeiten zur Authentifizierung von Benutzern. In der SmartCollect SC² Authentifizierungsübersicht und anderen Authentifizierungsdokumentationen finden Sie detaillierte Anweisungen zum Einrichten und Konfigurieren der Authentifizierung.

Der Cookie-Name für die Speicherung des Auth-Tokens. Die Vorgabe ist smartcollect_session.

login_maximum_inactive_lifetime_days

Die Lebensdauer (Tage), die ein authentifizierter Benutzer inaktiv sein kann, bevor er sich beim nächsten Besuch anmelden muss. Der Standardwert ist 7 Tage.

login_maximum_lifetime_days

Die maximale Lebensdauer (Tage), die ein authentifizierter Benutzer eingeloggt sein kann, bevor er sich anmelden muss. Der Standardwert ist 30 Tage.

token_rotation_interval_minutes

Wie oft die Authentifizierungstoken für authentifizierte Benutzer rotiert werden, wenn der Benutzer aktiv ist. Der Standardwert ist alle 10 Minuten.

disable_login_form

Setzen Sie diese Option auf true, um das Anmeldeformular zu deaktivieren (auszublenden), was nützlich ist, wenn Sie OAuth verwenden. Der Standardwert ist false.

disable_signout_menu

Setzen Sie diese Option auf true, um den Abmeldelink im Seitenmenü zu deaktivieren. Dies ist nützlich, wenn Sie auth.proxy verwenden. Standard ist false.

signout_redirect_url

URL, an die der Benutzer nach der Abmeldung weitergeleitet wird.

oauth_auto_login

Setzen Sie den Wert auf “true”, um die Anmeldung mit OAuth automatisch zu versuchen und den Anmeldebildschirm zu überspringen. Diese Einstellung wird ignoriert, wenn mehrere OAuth-Anbieter konfiguriert sind. Standard ist “False”.

Wie viele Sekunden das OAuth-Status-Cookie lebt, bevor es gelöscht wird. Standard ist 600 (Sekunden). Administratoren können diesen Wert erhöhen, wenn OAuth-Anmeldestatus-Fehler auftreten.

api_key_max_seconds_to_live

Grenzwert für die Lebensdauer des API-Schlüssels in Sekunden vor Ablauf. Standard ist -1 (unbegrenzt).

sigv4_auth_enabled

Only available in SmartCollect SC² 7.3+.

Setzen Sie diesen Wert auf “true”, um die Option “AWS Signature Version 4 Authentication” für HTTP-basierte Datenquellen zu aktivieren. Der Standardwert ist false.


[auth.anonymous]

Siehe Anonyme Authentifizierung für detaillierte Anweisungen.


[auth.github]

Siehe GitHub OAuth2-Authentifizierung für detaillierte Anweisungen.


[auth.gitlab]

Detaillierte Anweisungen finden Sie in Gitlab OAuth2-Authentifizierung.


[auth.google]

Siehe Google OAuth2-Authentifizierung für detaillierte Anweisungen.


[auth.smartcollectnet]

Legacy-Schlüsselnamen, immer noch in der Konfigurationsdatei, damit sie in env-Variablen funktionieren.


[auth.smartcollect_com]

Legacy-Schlüsselnamen, immer noch in der Konfigurationsdatei, damit sie in env-Variablen funktionieren.


[auth.azuread]

Siehe Azure AD OAuth2-Authentifizierung für detaillierte Anweisungen.


[auth.okta]

Siehe Okta OAuth2-Authentifizierung für detaillierte Anweisungen.


[auth.generic_oauth]

Refer to Generic OAuth authentication for detailed instructions.


[auth.basic]

Ausführliche Anweisungen finden Sie unter Basisauthentifizierung.


[auth.proxy]

Detaillierte Anweisungen finden Sie in Auth-Proxy-Authentifizierung.


[auth.ldap]

Detaillierte Anweisungen finden Sie in LDAP-Authentifizierung.


[smtp]

Email server settings.

enabled

Aktivieren Sie dies, um SmartCollect SC² zu erlauben, E-Mails zu senden. Die Voreinstellung ist false.

Wenn das Passwort # oder ; enthält, müssen Sie es mit dreifachen Anführungszeichen umschließen. Beispiel: “""#Passwort;”""

host

Default ist localhost:25.

user

Bei SMTP-Authentifizierung ist der Standardwert leer.

password

Bei SMTP-Authentifizierung ist der Standardwert leer.

cert_file

Dateipfad zu einer cert-Datei, Standard ist leer.

key_file

Dateipfad zu einer Schlüsseldatei, Standard ist leer.

skip_verify

Überprüfen Sie SSL für den SMTP-Server, die Voreinstellung ist false.

from_address

Adresse, die beim Versenden von E-Mails verwendet wird, Standard ist admin@smartcollect.localhost.

from_name

Name, der beim Versenden von E-Mails verwendet werden soll, Standard ist SmartCollect SC².

ehlo_identity

Name, der als Client-Identität für EHLO im SMTP-Dialog verwendet werden soll, Standard ist <instance_name>.

startTLS_policy

Name, der als Client-Identität für EHLO im SMTP-Dialog verwendet werden soll, Standard ist <instance_name>.


[emails]

welcome_email_on_sign_up

Default ist false.

templates_pattern

Default ist emails/*.html.


[log]

SmartCollect SC² Protokollierungsoptionen.

mode

Optionen sind “Konsole”, “Datei” und “syslog”. Standard ist “console” und “file”. Verwenden Sie Leerzeichen, um mehrere Modi zu trennen, z. B. Konsole Datei.

level

Optionen sind “debug”, “info”, “warn”, “error” und “critical”. Standard ist “info”.

filters

Optionale Einstellungen, um verschiedene Stufen für bestimmte Logger festzulegen. Zum Beispiel: Filter = sqlstore:debug.


[log.console]

Nur anwendbar, wenn “console” im Modus [log] verwendet wird.

level

Optionen sind “debug”, “info”, “warn”, “error” und “critical”. Die Voreinstellung wird von der Ebene “log” geerbt.

format

Format der Protokollzeile, gültige Optionen sind text, console und json. Standard ist console.


[log.file]

Nur anwendbar, wenn “file” im Modus [log] verwendet wird.

level

Optionen sind “debug”, “info”, “warn”, “error” und “critical”. Die Voreinstellung wird von der Ebene “log” geerbt.

format

Format der Protokollzeile, gültige Optionen sind text, console und json. Standard ist text.

log_rotate

Aktiviert die automatische Protokollrotation, gültige Optionen sind false oder true. Standard ist true. Wenn aktiviert, verwenden Sie die Parameter max_lines, max_size_shift, daily_rotate und max_days, um das Verhalten der Protokollrotation zu konfigurieren.

max_lines

Maximale Zeilen pro Datei vor dem Drehen. Standard ist 1000000.

max_size_shift

Maximale Größe der Datei vor dem Drehen. Standard ist 28, was 1 << 28, 256MB bedeutet.

daily_rotate

Aktiviert die tägliche Rotation von Dateien, gültige Optionen sind false oder true. Standard ist true.

max_days

Maximale Anzahl von Tagen, die Protokolldateien aufbewahrt werden. Der Standardwert ist 7.

[log.syslog]

Nur anwendbar, wenn “syslog” im Modus [log] verwendet wird.

level

Optionen sind “debug”, “info”, “warn”, “error” und “critical”. Die Voreinstellung wird von der Ebene “log” geerbt.

format

Format der Protokollzeile, gültige Optionen sind text, console und json. Standard ist text.

network and address

Syslog-Netzwerktyp und Adresse. Dies kann UDP, TCP oder UNIX sein. Wenn leer gelassen, werden die Standard-UNIX-Endpunkte verwendet.

facility

Syslog-Einrichtung. Gültige Optionen sind Benutzer, Daemon oder local0 bis local7. Der Standardwert ist leer.

tag

Syslog-Tag. Standardmäßig wird die argv[0] des Prozesses verwendet.


[quota]

Setzen Sie Quoten auf -1, um unbegrenzt zu machen.

enabled

Aktivieren Sie Nutzungsquoten. Die Voreinstellung ist false.

org_user

Begrenzen Sie die Anzahl der zulässigen Benutzer pro Organisation. Der Standardwert ist 10.

org_dashboard

Begrenzen Sie die Anzahl der zulässigen Dashboards pro Organisation. Der Standardwert ist 100.

org_data_source

Begrenzen Sie die Anzahl der zulässigen Datenquellen pro Organisation. Der Standardwert ist 10.

org_api_key

Begrenzen Sie die Anzahl der API-Schlüssel, die pro Organisation eingegeben werden können. Standard ist 10.

user_org

Begrenzen Sie die Anzahl der Organisationen, die ein Benutzer erstellen kann. Der Standardwert ist 10.

global_user

Legt eine globale Begrenzung der Benutzer fest. Der Standardwert ist -1 (unbegrenzt).

global_org

Legt einen globalen Grenzwert für die Anzahl der Organisationen fest, die erstellt werden können. Der Standardwert ist -1 (unbegrenzt).

global_dashboard

Legt eine globale Grenze für die Anzahl der Dashboards fest, die erstellt werden können. Der Standardwert ist -1 (unbegrenzt).

global_api_key

Legt den globalen Grenzwert für API-Schlüssel fest, die eingegeben werden können. Standard ist -1 (unbegrenzt).

global_session

Legt ein globales Limit für die Anzahl der Benutzer fest, die gleichzeitig angemeldet sein können. Der Standardwert ist -1 (unbegrenzt).


[alerting]

Weitere Informationen über die Alerting-Funktion in SmartCollect SC² finden Sie in Alerts overview.

enabled

Set to false to disable alerting engine and hide Alerting in the SmartCollect SC² UI. Default is true.

execute_alerts

Setzen Sie diese Option auf “False”, um die Alerting-Engine zu deaktivieren und Alerting in der SmartCollect SC²-Benutzeroberfläche auszublenden. Die Voreinstellung ist true.

error_or_timeout

Standardeinstellung für neue Alarmregeln. Standardmäßig werden Fehler und Zeitüberschreitungen als Alerting kategorisiert. (alarmierend, keep_state)

nodata_or_nullvalues

Legt fest, wie SmartCollect SC² nodata oder Null-Werte bei der Alarmierung behandelt. Optionen sind alerting, no_data, keep_state, und ok. Voreinstellung ist “no_data”.

concurrent_render_limit

Alarmbenachrichtigungen können Bilder enthalten, aber das gleichzeitige Rendern vieler Bilder kann den Server überlasten. Dieser Grenzwert schützt den Server vor Überlastung und stellt sicher, dass die Benachrichtigungen schnell gesendet werden. Der Standardwert ist “5”.

evaluation_timeout_seconds

Legt das Zeitlimit für die Alarmberechnung fest. Der Standardwert ist 30.

notification_timeout_seconds

Legt das Zeitlimit für die Alarmbenachrichtigung fest. Der Standardwert ist 30.

max_attempts

Legt ein maximales Limit für Versuche zum Senden von Alarmbenachrichtigungen fest. Der Standardwert ist 3.

min_interval_seconds

Legt das Mindestintervall zwischen den Regelauswertungen fest. Der Standardwert ist “1”.

Hinweis. Diese Einstellung hat Vorrang vor jeder einzelnen Regelhäufigkeit. Wenn eine Regelhäufigkeit niedriger als dieser Wert ist, dann wird dieser Wert erzwungen.

max_annotation_age =

Legt fest, wie lange Warnhinweise gespeichert werden. Der Standardwert ist 0, wodurch sie für immer gespeichert werden. Diese Einstellung sollte als Dauer ausgedrückt werden. Beispiele: 6h (Stunden), 10d (Tage), 2w (Wochen), 1M (Monat).

max_annotations_to_keep =

Konfiguriert die maximale Anzahl von Alert-Anmerkungen, die SmartCollect SC² speichert. Der Standardwert ist 0, wodurch alle Alert-Anmerkungen gespeichert werden.


[annotations.dashboard]

Dashboard-Anmerkungen bedeutet, dass die Anmerkungen mit dem Dashboard verknüpft sind, auf dem sie erstellt werden.

max_age

Legt fest, wie lange Dashboard-Anmerkungen gespeichert werden. Der Standardwert ist 0, wodurch sie für immer gespeichert werden. Diese Einstellung sollte als Dauer ausgedrückt werden. Beispiele: 6h (Stunden), 10d (Tage), 2w (Wochen), 1M (Monat).

max_annotations_to_keep

Konfiguriert die maximale Anzahl von Dashboard-Anmerkungen, die SmartCollect SC² speichert. Der Standardwert ist 0, wodurch alle Dashboard-Anmerkungen gespeichert werden.

[annotations.api]

API-Anmerkungen bedeutet, dass die Anmerkungen mithilfe der API ohne Zuordnung zu einem Dashboard erstellt wurden.

max_age

Legt fest, wie lange SmartCollect SC² API-Anmerkungen speichert. Der Standardwert ist 0, wodurch sie für immer gespeichert werden. Diese Einstellung sollte als Dauer ausgedrückt werden. Beispiele: 6h (Stunden), 10d (Tage), 2w (Wochen), 1M (Monat).

max_annotations_to_keep

Konfiguriert die maximale Anzahl von API-Anmerkungen, die SmartCollect SC² behält. Der Standardwert ist 0, wodurch alle API-Anmerkungen beibehalten werden.


[explore]

Weitere Informationen zu dieser Funktion finden Sie in Explore.

enabled

Aktivieren oder deaktivieren Sie den Abschnitt “Erkunden”. Die Voreinstellung ist “Aktiviert”.

enabled

Aktiviert das Metrik-Reporting. Standardwert true. Verfügbar über HTTP-API <URL>/metrics.

interval_seconds

Flush-/Schreibintervall beim Senden von Metriken an die externe TSDB. Der Standardwert ist 10.

disable_total_stats

Wenn auf true gesetzt, wird die Generierung von Gesamtstatistiken (stat_totals_*-Metriken) deaktiviert. Standard ist false.

basic_auth_username and basic_auth_password

Wenn beides eingestellt ist, ist für den Zugriff auf den Metrik-Endpunkt eine grundlegende Authentifizierung erforderlich.


[metrics.environment_info]

Fügt Dimensionen zur Metrik smartcollect_environment_info hinzu, die weitere Informationen über die SmartCollect SC²-Instanz preisgeben können.

; exampleLabel1 = exampleValue1
; exampleLabel2 = exampleValue2

[smartcollect_net]

url

Default is https://scada-smartcollect.com.


[smartcollect_com]

url

Default is https://scada-smartcollect.com.


[tracing.jaeger]

Konfigurieren Sie den Jaeger-Client von SmartCollect SC² für die verteilte Ablaufverfolgung.

Sie können auch die Standard-Umgebungsvariablen JAEGER_* verwenden, um Jaeger. Siehe die Tabelle am Ende von https://www.jaegertracing.io/docs/1.16/client-features/ für die vollständige Liste. Die Umgebungsvariablen überschreiben alle hier angegebenen Einstellungen.

address

Der Host: Port-Ziel für Berichtsspannen. (z. B.: localhost:6831)

Kann mit den Umgebungsvariablen eingestellt werden JAEGER_AGENT_HOST and JAEGER_AGENT_PORT.

always_included_tag

Durch Kommata getrennte Liste von Tags (csv), die in alle neuen Bereiche aufgenommen werden sollen, z. B. Tag1:Wert1,Tag2:Wert2.

Kann mit der Umgebungsvariablen JAEGER_TAGS gesetzt werden (verwenden Sie = anstelle von : bei der Umgebungsvariable).

sampler_type

Default value ist const.

Gibt den Typ des Samplers an: const, probabilistisch, ratelimitierend oder remote.

Siehe: https://www.jaegertracing.io/docs/1.16/sampling/#client-sampling-configuration for details on the different tracing types.

Kann mit der Umgebungsvariablen gesetzt werden JAEGER_SAMPLER_TYPE.

sampler_param

Default value ist 1.

Dies ist der Sampler-Konfigurationsparameter. Je nach dem Wert von sampler_type kann er 0, 1 oder ein Dezimalwert dazwischen sein.

  • Für const Sampler, 0 oder 1 für immer false bzw. true.
  • Für probabilistic sampler, eine Wahrscheinlichkeit zwischen 0 und 1.0
  • Für rateLimiting sampler, die Anzahl der Spans pro Sekunde
  • Für remote sampler, param ist der gleiche wie für probabilistic und gibt die anfängliche Abtastrate an, bevor die tatsächliche vom Mutterschiff empfangen wird

Kann mit der Umgebungsvariablen JAEGER_SAMPLER_PARAM gesetzt werden.

zipkin_propagation

Default value ist false.

Steuert, ob das Zipkin-Span-Propagationsformat (mit x-b3- HTTP-Headern) verwendet werden soll oder nicht. Standardmäßig wird das Format von Jaeger verwendet.

Kann mit der Umgebungsvariablen und dem Wert gesetzt werden JAEGER_PROPAGATION=b3.

disable_shared_zipkin_spans

Default value ist false.

Wenn Sie dies auf “true” setzen, werden gemeinsam genutzte RPC-Spans deaktiviert. Dies ist die häufigste Einstellung, wenn Sie Zipkin an anderer Stelle in Ihrer Infrastruktur verwenden.


[external_image_storage]

Diese Optionen steuern, wie Bilder öffentlich gemacht werden sollen, damit sie in Diensten wie Slack oder per E-Mail geteilt werden können.

provider

Optionen sind s3, webdav, gcs, azure_blob, local). Wenn leer gelassen, dann ignoriert SmartCollect SC² die Upload-Aktion.


[external_image_storage.s3]

endpoint

Optionale Endpunkt-URL (Hostname oder vollqualifizierte URI), um den standardmäßig generierten S3-Endpunkt zu überschreiben. Wenn Sie den beibehalten wollen, lassen Sie dies einfach leer. Sie müssen trotzdem einen “region”-Wert angeben, wenn Sie einen Endpunkt angeben.

path_style_access

Setzen Sie dies auf true, um eine pfadähnliche Adressierung in S3-Anfragen zu erzwingen, d.h. http://s3.amazonaws.com/BUCKET/KEY, statt anstelle der Standardeinstellung, die, wenn möglich, die Adressierung eines virtuellen gehosteten Buckets ist (http://BUCKET.s3.amazonaws.com/KEY).

Hinweis: Diese Option ist spezifisch für den Amazon S3-Dienst.

bucket_url

(aus Gründen der Abwärtskompatibilität, funktioniert nur, wenn kein Bucket und keine Region konfiguriert sind) Bucket-URL für S3. Die AWS-Region kann in der URL angegeben werden oder wird standardmäßig auf “us-east-1” gesetzt, z. B.

bucket

Bucket-Name für S3. z. B. smartcollect.snapshot.

region

Regionsname für S3. z. B. ‘us-east-1’, ‘cn-north-1’, usw.

path

Optionaler zusätzlicher Pfad innerhalb des Buckets, nützlich für die Anwendung von Verfallsrichtlinien.

access_key

Zugriffsschlüssel, z. B. AAAAAAAAAAAAAAAAAA.

Zugriffsschlüssel erfordert Berechtigungen auf den S3-Bucket für die Aktionen ‘s3:PutObject’ und ‘s3:PutObjectAcl’.

secret_key

Geheimschlüssel, z. B. AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA.


[external_image_storage.webdav]

url

URL, an die SmartCollect SC² eine PUT-Anfrage mit Bildern sendet.

username

Basic auth username.

password

Basic auth password.

public_url

Optionale URL, die in Benachrichtigungen an Benutzer gesendet wird. Wenn die Zeichenfolge die Sequenz ${file} enthält, wird sie durch den hochgeladenen Dateinamen ersetzt. Andernfalls wird der Dateiname an den Pfadteil der URL angehängt, wobei eine eventuelle Abfragezeichenfolge unverändert bleibt.


[external_image_storage.gcs]

key_file

Optionaler Pfad zur JSON-Schlüsseldatei, die mit einem Google-Dienstkonto zur Authentifizierung und Autorisierung verknüpft ist. Wenn kein Wert angegeben wird, wird versucht, die application default credentials zu verwenden. Die Schlüssel für das Dienstkonto können unter https://console.developers.google.com/permissions/serviceaccounts erstellt und heruntergeladen werden.

Das Dienstkonto sollte die Rolle “Storage Object Writer” haben. Das Zugriffskontrollmodell des Buckets muss “Set object-level and bucket-level permissions” sein. SmartCollect SC² selbst wird die Bilder öffentlich lesbar machen, wenn signierte Urls nicht aktiviert sind.

bucket

Bucket Name auf Google Cloud Storage.

path

Optional extra path inside bucket.

enable_signed_urls

Wenn auf “true” gesetzt, erstellt SmartCollect SC² eine [signierte URL](https://cloud.google.com/storage/docs/access-control/signed-urls] für das in Google Cloud Storage hochgeladene Bild.

signed_url_expiration

Legt den Ablauf der signierten URL fest, der standardmäßig auf sieben Tage eingestellt ist.

[external_image_storage.azure_blob]

account_name

Storage account name.

account_key

Storage account key

container_name

Containername, in dem “Blob”-Bilder mit zufälligen Namen gespeichert werden sollen. Das vorherige Erstellen des Blob-Containers ist erforderlich. Es werden nur öffentliche Container unterstützt.


[external_image_storage.local]

This option does not require any configuration.


[rendering]

Optionen zur Konfiguration eines entfernten HTTP-Bildwiedergabedienstes, z. B. mit https://github.com/scada-smartcollect/scada-smartcollect-image-renderer.

server_url

URL zu einem entfernten HTTP-Bildrenderer-Dienst, z. B. http://localhost:8081/render, ermöglicht SmartCollect SC² das Rendern von Panels und Dashboards in PNG-Bilder über HTTP-Anfragen an einen externen Dienst.

callback_url

Wenn der entfernte HTTP-Bildwiedergabedienst auf einem anderen Server als dem SmartCollect SC²-Server läuft, müssen Sie diesen möglicherweise auf eine URL konfigurieren, unter der SmartCollect SC² erreichbar ist, z. B. http://smartcollect.domain/.

concurrent_render_request_limit

Das Limit für gleichzeitige Renderanfragen wirkt sich aus, wenn der HTTP-Endpunkt /render verwendet wird. Das Rendern vieler Bilder zur gleichen Zeit kann den Server überlasten, Davor kann diese Einstellung schützen, indem sie nur eine bestimmte Anzahl von gleichzeitigen Anfragen zulässt. Die Vorgabe ist “30”.

[panels]

enable_alpha

Setzen Sie diese Option auf “true”, wenn Sie Alpha-Panels testen möchten, die noch nicht für den allgemeinen Gebrauch bereit sind. Die Voreinstellung ist false.

disable_sanitize_html

Wenn diese Option auf “true” gesetzt ist, erlaubt SmartCollect SC² Skript-Tags in Textfeldern. Nicht empfohlen, da dies XSS-Schwachstellen ermöglicht. Standard ist false. Diese Einstellung wurde in SmartCollect SC² v6.0 eingeführt.

[plugins]

enable_alpha

Setzen Sie diese Option auf “true”, wenn Sie Alpha-Plugins testen möchten, die noch nicht für den allgemeinen Gebrauch bereit sind. Die Voreinstellung ist false.

allow_loading_unsigned_plugins

Geben Sie eine kommagetrennte Liste von Plugin-Bezeichnern ein, um Plugins zu identifizieren, die geladen werden dürfen, auch wenn sie keine gültige Signatur haben.


[plugin.smartcollect-image-renderer]

Weitere Informationen finden Sie in Image rendering.

rendering_timezone

Weisen Sie die Instanz des Headless-Browsers an, eine Standard-Zeitzone zu verwenden, wenn diese nicht von SmartCollect SC² bereitgestellt wird, z. B. beim Rendern des Panel-Bildes eines Alerts. Siehe ICUs metaZones.txt für eine Liste der unterstützten Zeitzonen-IDs. Fallback auf die TZ-Umgebungsvariable, wenn diese nicht gesetzt ist.

rendering_language

Instruct headless browser instance to use a default language when not provided by SmartCollect SC², e.g. when rendering panel image of alert. Refer to the HTTP header Accept-Language to understand how to format this value, e.g. ‘fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5’.

rendering_viewport_device_scale_factor

Weisen Sie die Headless-Browser-Instanz an, einen Standard-Geräteskalierungsfaktor zu verwenden, wenn dieser nicht von SmartCollect SC² bereitgestellt wird, z. B. beim Rendern des Panel-Bildes einer Warnung. Standard ist “1”. Die Verwendung eines höheren Wertes erzeugt detailliertere Bilder (höhere DPI), erfordert jedoch mehr Speicherplatz zum Speichern eines Bildes.

rendering_ignore_https_errors

Weist die Headless-Browser-Instanz an, ob HTTPS-Fehler bei der Navigation ignoriert werden sollen. Per Voreinstellung werden HTTPS-Fehler nicht ignoriert. Aufgrund des Sicherheitsrisikos empfehlen wir nicht, HTTPS-Fehler zu ignorieren.

rendering_verbose_logging

Instruct headless browser instance whether to capture and log verbose information when rendering an image. Default is false and will only capture and log error messages.

Wenn aktiviert, werden auch Debug-Meldungen erfasst und protokolliert.

Damit die ausführlichen Informationen in das SmartCollect SC²-Serverprotokoll aufgenommen werden, müssen Sie die Rendering-Protokollebene auf Debug einstellen, konfigurieren Sie [log].filter = rendering:debug.

rendering_dumpio

Weist die Headless-Browser-Instanz an, ob ihre Debug- und Fehlermeldungen in den laufenden Prozess des Remote-Rendering-Dienstes ausgegeben werden sollen. Die Voreinstellung ist false.

Es kann nützlich sein, dies bei der Fehlersuche auf “true” zu setzen.

rendering_args

Zusätzliche Argumente, die an die Headless-Browser-Instanz übergeben werden. Die Voreinstellung ist –no-sandbox. Die Liste der Chromium-Flags finden Sie unter (https://peter.sh/experiments/chromium-command-line-switches/). Trennen Sie mehrere Argumente mit Kommas.

rendering_chrome_bin

Sie können das Plugin so konfigurieren, dass es eine andere Browser-Binärdatei anstelle der vorkonfigurierten Version von Chromium verwendet.

Bitte beachten Sie, dass dies nicht empfohlen wird. Sie könnten Probleme bekommen, wenn die installierte Version von Chrome/Chromium nicht mit dem Plugin kompatibel ist.

rendering_mode

Legt fest, wie Headless-Browser-Instanzen erstellt werden. Die Voreinstellung ist default und erzeugt bei jeder Anfrage eine neue Browser-Instanz.

Modus clustered stellt sicher, dass nur ein Maximum an Browsern/Incognito-Seiten gleichzeitig ausgeführt werden kann.

Der Modus reusable hat eine Browser-Instanz und erstellt bei jeder Anfrage eine neue Inkognito-Seite.

rendering_clustering_mode

Wenn rendering_mode = clustered ist, können Sie angeben, wie viele Browser oder Inkognito-Seiten gleichzeitig ausgeführt werden können. Die Voreinstellung ist browser und verwendet Browser-Instanzen als Cluster.

Der Modus context verwendet Inkognito-Seiten als Cluster.

rendering_clustering_max_concurrency

Bei rendering_mode = clustered können Sie die maximale Anzahl von Browser-Instanzen/Incognito-Seiten festlegen, die gleichzeitig ausgeführt werden können.

rendering_viewport_max_width

Begrenzen Sie die maximale Breite des Ansichtsfensters, die angefordert werden kann.

rendering_viewport_max_height

Begrenzen Sie die maximale Höhe des Ansichtsfensters, die angefordert werden kann.

rendering_viewport_max_device_scale_factor

Limit the maximum viewport device scale factor that can be requested.

grpc_host

Change the listening host of the gRPC server. Default host is 127.0.0.1.

grpc_port

Change the listening port of the gRPC server. Default port is 0 and will automatically assign a port not in use.


[enterprise]


[feature_toggles]

enable

Keys of alpha features to enable, separated by space. Available alpha features are: transformations,ngalert

[date_formats]

Hinweis: Die nachstehenden Datumsformatoptionen sind nur in SmartCollect SC² v7.2+ verfügbar.

Dieser Abschnitt steuert systemweite Standardwerte für Datumsformate, die in Zeitbereichen, Diagrammen und Datumseingabefeldern verwendet werden.

Die Formatmuster verwenden Moment.js Formatierungstoken.

full_date

Vollständiges Datumsformat, das von der Zeitbereichswahl und an anderen Stellen verwendet wird, an denen ein vollständiges Datum dargestellt wird.

intervals

Diese Intervallformate werden im Diagramm verwendet, um nur einen Teil des Datums oder der Uhrzeit anzuzeigen. Wenn zum Beispiel nur Minuten zwischen den Tick-Labels der Y-Achse liegen, wird das Format “Intervall_Minute” verwendet.

Standardwerte

interval_second = HH:mm:ss
interval_minute = HH:mm
interval_hour = MM/DD HH:mm
interval_day = MM/DD
interval_month = YYYY-MM
interval_year = YYYY

use_browser_locale

Setzen Sie dies auf “true”, damit die Datumsformate automatisch von Ihrem Browser-Standort abgeleitet werden. Der Standardwert ist false. Dies ist eine experimentelle Funktion.

default_timezone

Wird als Standardzeitzone für Benutzereinstellungen verwendet. Kann entweder browser für die lokale Zeitzone des Browsers oder ein Zeitzonenname aus der IANA-Zeitzonendatenbank sein, z. B. UTC oder Europe/Amsterdam.