Globale Variablen

SmartCollect SC² hat globale eingebaute Variablen, die in Ausdrücken im Abfrage-Editor verwendet werden können. Dieses Thema listet sie in alphabetischer Reihenfolge auf und definiert sie. Diese Variablen sind in Abfragen, Dashboard-Verknüpfungen, Bedienfeldverknüpfungen und Datenverknüpfungen nützlich.

$__dashboard

Nur verfügbar in SmartCollect SC² v6.7+. In SmartCollect SC² 7.1 änderte sich die Variable von der Anzeige der UID des aktuellen Dashboards zum Namen des aktuellen Dashboards.

Diese Variable ist der Name des aktuellen Dashboards.

$__from and $__to

SmartCollect SC² hat zwei eingebaute Zeitbereichsvariablen: $__from und $__to. Sie werden derzeit standardmäßig immer als Epochen-Millisekunden interpoliert, aber Sie können die Datumsformatierung steuern.

Diese spezielle Formatierungssyntax ist nur in Grafan a 7.1.2+ verfügbar.

Syntax Example result Description
${__from} 1594671549254 Unix millisecond epoch
${__from:date} 2020-07-13T20:19:09.254Z No args, defaults to ISO 8601/RFC 3339
${__from:date:iso} 2020-07-13T20:19:09.254Z ISO 8601/RFC 3339
${__from:date:seconds} 1594671549 Unix seconds epoch
${__from:date:YYYY-MM} 2020-07 Any custom date format

Die obige Syntax funktioniert auch mit ${__to}.

Sie können diese Variable auch in URLs verwenden.

$__interval

Sie können die Variable $__interval als Parameter verwenden, um nach Zeit zu gruppieren (für MySQL, Postgres, MSSQL).

SmartCollect SC² berechnet automatisch ein Intervall, das verwendet werden kann, um in Abfragen nach der Zeit zu gruppieren. Wenn es mehr Datenpunkte gibt, als in einem Diagramm angezeigt werden können, können Abfragen effizienter gestaltet werden, indem nach einem größeren Intervall gruppiert wird. Es ist effizienter, nach 1 Tag zu gruppieren als nach 10s, wenn man 3 Monate Daten betrachtet, und das Diagramm sieht gleich aus und die Abfrage ist schneller. Das $__Intervall wird mit Hilfe des Zeitbereichs und der Breite des Graphen (der Anzahl der Pixel) berechnet.

Ungefähre Berechnung: (von - bis) / Auflösung

Wenn der Zeitbereich z. B. 1 Stunde beträgt und das Diagramm bildschirmfüllend ist, könnte das Intervall zu 2m berechnet werden - die Punkte werden in 2-Minuten-Intervallen gruppiert. Wenn der Zeitbereich 6 Monate beträgt und das Diagramm bildschirmfüllend ist, dann könnte das Intervall 1d (1 Tag) sein - Punkte werden nach Tagen gruppiert.

$__interval_ms

Diese Variable ist die $__interval-Variable in Millisekunden, nicht eine als Zeitintervall formatierte Zeichenkette. Wenn zum Beispiel $__interval 20m ist, dann ist $__interval_ms 1200000.

$__name

Diese Variable ist nur im Bedienfeld “Singlestat” verfügbar und kann in den Feldern “Präfix” oder “Suffix” auf der Registerkarte “Optionen” verwendet werden. Die Variable wird durch den Seriennamen oder den Alias ersetzt.

$__org

Diese Variable ist die ID der aktuellen Organisation. ${__org.name} ist der Name der aktuellen Organisation.

$__user

Nur in SmartCollect SC² v7.1+ verfügbar

${__user.id} ist die ID des aktuellen Benutzers. ${__user.login} ist das Login-Handle des aktuellen Benutzers.

$timeFilter or $__timeFilter

Die Variable $timeFilter gibt den aktuell ausgewählten Zeitbereich als Ausdruck zurück. Der Ausdruck für das Zeitbereichsintervall Last 7 days ist zum Beispiel time > now() - 7d.

Dies wird an mehreren Stellen verwendet, darunter:

  • Log Analytics-Abfragen in der Datenquelle Azure Monitor.
  • SQL-Abfragen in MySQL, Postgres und MSSQL.
  • Die Variable “$__timeFilter” wird in der MySQL-Datenquelle verwendet.