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.
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.
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.
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.
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.
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.
Diese Variable ist die ID der aktuellen Organisation.
${__org.name} ist der Name der aktuellen Organisation.
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.
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.