DataBuilder – Scoped, Global
Die Datengenerator Die API bietet Methoden zum Erstellen einer Reihe von Datenpunkten für eine Metrik. Verwenden Sie die sn_clotho.Client.put()-Methode zum Speichern der Werte.
Sie können diese Klasse in bereichsbezogenen und globalen Serverskripts aufrufen. Bei Verwendung von Datengenerator -Klasse verwenden sn_clotho Namespace-Bezeichner.
Diese Klasse ist Teil der MetricBase-Anwendung.
DataBuilder: DataBuilder(Objekt GlideRecord, Zeichenfolgenbetreff, Zeichenfolgenmetrik)
Erstellt eine Instanz der DataBuilder-Klasse.
| Name | Typ | Beschreibung |
|---|---|---|
| glideRecord | Objekt | GlideRecord, aus dem die Domäne abgerufen werden kann. |
| subject | Zeichenfolge | Die sys_id des GlideRecord, der dieser Serie zugeordnet ist. |
| metric | Zeichenfolge | Der Feldname der Metrik. |
Im folgenden Beispiel wird eine neue Instanz von initialisiert Datengenerator Von sn_clotho Namespace mit Now_GR Parameter, der die aktuelle Zeit oder einen bestimmten Zeitbereich darstellt, und der Zeichenfolgenparameter „cpu_percentage“ , Der Name der nachverfolgten Metrik ist.
// Where cpu_percentage is the name of the metric
var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
DataBuilder – hinzufügen(GlideDateTime Start, Array-Wert)
Fügt dem DataBuilder-Objekt eine Reihe von Datenpunkten hinzu. Jeder Datenpunkt ist ein Zeitstempel und ein Wert.
Verwendet den Startparameter und den Erfassungszeitraum für Aufbewahrungsrichtlinien, um den Zeitstempel für jeden Wert im Array zu berechnen. Der erste Wert hat den Startparameter als Zeitstempel. Diese Methode speichert die Daten nicht in der MetricBase-Datenbank. Verwenden Sie die sn_clotho.Client.put()-Methode zum Speichern der Werte.
| Name | Typ | Beschreibung |
|---|---|---|
| start | GlideDateTime | Der Zeitstempel für den ersten Datenpunkt. Nachfolgende Zeitstempel werden anhand des Erfassungszeitraums für Aufbewahrungsrichtlinien berechnet. |
| Wert | Array | Ein Array von Zahlen. |
| Typ | Beschreibung |
|---|---|
| DataBuilder | Das selbe DataBuilder-Objekt. |
Das folgende Beispiel initialisiert zuerst ein Array (Punkte) mit drei numerischen Werten: 7, 0,5 und 273, die verschiedene Datenpunkte im Zusammenhang mit der CPU-Auslastung zu einem bestimmten Zeitstempel darstellen. Dann initialisiert der Code einen neuen sn_clotho.DataBuilder Objekt mit Now_GR (Ein GlideRecord-Objekt) stellt den Zieldatenbankdatensatz dar, in dem diese Daten gespeichert werden. „cpu_percentage“ Ist der Metrikname, der zum Nachverfolgen der CPU-Nutzung verwendet wird.
Mit GlideDateTime wird eine neue Zeitvariable erstellt, die das Objekt auf das aktuelle Datum und die aktuelle Uhrzeit setzt. Schließlich verwendet der Code Datengenerator.hinzufügen (Zeit, Punkte) Dient zum Speichern mehrerer Datenpunkte im Datengeneratorobjekt.
var points = [7,0.5,273];
var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, points);
DataBuilder – hinzufügen(GlideDateTime Start, Zahlenwert)
Fügt dem DataBuilder-Objekt einen Datenpunkt hinzu. Jeder Datenpunkt ist ein Zeitstempel und ein Wert. Diese Methode speichert den Datenpunkt nicht in der Metrik. Verwenden Sie die sn_clotho.Client.put()-Methode zum Speichern der Werte.
| Name | Typ | Beschreibung |
|---|---|---|
| start | GlideDateTime | Der Zeitstempel für den Datenpunkt. |
| Wert | Zahl | Der Wert des Datenpunkts. |
| Typ | Beschreibung |
|---|---|
| DataBuilder | Das DataBuilder-Objekt. |
Im folgenden Beispiel wird zuerst eine neue Instanz von initialisiert Datengenerator Von sn_clotho Namespace mit den Parametern Now_GR (Der Zieldatensatz) und „cpu_percentage“ (Die zu verfolgende Metrik). GlideDateTime Initialisiert die Zeit bis zum aktuellen Datum und zur aktuellen Uhrzeit. Schließlich Datengenerator.hinzufügen() Speichert den Wert 0,6 (Stellt einen Wert von 60 % CPU-Auslastung dar) zum aktuellen Zeitstempel.
var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, 0.6);