---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MetricInfo: Bereichsbezogen, global

# MetricInfo: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die MetricInfo Die API stellt Methoden bereit, um zu überprüfen, ob sich eine Metrik in befindet MetricBaseDatenbank 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 Sie `sn_Clotho `Namespace-Bezeichner.

Diese Klasse ist Teil von [MetricBase](https://www.servicenow.com/docs/access?context=metricbase&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US) Anwendung.

## MetricInfo -- MetricInfo (Zeichenfolgentabelle, Zeichenfolgenmetrik) {#ariaid-title2}

Erstellt eine Instanz von MetricInfo Klasse.
{#MI-metricInfo__table_nff_zl3_fsb__entry__3}

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

{#MI-metricInfo__table_nff_zl3_fsb}  
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() {#ariaid-title3}

Ruft die Zeitpläne der Aufbewahrungsrichtlinie der angegebenen Metrik ab.
Siehe auch [MetricBase-Aufbewahrungsrichtlinien](https://www.servicenow.com/docs/access?context=metricbase-retention-policies&version=yokohama&pubname=yokohama-servicenow-platform&ft:locale=en-US).
{#MI-getRetentionSchedulesInMinutes__table_qjl_vk3_fsb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 2. Parameter]

{#MI-getRetentionSchedulesInMinutes__table_qjl_vk3_fsb} {#MI-getRetentionSchedulesInMinutes__table_rjl_vk3_fsb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | JSON-Objekt mit Schlüssel-Wert-Paaren, die die Aufbewahrungsrichtlinienzeitpläne (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 {#MI-getRetentionSchedulesInMinutes__ul_fzj_br4_vsb} "<retentionDuration>": <samplingPeriod> |
[Tabelle : 3. Rückgaben]

{#MI-getRetentionSchedulesInMinutes__table_rjl_vk3_fsb}  
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() {#ariaid-title4}

Gibt an, ob die angegebene Metrik der in definierten Tabelle zugeordnet ist MetricInfo Objekt.
{#MI-isValid__table_xqf_xk3_fsb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 4. Parameter]

{#MI-isValid__table_xqf_xk3_fsb} {#MI-isValid__table_yqf_xk3_fsb__entry__2}

| Typ | Beschreibung |
|-|-|
| Boolean | Kennzeichnung, die angibt, ob die in einem angegebene Metrik 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. {#MI-isValid__ul_rm4_qn3_fsb} |
[Tabelle : 5. Rückgaben]

{#MI-isValid__table_yqf_xk3_fsb}  
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 gegebenenfalls den Aufbewahrungszeitplan zurückgegeben wird. 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
    }


