---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://www.servicenow.com/docs/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# MetricInfo: Bereichsbezogen, global

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

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 Minuten Lesedauer

Die MetricInfo- API bietet Methoden, um zu überprüfen, ob sich eine Metrik in der Datenbank MetricBase befindet, und gegebenenfalls, um ihre Aufbewahrungsrichtlinie zu melden. Aufbewahrungsrichtlinien werden in Minuten angegeben.

Sie können diese Klasse in bereichsbezogenen und globalen Serverskripts aufrufen. Wenn Sie die MetricInfo -Klasse verwenden, verwenden Sie den Namespace-Bezeichner `sn_clotho`.

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

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

Erstellt eine Instanz der 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 wird. |
| Metrik | Zeichenfolge | Name des Metrikfelds, das 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 MetricInfo- Objekt mit der Höhenmetrik (mb_demo_mt_altitude) erstellt wird, 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 für Aufbewahrungsrichtlinien der angegebenen Metrik ab.
Siehe auch [MetricBase-Aufbewahrungsrichtlinien](https://www.servicenow.com/docs/access?context=metricbase-retention-policies&version=xanadu&pubname=xanadu-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 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 Zeitplan für Aufbewahrungsrichtlinien, der zu der Metrik gehört, enthält das -Objekt ein entsprechendes Schlüssel-Wert-Paar, das die Aufbewahrungsdauer dem Stichprobenzeitraum zuordnet. * Schlüssel: Aufbewahrungsdauer des Zeitplans der Aufbewahrungsrichtlinie in Minuten.Datentyp: Zeichenfolge * Wert: Probenahmezeitraum des Zeitplans der Aufbewahrungsrichtlinie in Minuten.Datentyp: Zahl {#MI-getRetentionSchedulesInMinutes__ul_fzj_br4_vsb} "<retentionDuration>": <samplingPeriod> |
[Tabelle : 3. Ergebnisse]

{#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 von Minuten in Tage konvertierten Aufbewahrungsdauern 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 einem MetricInfo- Objekt definierten Tabelle zugeordnet ist.
{#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 MetricInfo- Objekt angegebene Metrik der angegebenen Tabelle zugeordnet ist. 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. Ergebnisse]

{#MI-isValid__table_yqf_xk3_fsb}  
Das folgende Beispiel zeigt, wie Sie überprüfen, ob die Metrik „Höhe" (mb_demo_mt_altitude) in der Tabelle „Drohnen" \[mb_demo_drone\] vorhanden ist, und wie Sie ggf. den Aufbewahrungszeitplan zurückgeben. Die Beispielausgabe gibt die Richtliniendauer in Minuten an, die dem Intervall-Sampling-Zeitraum 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
    }