---
sourceDocument: Xanadu API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# プッシュメトリクス API

# プッシュメトリクス API {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2024年08月01日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：3分

Push Metrics API は、外部ソースから MID サーバー に生のオペレーショナルインテリジェンスデータをプッシュできるようにするエンドポイントを提供します。

この API は、外部ソースから MID サーバー に生データをプッシュするクライアント側ツールに基づいています。運用評価指標 拡張は、\[REST リスナーを有効にする\] オプションを有効にして構成する必要があります。MID サーバーの設定の詳細については、「[オペレーショナルインテリジェンス入門](https://www.servicenow.com/docs/access?context=get-started-metrics&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US)」を参照してください。

認証要件の詳細については、「 [MID Web サーバー拡張の設定](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=xanadu&pubname=xanadu-it-operations-management&ft:locale=en-US)」を参照してください。

## 測定基準のプッシュ - POST /mid/sa/metrics {#ariaid-title2}

生の オペレーショナルインテリジェンス データを外部ソースから MID サーバー にプッシュします。

### URL 形式 {#sa-POST-metrics__section_nbn_xsv_3mb}

デフォルトの URL：/api/mid/sa/metrics

### サポートされている要求パラメーター

{#sa-POST-metrics__entry__2}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 1. パスパラメーター]

{#sa-POST-metrics__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 2. クエリパラメータ]

{#sa-POST-metrics__entry__10}

| 名前 | 説明 |
|-|-|
| ci2metric_id | 構成アイテム (CI) を識別するために使用するキーと値のペアのリスト。以前は ci_identifier と呼ばれていました。スクリプトでは引き続き ci_identifier を受け入れます。 データタイプ：オブジェクト |
| metric_type | 測定基準の名前。 データタイプ：文字列 |
| node | IP アドレス、FQDN、CI の名前、またはホスト。以下の例では、ディスクがインストールされている Linux サーバーの名前。 データタイプ：文字列 |
| resource_path | メトリクスデータが収集されるリソースのパス。以下の例では、`C:\` は測定基準データが収集されるリソースです。 データタイプ：文字列 |
| source | 測定基準タイプを監視するデータソースです。 データタイプ：文字列 |
| timestamp | 測定基準のエポックタイムスタンプ。 データタイプ：数値 単位：ミリ秒 |
| value | 測定基準の値。 データタイプ：数値 |
[表 : 3. 要求本文パラメーター (XML または JSON)]

### ヘッダー

次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#sa-POST-metrics__entry__26}{#sa-POST-metrics__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#sa-POST-metrics__entry__30}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。
{#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}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 |
| 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#sa-POST-metrics__entry__42}

| 名前 | 説明 |
|-|-|
| なし |   |
[ ]

### cURL 要求

この例に示すように、要求本文は角括弧で囲む必要があります。

    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"
    }]"