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

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 푸시 메트릭 API

# 푸시 메트릭 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 2분

밀어넣기 메트릭 API는 외부 소스MID 서버에서 로 원시 메트릭 인텔리전스 데이터를 밀어넣을 수 있는 엔드포인트를 제공합니다.

이 API는 원시 데이터를 외부 소스 MID 서버에서 로 푸시하는 클라이언트 측 도구를 기반으로 합니다. REST 수신기 사용 옵션이 활성화된 상태에서 메트릭 인텔리전스 확장을 구성해야 합니다. 설정 MID 서버에 대한 자세한 내용은 [메트릭 인텔리전스 시작](https://www.servicenow.com/docs/access?context=get-started-metrics&version=australia&pubname=australia-it-operations-management&ft:locale=en-US)하기를 참조하십시오.

인증 요구 사항에 대한 자세한 내용은 [MID 웹 서버 확장 구성을](https://www.servicenow.com/docs/access?context=configure-mid-web-server-extension&version=australia&pubname=australia-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 타임 스탬프입니다. 데이터 유형: 숫자 단위: 밀리초 |
| 단위 | 소스 메트릭 유형과 연결된 단위 유형입니다. 표: 모니터링 시스템 메트릭 유형\[sa_source_metric_type\] 데이터 유형: 문자열 |
| 값 | 메트릭의 값입니다. 데이터 유형: 숫자 |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

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

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

{#sa-POST-metrics__entry__32}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#sa-POST-metrics__entry__36}{#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__44}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[ ]

### cURL 요청

이 예와 같이 요청 본문을 대괄호로 묶어야 합니다.

    curl -X POST "https://<mid-server-host>/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"
    }]"