---
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


---

# Push-Metriken-API

# Push-Metriken-API {#ariaid-title1}

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

Die Push-Metriken Die API stellt Endpunkte bereit, mit denen Sie Rohdaten veröffentlichen können MetrikdatenDaten aus einer externen Quelle zu MID-Server.

Diese API basiert auf clientseitigen Tools, die die Rohdaten aus der externen Quelle an übertragen MID-Server. Die MetrikdatenDie Erweiterung muss mit konfiguriert werden Aktivieren Sie DEN REST-Listener Option aktiviert. Weitere Informationen zum Einrichten von MID-Server, Siehe [Erste Schritte mit Metrik Intelligence](https://www.servicenow.com/docs/access?context=get-started-metrics&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US).

Informationen zu Authentifizierungsanforderungen finden Sie unter [Konfigurieren Sie die MID-Webservererweiterung](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=yokohama&pubname=yokohama-it-operations-management&ft:locale=en-US).

## Push-Metriken -- POST /Mid/sa/metrics {#ariaid-title2}

Veröffentlicht Rohdaten MetrikdatenDaten aus einer externen Quelle zu MID-Server.

### URL-Format {#sa-POST-metrics__section_nbn_xsv_3mb}

Standard-URL: /api/MID/sa/metrics

### Unterstützte Anforderungsparameter

{#sa-POST-metrics__entry__2}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 1. Pfad-Parameter]

{#sa-POST-metrics__entry__6}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 2. Abfrageparameter]

{#sa-POST-metrics__entry__10}

| Name | Beschreibung |
|-|-|
| Ci2metric_ID | Liste der Schlüssel-Wert-Paare, die zum Identifizieren des Konfigurationselements (CI) verwendet werden sollen. Früher bekannt als ci_identifier. Das Skript wird weiterhin akzeptiert ci_identifier. Datentyp: Objekt |
| metric_type | Name der Metrik Datentyp: Zeichenfolge |
| Knoten | IP-Adresse, FQDN, Name des CI oder Hosts. Im folgenden Beispiel der Name des Linux-Servers, auf dem die Datenträger installiert sind. Datentyp: Zeichenfolge |
| resource_path | Der Pfad der Ressource, für die Metrikdaten erfasst werden. Im folgenden Beispiel `C:\ `Ist die Ressource, für die Metrikdaten erfasst werden. Datentyp: Zeichenfolge |
| Quelle | Datenquelle, die den Metriktyp überwacht. Datentyp: Zeichenfolge |
| timestamp | Epochenzeitstempel der Metrik. Datentyp: Zahl Einheit: Millisekunden |
| Wert | Wert der Metrik. Datentyp: Zahl |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sa-POST-metrics__entry__26}{#sa-POST-metrics__content_type-RESTAPI}

| Header | Beschreibung |
|-|-|
| Inhaltstyp | Datenformat des Anforderungstexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#sa-POST-metrics__entry__30}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#sa-POST-metrics__entry__34}{#sa-POST-metrics__entry-200-status-code}{#sa-POST-metrics__entry-401-status-code}{#sa-POST-metrics__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 401 | Nicht autorisiert Die Anwenderanmeldeinformationen sind falsch oder wurden nicht übergeben. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#sa-POST-metrics__entry__42}

| Name | Beschreibung |
|-|-|
| Keine |   |
[ ]

### Curl-Anforderung

Der Anforderungstext muss von eckigen Klammern umgeben sein, wie in diesem Beispiel gezeigt.

    curl -X POST "https://servicenow-instance/api/mid/sa/metrics"
    -H "Content-Type: application/json"
    -U "username":"password"
    -d "[{
        "metric_type": "Disk C: % Free Space",
        "resource_path": "C:\\",
        "node": "lnux100",
        "value": 50,
        "timestamp": 1473183012000,
        "ci2metric_id": {
            "node": "lnux100"
        },
        "source": "Splunk"
    }]"


