---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

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) 소요 시간: 2분

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 웹 서버 확장 구성을](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 | 메트릭 이름입니다. 데이터 유형: 문자열 |
| 노드 | IP 주소, FQDN, CI 이름 또는 호스트입니다. 아래 예에서 디스크가 설치된 Linux 서버의 이름입니다. 데이터 유형: 문자열 |
| resource_path | 메트릭 데이터가 수집되는 자원의 경로입니다. 아래 예에서 `C:\` 는 메트릭 데이터가 수집되는 자원입니다. 데이터 유형: 문자열 |
| 소스 | 메트릭 유형을 모니터링하는 데이터 소스. 데이터 유형: 문자열 |
| 타임스탬프 | 메트릭의 Epoch 타임스탬프입니다. 데이터 유형: 숫자 단위: 밀리초 |
| 값 | 메트릭의 값입니다. 데이터 유형: 숫자 |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에서 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#sa-POST-metrics__entry__26}{#sa-POST-metrics__content_type-RESTAPI}

| 헤더 | 설명 |
|-|-|
| 컨텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#sa-POST-metrics__entry__30}

| 헤더 | 설명 |
|-|-|
| 없음 |   |
[표 5. 응답 헤더]

### 상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용할 수 있는 상태 코드 목록은 [REST API HTTP 응답 코드를](https://servicenow-prod.fluidtopics.net/JHL64oGR2SkU25ZTkfHy7g "REST(REpresentational State Transfer)는 웹상의 컴퓨터 시스템 간에 표준을 제공하여 서로 보다 쉽게 통신할 수 있게 지원하는 단순한 상태 비저장 아키텍처입니다.") 참조하세요.
{#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"
    }]"