푸시 메트릭 API
밀어넣기 메트릭 API는 외부 소스MID 서버에서 로 원시 메트릭 인텔리전스 데이터를 밀어넣을 수 있는 엔드포인트를 제공합니다.
이 API는 원시 데이터를 외부 소스 MID 서버에서 로 푸시하는 클라이언트 측 도구를 기반으로 합니다. REST 수신기 사용 옵션이 활성화된 상태에서 메트릭 인텔리전스 확장을 구성해야 합니다. 설정 MID 서버에 대한 자세한 내용은 메트릭 인텔리전스 시작하기를 참조하십시오.
인증 요구 사항에 대한 자세한 내용은 MID 웹 서버 확장 구성을 참조하십시오.
푸시 메트릭 - POST /mid/sa/metrics
외부 소스MID 서버의 원시 메트릭 인텔리전스 데이터를 .
URL 형식
기본 URL: /api/mid/sa/metrics
지원되는 요청 매개변수
| 이름 | 설명 |
|---|---|
| 없음 |
| 이름 | 설명 |
|---|---|
| 안 함 |
| 이름 | 설명 |
|---|---|
| ci2metric_id | CI(구성 항목)를 식별하는 데 사용할 키-값 쌍의 목록입니다. 이전에는 ci_identifier. 스크립트가 계속 수락 ci_identifier합니다. 데이터 유형: 객체 |
| metric_type | 메트릭 이름입니다. 데이터 유형: 문자열 |
| 노드 | IP 주소, FQDN, CI 이름 또는 호스트입니다. 아래 예시에서는 디스크가 설치된 Linux 서버의 이름입니다. 데이터 유형: 문자열 |
| resource_path | 메트릭 데이터가 수집되는 자원의 경로입니다. 아래 예에서 C:\ 는 메트릭 데이터가 수집되는 자원입니다.데이터 유형: 문자열 |
| 소스 | 메트릭 유형을 모니터링하는 데이터 소스. 데이터 유형: 문자열 |
| 타임스탬프 | 메트릭의 Epoch 타임 스탬프입니다. 데이터 유형: 숫자 단위: 밀리초 |
| 단위 | 소스 메트릭 유형과 연결된 단위 유형입니다. 표: 모니터링 시스템 메트릭 유형[sa_source_metric_type] 데이터 유형: 문자열 |
| 값 | 메트릭의 값입니다. 데이터 유형: 숫자 |
헤더
다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하십시오.
| 머리글 | 설명 |
|---|---|
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 머리글 | 설명 |
|---|---|
| 안 함 |
상태 코드
이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하십시오.
| 상태 코드 | 설명 |
|---|---|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
응답 본문 매개변수(JSON 또는 XML)
| 이름 | 설명 |
|---|---|
| 없음 |
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"
}]"