MetricInfo: Bereichsbezogen, Global

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 2 Minuten Lesedauer
  • Die MetricInfo Die API stellt Methoden bereit, um zu überprüfen, ob sich eine Metrik in befindet MetricBase Datenbank und wenn ja, um ihre Aufbewahrungsrichtlinie zu melden. Aufbewahrungsrichtlinien werden in Minuten gemeldet.

    Sie können diese Klasse in bereichsbezogenen und globalen Serverskripts aufrufen. Bei Verwendung von MetricInfo -Klasse verwenden sn_clotho Namespace-Bezeichner.

    Diese Klasse ist Teil von MetricBase Anwendung.

    MetricInfo – MetricInfo (Zeichenfolgentabelle, Zeichenfolgentabelle)

    Erstellt eine Instanz von MetricInfo Klasse.

    Tabelle : 1. Parameter
    Name Typ Beschreibung
    table Zeichenfolge Name der Metriktabelle, die in der Tabelle „Zeitreihenmetriken“ [sys_metric] aufgeführt ist.
    Metrik Zeichenfolge Metrikfeldname, der in der Tabelle „Zeitreihenmetriken“ [sys_metric] aufgeführt ist. Dieser Feldname muss dem Tabellennamen zugeordnet werden.

    Das folgende Beispiel zeigt, wie ein erstellt wird MetricInfo Objekt mit der Höhenmetrik (mb_Demo_mt_Altitude), die der Tabelle „Drohnen“ [mb_Demo_DRONE] zugeordnet ist.

    var metricInfo =  new sn_clotho.MetricInfo('mb_demo_drone','mb_demo_mt_altitude');

    MetricInfo – getRetentionSchedulesInMinutes()

    Ruft die Zeitpläne der Aufbewahrungsrichtlinie der angegebenen Metrik ab.

    Siehe auch MetricBase-Aufbewahrungsrichtlinien .

    Tabelle : 2. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 3. Ergebnisse
    Typ Beschreibung
    Objekt JSON-Objekt mit Schlüssel-Wert-Paaren, die die Zeitpläne für Aufbewahrungsrichtlinien (in Minuten) für die angegebene Metrik darstellen, die in der Tabelle „Aufbewahrungsrichtlinien“ [sys_metric_retention_Policy] aufgeführt ist.
    Für jeden Aufbewahrungsrichtlinienzeitplan, der zur Metrik gehört, enthält das Objekt ein entsprechendes Schlüssel-Wert-Paar, das die Aufbewahrungsdauer dem Stichprobenzeitraum zuordnet.
    • Schlüssel: Aufbewahrungsdauer des Zeitplans für Aufbewahrungsrichtlinien in Minuten.

      Datentyp: Zeichenfolge

    • Wert: Stichprobenzeitraum des Zeitplans für Aufbewahrungsrichtlinien in Minuten.

      Datentyp: Zahl

    "<retentionDuration>": <samplingPeriod>

    Das folgende Beispiel zeigt, wie Sie die Zeitpläne der Aufbewahrungsrichtlinie durchlaufen und eine Protokollnachricht kompilieren. Die Nachricht enthält die Aufbewahrungsdauern, die von Minuten in Tage konvertiert wurden, mit den entsprechenden Stichprobenzeiträumen.

    // Function to convert minutes to days
    function toDays(minutes) {
     return minutes / 60 / 24;
    };
    
    var metricInfo = new sn_clotho.MetricInfo('mb_demo_drone','mb_demo_mt_altitude');
    var schedules = metricInfo.getRetentionSchedulesInMinutes();
    var log = '';
    
    // Compiles a log message with retention schedules
    for (var duration in schedules) {
     log += "Retention duration is: " + toDays(duration) +
     " days, Sampling period is: " + schedules[duration] + " minutes\n";
    }
    
    gs.info(log);

    Ausgabe:

    Retention duration is: 8 days, Sampling period is: 1 minutes
    Retention duration is: 94 days, Sampling period is: 10 minutes
    Retention duration is: 397 days, Sampling period is: 60 minutes

    MetricInfo – isValid()

    Gibt an, ob die angegebene Metrik der in definierten Tabelle zugeordnet ist MetricInfo Objekt.

    Tabelle : 4. Parameter
    Name Typ Beschreibung
    Keine
    Tabelle : 5. Ergebnisse
    Typ Beschreibung
    Boolean

    Kennzeichnung, die angibt, ob die Metrik in angegeben ist MetricInfo Objekt ist der angegebenen Tabelle zugeordnet.

    Gültige Werte:
    • Wahr: Die angegebene Metrik ist gültig.
    • Falsch: Die angegebene Metrik oder Tabelle ist entweder nicht vorhanden, oder die Metrik ist der Tabelle nicht zugeordnet.

    Das folgende Beispiel zeigt, wie überprüft wird, ob sich die Höhenmetrik (mb_Demo_mt_Altitude) in der Tabelle „Drohnen“ [mb_Demo_DRONE] befindet, und wenn dies der Fall ist, wird der Aufbewahrungszeitplan zurückgegeben. Die Beispielausgabe spiegelt die Richtliniendauer in Minuten wider, die dem Intervall-Stichprobenzeitraum zugeordnet ist.

    var metricInfo =  new sn_clotho.MetricInfo('mb_demo_drone','mb_demo_mt_altitude');
    if (metricInfo.isValid())
    {
      var retentionSchedules = metricInfo.getRetentionSchedulesInMinutes();
      gs.info(JSON.stringify(retentionSchedules, null, 2));
    }
    else
    {
      gs.info("metricInfo is invalid");
    }

    Ausgabe:

    {
      "11520": 1,
      "135360": 10,
      "571680": 60
    }