푸시 메트릭 API

푸시 메트릭 API 메트릭 인텔리전스 는 외부 원본MID 서버에서 .

이 API는 외부 원본 MID 서버에서 . 메트릭 인텔리전스확장은 REST 수신기 사용 옵션이 활성화된 상태로 구성해야 합니다. 설정에 MID 서버대한 자세한 내용은 메트릭 인텔리전스 시작을 참조하십시오.

인증 요구 사항에 대한 자세한 내용은 MID 웹 서버 확장 구성을 참조하십시오.

푸시 메트릭 - POST /mid/sa/metrics

외부 소스의 원시 메트릭 인텔리전스 데이터를 .MID 서버

URL 형식

기본 URL: /api/mid/sa/metrics

지원되는 요청 매개변수

표 1. 경로 매개변수

이름	설명
없음

표 2. 쿼리 매개변수

이름	설명
안 함

표 3. 요청 본문 매개변수(XML 또는 JSON)

이름	설명
ci2metric_id	CI(구성 항목)를 식별하는 데 사용할 키-값 쌍의 목록입니다. 이전에는 로 알려져 ci_identifier있습니다. 스크립트가 계속 수락 ci_identifier합니다. 데이터 유형: 객체
metric_type	메트릭 이름입니다. 데이터 유형: 문자열
노드	IP 주소, FQDN, CI 이름 또는 호스트입니다. 아래 예에서는 디스크가 설치된 Linux 서버의 이름입니다. 데이터 유형: 문자열
resource_path	메트릭 데이터가 수집되는 자원의 경로입니다. 아래 예에서 C:\ 는 메트릭 데이터가 수집되는 자원입니다. 데이터 유형: 문자열
소스	메트릭 유형을 모니터링하는 데이터 소스. 데이터 유형: 문자열
타임스탬프	메트릭의 Epoch 타임스탬프입니다. 데이터 유형: 숫자 단위: 밀리초
값	메트릭의 값입니다. 데이터 유형: 숫자

머리글

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

표 4. 요청 헤더

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

표 5. 응답 헤더

헤더	설명
없음

상태 코드

다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

표 6. 상태 코드

상태 코드	설명
200	성공입니다. 요청이 성공적으로 처리되었습니다.
401	승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
500	내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

응답 본문 매개변수(JSON 또는 XML)

이름	설명
안 함

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