푸시 메트릭 API

푸시 메트릭 API는 통합자가 운영 인텔리전스 외부 소스에서 .MID 서버

이 API는 외부 소스의 원시 데이터를 .MID 서버 운영 메트릭REST 수신기 사용 옵션을 사용하도록 확장을 구성해야 합니다. 설정에 MID 서버대한 자세한 내용은 Operational Intelligence 시작을 참조하십시오.

인증 요구 사항에 대한 자세한 내용은 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	메트릭 이름입니다. 데이터 유형: 문자열
node	IP 주소, FQDN, CI 이름 또는 호스트입니다. 아래 예에서 디스크가 설치되는 Linux 서버의 이름입니다. 데이터 유형: 문자열
resource_path	메트릭 데이터가 수집되는 자원의 경로입니다. 아래 예에서 C:\ 는 메트릭 데이터가 수집되는 리소스입니다. 데이터 유형: 문자열
source	메트릭 유형을 모니터링하는 데이터 소스. 데이터 유형: 문자열
타임스탬프	메트릭의 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"
}"