DataBuilder – Scoped, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • 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.

    Tabelle : 1. Parameter
    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.

    Tabelle : 2. Parameter
    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.
    Tabelle : 3. Ergebnisse
    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.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    start GlideDateTime Der Zeitstempel für den Datenpunkt.
    Wert Zahl Der Wert des Datenpunkts.
    Tabelle : 5. Ergebnisse
    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);