--- 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 --- # MetricBase 시계열 API # MetricBase 시계열 API {#ariaid-title1} * 릴리스 버전: Australia * * 업데이트 날짜 2026년 03월 12일 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 79분 MetricBase 시계열 API는 데이터베이스에 데이터를 삽입하고, 정보를 검색하고, 데이터베이스에 대해 MetricBase 변환을 실행할 엔드포인트를 제공합니다. 이 API는 플러그인(com.snc.clotho)이 MetricBase 설치되고 활성화된 경우에만 사용할 수 있습니다. API에 쓰는 데 필요한 역할: clotho_rest_put. 이 섹션의 예시는 MetricBase(com.snc.clotho) 플러그인의 데이터를 사용하여 생성되었습니다. ## MetricBase 시계열 - GET /now/clotho/table/{table}/{subject}/{metric} {#ariaid-title2} 데이터베이스에서 MetricBase 지정된 시계열 데이터를 검색합니다. ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/table/{table}/{subject}/{metric} ### 지원되는 요청 매개변수 {#clotho-GET-clotho-table__entry__2}{#clotho-GET-clotho-table__entry-metric-metricbase}{#clotho-GET-clotho-table__entry-table-metricbase} | 이름 | 설명 | |-|-| | api_version | | | 메트릭 | 메트릭으로 사용할 매개변수에서 subject 식별된 테이블의 열 이름입니다. 데이터 유형: 문자열 | | 주제 | 이 계열과 연결된 GlideRecord Sys_id입니다. 데이터 유형: 문자열 | | 테이블 | 이 계열과 연결된 GlideRecord가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 | [표 1. 경로 매개변수] {#clotho-GET-clotho-table__entry__12}{#clotho-GET-clotho-table__entry-sysparm_display_value-metricbase}{#clotho-GET-clotho-table__entry-sysparm_end-metricbase}{#clotho-GET-clotho-table__entry-sysparm_start-metricbase} | 이름 | 설명 | |-|-| | sysparm_display_value | 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 결과 데이터에 주체 기록 표시 값으로 레이블이 지정됩니다. * 아니오: 결과 데이터에 제목 기록 표시 값 레이블이 지정되지 않았습니다. {#clotho-GET-clotho-table__ul_mgs_vzy_tkb} 데이터 유형: 부울 기본값: false | | sysparm_end | 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다. 시간 값에는 이 종료 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\]입니다( `예: 2019-03-20T17:04:55`). * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-GET-clotho-table__ul_nxc_f5f_rlb} | | sysparm_start | 필수 평가 기간의 시작 시간입니다. 특수 값 `all` 을 사용하여 시작 시간을 현재 시간에서 지정된 메트릭의 최대 보존 기간을 뺀 값으로 설정할 수 있습니다. 비어 있거나 누락된 값은 암시적 `모두`로 처리됩니다. 시간 값에는 이 시작 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\] (`예: 2019-03-20T17:04:55`) * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-GET-clotho-table__ul_wzt_ntf_rlb} | [표 2. 쿼리 매개변수] {#clotho-GET-clotho-table__entry__20} | 이름 | 설명 | |-|-| | 안 함 | | [표 3. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-GET-clotho-table__entry__24}{#clotho-GET-clotho-table__accept-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 4. 요청 헤더] {#clotho-GET-clotho-table__entry__28} | 머리글 | 설명 | |-|-| | 안 함 | | [표 5. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-GET-clotho-table__entry__32}{#clotho-GET-clotho-table__entry-200-status-code}{#clotho-GET-clotho-table__entry-401-status-code}{#clotho-GET-clotho-table__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 6. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#clotho-GET-clotho-table__table_avx_j1g_rlb__entry__2} | 이름 | 설명 | |-|-| | 레이블 | 이 메트릭의 결과 세트를 식별하는 데 사용되는 레이블입니다. 데이터 유형: 문자열 | | 시리즈 참조 | 데이터 계열 결과입니다. 데이터 유형: 객체 배열 "seriesRef": [ { "metric": "String", "subject": "String", "table": "String" } ] | | seriesRef.metric | 데이터 계열을 가져온 메트릭의 이름입니다. 객체가 metrics 요청에 전달된 경우에만 나타납니다. 데이터 유형: 문자열 | | seriesRef.subject | 데이터 계열 기록의 Sys_id입니다. 에 지정된 seriesRef.table테이블에 있습니다. 데이터 유형: 문자열 | | seriesRef.table | 데이터 계열을 가져온 테이블의 이름입니다. 데이터 유형: 문자열 | | 값 | 변환된 계열 값입니다. 데이터 유형: 객체 배열 "values": [ { "timestamp": "String", "value": Number } ] | | values.timestamp | 값의 타임스탬프입니다. 데이터 유형: 문자열 형식: ISO 8601 | | 값.값 | 메트릭 값입니다. 데이터 유형: 숫자 | [ ] {#clotho-GET-clotho-table__table_avx_j1g_rlb} ### cURL 요청
curl "https://instance.servicenow.com/api/now/v1/clotho/ table/mb_demo_drone/626b051787333200a328c5b836cb0b99/ mb_demo_mt_altitude?sysparm_start=2019-03-20T17%3A04%3A55 &sysparm_end=2019-03-20T17%3A09%3A55" \ --request GET \ --header "Accept:application/json" \ --user "username":"password"
{ "seriesRef": { "subject": "626b051787333200a328c5b836cb0b99", "table": "mb_demo_drone", "metric": "mb_demo_mt_altitude" }, "label": "626b051787333200a328c5b836cb0b99: mb_demo_drone|mb_demo_mt_altitude", "values": [ { "timestamp": "2019-03-20T17:05:00Z", "value": 83.150185 }, { "timestamp": "2019-03-20T17:06:00Z", "value": 83.46074 }, { "timestamp": "2019-03-20T17:07:00Z", "value": 83.83104 }, { "timestamp": "2019-03-20T17:08:00Z", "value": 84.260635 }, { "timestamp": "2019-03-20T17:09:00Z", "value": 84.749 } ] } ## MetricBase 시계열 - GET /now/clotho/transform/{table}/{metric} {#ariaid-title3} 지정된 매개변수를 기반으로 지정된 데이터를 변환합니다. ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/transform/{table}/{metric} ### 지원되는 요청 매개변수 {#clotho-GET-clotho-transform__entry__2}{#clotho-GET-clotho-transform__version-entry-RESTAPI}{#clotho-GET-clotho-transform__entry-metric-metricbase}{#clotho-GET-clotho-transform__entry-table-metricbase} | 이름 | 설명 | |-|-| | api_version | | | 메트릭 | 메트릭으로 사용할 매개변수에서 subject 식별된 테이블의 열 이름입니다. 데이터 유형: 문자열 | | 테이블 | 이 계열과 연결된 GlideRecord가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 | [표 7. 경로 매개변수] {#clotho-GET-clotho-transform__entry__10}{#clotho-GET-clotho-transform__entry-sysparm_display_value-metricbase}{#clotho-GET-clotho-transform__entry-sysparm_end-metricbase}{#clotho-GET-clotho-transform__entry-sysparm_start-metricbase} | 이름 | 설명 | |-|-| | sysparm_display_value | 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 결과 데이터에 주체 기록 표시 값으로 레이블이 지정됩니다. * 아니오: 결과 데이터에 제목 기록 표시 값 레이블이 지정되지 않았습니다. {#clotho-GET-clotho-transform__ul_mgs_vzy_tkb} 데이터 유형: 부울 기본값: false | | sysparm_end | 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다. 시간 값에는 이 종료 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\]입니다( `예: 2019-03-20T17:04:55`). * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-GET-clotho-transform__ul_nxc_f5f_rlb} | | sysparm_query | 제목 기록을 찾기 위해 인코딩된 쿼리 문자열입니다. 데이터 유형: 문자열 기본값: 없음 | | sysparm_start | 필수 평가 기간의 시작 시간입니다. 특수 값 `all` 을 사용하여 시작 시간을 현재 시간에서 지정된 메트릭의 최대 보존 기간을 뺀 값으로 설정할 수 있습니다. 비어 있거나 누락된 값은 암시적 `모두`로 처리됩니다. 시간 값에는 이 시작 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\] (`예: 2019-03-20T17:04:55`) * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-GET-clotho-transform__ul_wzt_ntf_rlb} | | sysparm_subject_limit | 제목 쿼리 결과의 크기를 제한합니다. 데이터 유형: 숫자 기본값: 10,000 | | sysparm_transforms | 쉼표로 구분된 변환 목록입니다. 유효한 변환: * add * 평균 * 레이블 * 물 * 리샘플링 * 합계 * 상위 {#clotho-GET-clotho-transform__ul_cgj_s1z_tkb} 데이터 유형: 문자열 기본값: 없음 | [표 8. 쿼리 매개변수] {#clotho-GET-clotho-transform__entry__24} | 이름 | 설명 | |-|-| | 안 함 | | [표 9. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-GET-clotho-transform__entry__28}{#clotho-GET-clotho-transform__accept-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json | [표 10. 요청 헤더] {#clotho-GET-clotho-transform__entry__32} | 머리글 | 설명 | |-|-| | 안 함 | | [표 11. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-GET-clotho-transform__entry__36}{#clotho-GET-clotho-transform__entry-200-status-code}{#clotho-GET-clotho-transform__entry-401-status-code}{#clotho-GET-clotho-transform__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 12. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#clotho-GET-clotho-transform__table_ak1_l1g_rlb__entry__2} | 이름 | 설명 | |-|-| | 레이블 | 이 메트릭의 결과 세트를 식별하는 데 사용되는 레이블입니다. 데이터 유형: 문자열 | | 시리즈 참조 | 데이터 계열 결과입니다. 데이터 유형: 객체 배열 "seriesRef": [ { "metric": "String", "subject": "String", "table": "String" } ] | | seriesRef.metric | 데이터 계열을 가져온 메트릭의 이름입니다. 객체가 metrics 요청에 전달된 경우에만 나타납니다. 데이터 유형: 문자열 | | seriesRef.subject | 데이터 계열 기록의 Sys_id입니다. 에 지정된 seriesRef.table테이블에 있습니다. 데이터 유형: 문자열 | | seriesRef.table | 데이터 계열을 가져온 테이블의 이름입니다. 데이터 유형: 문자열 | | 값 | 변환된 계열 값입니다. 데이터 유형: 객체 배열 "values": [ { "timestamp": "String", "value": Number } ] | | values.timestamp | 값의 타임스탬프입니다. 데이터 유형: 문자열 형식: ISO 8601 | | 값.값 | 메트릭 값입니다. 데이터 유형: 숫자 | [ ] {#clotho-GET-clotho-transform__table_ak1_l1g_rlb} ### cURL 요청 curl "https://instance.servicenow.com/api/now/v1/clotho/ transform/mb_demo_drone/mb_demo_mt_speed? sysparm_query=model%3DKingfisher%20Phantom& sysparm_start=2019-03-25T17%3A04%3A55& sysparm_end=2019-03-25T17%3A05%3A10" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" 출력: [ { "seriesRef": { "subject": "2a6b051787333200a328c5b836cb0b92", "table": "mb_demo_drone", "metric": "mb_demo_mt_speed" }, "label": "2a6b051787333200a328c5b836cb0b92:mb_demo_drone |mb_demo_mt_speed", "values": [ { "timestamp": "2019-03-25T17:05:00Z", "value": 33.67892 } ] }, { "seriesRef": { "subject": "666b051787333200a328c5b836cb0b92", "table": "mb_demo_drone", "metric": "mb_demo_mt_speed" }, "label": "666b051787333200a328c5b836cb0b92:mb_demo_drone |mb_demo_mt_speed", "values": [ { "timestamp": "2019-03-25T17:05:00Z", "value": 41.94985 } ] }, { "seriesRef": { "subject": "a26b051787333200a328c5b836cb0b92", "table": "mb_demo_drone", "metric": "mb_demo_mt_speed" }, "label": "a26b051787333200a328c5b836cb0b92:mb_demo_drone |mb_demo_mt_speed", "values": [ { "timestamp": "2019-03-25T17:05:00Z", "value": 37.74187 } ] }, { "seriesRef": { "subject": "ea6b051787333200a328c5b836cb0b92", "table": "mb_demo_drone", "metric": "mb_demo_mt_speed" }, "label": "ea6b051787333200a328c5b836cb0b92:mb_demo_drone |mb_demo_mt_speed", "values": [ { "timestamp": "2019-03-25T17:05:00Z", "value": 34.914192 } ] }, { "seriesRef": { "subject": "ee6b051787333200a328c5b836cb0b91", "table": "mb_demo_drone", "metric": "mb_demo_mt_speed" }, "label": "ee6b051787333200a328c5b836cb0b91:mb_demo_drone |mb_demo_mt_speed", "values": [ { "timestamp": "2019-03-25T17:05:00Z", "value": 44.170887 } ] } ] ## MetricBase 시계열 - POST /now/clotho/accumulate {#ariaid-title4} 지정된 타임스탬프에 메트릭 값을 누적하고 값을 덮어쓰지 않고 결과를 데이터베이스에 저장합니다. 이 API 사용 를 사용하여 전기의 킬로와트시(kWhs)와 같이 누적에 대해 합산할 수 있는 메트릭을 처리합니다. Accumulate는 제공된 타임스탬프에서 각 메트릭을 호출합니다. 예를 들어, 히터, 전기 주전자, 세탁기를 위해 수집된 킬로와트는 세 번의 호출을 축적합니다. ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/accumulate ### 지원되는 요청 매개변수 {#clotho-POST-clotho-accumulate__entry__2}{#clotho-POST-clotho-accumulate__version-not_optional-RESTAPI} | 이름 | 설명 | |-|-| | api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 | [표 13. 경로 매개변수] {#clotho-POST-clotho-accumulate__entry__6}{#clotho-POST-clotho-accumulate__ph-accumulate-default-metricbase} | 이름 | 설명 | |-|-| | default_value | 지정된 타임스탬프에서의 누적에 대한 기본값입니다. 지정된 타임스탬프에 값을 사용할 수 없는 경우 누적하기 위해 처음 호출 중에만 사용됩니다. 사용 사례는 total_power에 대한 와트 메트릭을 누적하는 것일 수 있습니다. 측정할 전력계가 없는 콘센트에 연결된 라우터에 대해 와트를 축적하려고 합니다. 소비 값을 알고 있고 상수인 경우) 상수 값을 기본값으로 사용하여 total_power 누적할 수 있습니다. 예를 들어 라우터가 계속 연결되어 있고 20와트를 소비하는 경우 20을 사용합니다.{#clotho-POST-clotho-accumulate__p-accumulate-default-metricbase} 데이터 유형: 문자열 기본값: 0 | | sysparm_ignore_unknown_series | 알 수 없는 계열을 무시하고 오류를 반환하지 않고 트랜잭션을 계속할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 알 수 없는 계열을 무시합니다. * false: 알 수 없는 계열을 무시하지 마십시오. {#clotho-POST-clotho-accumulate__ul_sbz_y5t_lrb} 기본값: true | [표 14. 쿼리 매개변수] {#clotho-POST-clotho-accumulate__entry__12} | 이름 | 설명 | |-|-| | 시리즈 참조 | 업데이트할 데이터 계열 정보를 나타내는 문자열 목록입니다. 데이터 유형: 배열 "seriesRef": [ { "metric": "String", "subject": "String", "table": "String" } ] | | seriesRef.metric | 필수 업데이트할 누적 메트릭의 이름입니다. 데이터 유형: 문자열 | | seriesRef.subject | 필수 데이터를 업데이트할 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 지정일 seriesRef.table | | seriesRef.table | 필수 데이터를 저장할 테이블의 이름입니다. 데이터 유형: 문자열 | | 값 | 필수 누적 및 저장할 계열 값입니다. 타임스탬프가 동일한 값은 쿼리 매개변수를 사용하여 default_value 집계됩니다. 데이터 유형: 배열 "values": [ { "timestamp": "String", "value": Number } ] | | values.timestamp | 필수 값의 ISO 8601 타임스탬프입니다. 데이터 유형: 문자열 형식: YYYY-MM-ddTHH:mm:ddZ 'Z'로 표시되는 문자는 ISO 형식의 타임스탬프로 UTC 시간대를 나타냅니다. 타임스탬프 형식의 이 부분은 선택 사항입니다. 예: `2019-03-21T17:05:00Z` | | 값.값 | 필수 메트릭 값입니다. 데이터 유형: 숫자 | [표 15. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-accumulate__entry__28}{#clotho-POST-clotho-accumulate__accept-JSON-only-entry-RESTAPI}{#clotho-POST-clotho-accumulate__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 16. 요청 헤더] {#clotho-POST-clotho-accumulate__entry__34} | 머리글 | 설명 | |-|-| | 안 함 | | [표 17. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-accumulate__entry__38}{#clotho-POST-clotho-accumulate__entry-200-status-code}{#clotho-POST-clotho-accumulate__entry-401-status-code}{#clotho-POST-clotho-accumulate__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 18. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#clotho-POST-clotho-accumulate__entry__46} | 이름 | 설명 | |-|-| | 메시지 | 성공(정상) 또는 오류를 나타내는 메시지입니다. | [ ] ### cURL 요청 이 예시에서는 지정된 타임스탬프에 메트릭 값을 누적하는 방법을 보여줍니다. curl "https://instance.servicenow.com/api/now/v1/clotho/accumulate" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"seriesRef\": { \"subject\": \"3D666b051787333200a328c5b836cb0b92\", \"table\": \"power_monitoring\", \"metric\": \"total_power\" }, \"values\": [ { \"timestamp\": \"2019-03-21T17:05:00Z\", \"value\": 0.150185 }, { \"timestamp\": \"2019-03-21T17:05:00Z \", \"value\": 0.46074 }, { \"timestamp\": \"2019-03-21T17:05:00Z \", \"value\": 0.83104 }, { \"timestamp\": \"2019-03-21T17:05:00Z \", \"value\": 1.260635 }, { \"timestamp\": \"2019-03-21T17:05:00Z \", \"value\": 1.749 } ] }" \ --user "username":"password" 성공적인 결과와 함께 제공된 출력입니다. { "result": { "message": "ok" } } ## MetricBase 시계열 - POST /now/clotho/transform {#ariaid-title5} 선형 파이프라인을 형성하는 지정된 변환 목록을 적용한 후 하나 이상의 메트릭에 대한 시계열 데이터를 검색하고 선택적으로 그룹화합니다. ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/transform ### 지원되는 요청 매개변수 {#clotho-POST-clotho-transform__table_md4_gb5_ssb__entry__2}{#clotho-POST-clotho-transform__version-not_optional-RESTAPI} | 이름 | 설명 | |-|-| | api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 | [표 19. 경로 매개변수] {#clotho-POST-clotho-transform__table_md4_gb5_ssb} {#clotho-POST-clotho-transform__entry__6}{#clotho-POST-clotho-transform__entry-sysparm_display_value-metricbase} | 이름 | 설명 | |-|-| | sysparm_display_value | 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 결과 데이터에 주체 기록 표시 값으로 레이블이 지정됩니다. * 아니오: 결과 데이터에 제목 기록 표시 값 레이블이 지정되지 않았습니다. {#clotho-POST-clotho-transform__ul_mgs_vzy_tkb} 데이터 유형: 부울 기본값: false | [표 20. 쿼리 매개변수] {#clotho-POST-clotho-transform__entry__10} | 이름 | 설명 | |-|-| | 끝 | 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다. 시간 값에는 이 종료 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\]입니다( `예: 2019-03-20T17:04:55`). * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-POST-clotho-transform__ul_nxc_f5f_rlb} | | 제한 | 반환할 최대 기록 수입니다. 이례적으로 큰 값은 시스템 성능에 영향을 줄 수 있습니다. 데이터 유형: 숫자 기본값: 10,000 | | 메트릭 | 변환에 사용할 메트릭 객체의 목록입니다. 메트릭에 대한 자세한 내용은 다음 문서를 참조하십시오 [Metrics](https://www.servicenow.com/docs/access?context=c_MetricDefinitionSupport&version=australia&pubname=australia-platform-administration&ft:locale=en-US). 데이터 유형: 배열 "metrics": [ { "groupBy": "String" "label": "String", "metric": "String", "transforms": [Array] } ] | | metrics.groupBy | 매개변수에 table 지정된 테이블에 포함된 쉼표로 구분된 필드 목록으로, 집계된 변환을 수집하거나 적용하기 전에 계열을 그룹화합니다. 목록에 있는 항목의 순서는 데이터가 그룹화되는 순서입니다. 예를 들어 목록에 "주, 우편 번호"라는 두 개의 항목이 있는 경우 계열은 먼저 주별로 그룹화된 다음 주 내의 우편 번호별로 그룹화됩니다. 데이터 유형: 문자열 기본값: 데이터는 그룹화되지 않습니다. | | metrics.label | 이 메트릭의 결과 세트에 사용할 레이블입니다. 변환 체인에서 생성된 모든 레이블을 대체합니다. 데이터 유형: 문자열 기본값: 생성된 기본 레이블. | | metrics.metric | 객체가 전달되면 필수 metrics 입니다. 변환에 사용할 메트릭 필드입니다. 이 필드는 매개변수에 table 지정된 테이블에 있어야 합니다. 데이터 유형: 문자열 | | metrics.transforms | 검색된 시계열 데이터에 적용할 변환(변환 체인) 목록입니다. 각 변환은 이전 변환의 결과를 기반으로 빌드됩니다. 사용 가능한 변환 목록은 아래에서 [지원되는 변환을 참조하십시오.](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 데이터 유형: 객체 배열 "transforms": [ { "arg": {Object}, "name": "String" } ] | | metrics.transforms.arg | 변환에 따라 다릅니다. 변환에 전달할 매개변수입니다. 일반 가이드라인: * 매개변수를 사용하지 않는 변환을 지정할 때는 이 arg 매개변수를 사용하지 마십시오. * 단일 매개변수를 사용하는 변환에는 숫자, 문자열 또는 부울을 사용합니다. * 둘 이상의 매개변수를 사용하는 변환에는 적절한 이름-값 쌍과 함께 JSON 객체를 사용합니다. {#clotho-POST-clotho-transform__ul_grw_jrs_qlb} 데이터 유형: 변환에 따라 숫자, 문자열, 부울 또는 JSON 객체. (사용 가능한 변환 목록은 아래 [지원되는 변환](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 테이블을 참조하십시오.) | | metrics.transforms.name | 객체가 transforms 지정된 경우 필요합니다. 변환의 이름입니다. 사용 가능한 변환 목록은 아래 [지원되는 변환 테이블을 참조하십시오.](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 데이터 유형: 문자열 | | 쿼리 | 결과 세트를 필터링하는 데 사용할 인코딩된 쿼리입니다. 지정된 테이블의 필터 편집기를 사용하여 쿼리를 작성할 수 있습니다. 생성이 완료되면 필터의 이동 경로 컨텍스트 메뉴에서 URL 복사 를 선택합니다. 데이터 유형: 문자열 기본값: 없음 | | 시작 | 필수 평가 기간의 시작 시간입니다. 특수 값 `all` 을 사용하여 시작 시간을 현재 시간에서 지정된 메트릭의 최대 보존 기간을 뺀 값으로 설정할 수 있습니다. 비어 있거나 누락된 값은 암시적 `모두`로 처리됩니다. 시간 값에는 이 시작 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\] (`예: 2019-03-20T17:04:55`) * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-POST-clotho-transform__ul_wzt_ntf_rlb} | | 테이블 | 필수 이 계열과 연결된 GlideRecord가 들어 있는 테이블의 이름입니다. 데이터 유형: 문자열 | [표 21. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-transform__entry__36}{#clotho-POST-clotho-transform__accept-JSON-only-entry-RESTAPI}{#clotho-POST-clotho-transform__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 22. 요청 헤더] {#clotho-POST-clotho-transform__entry__42} | 머리글 | 설명 | |-|-| | 안 함 | | [표 23. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-transform__entry__46}{#clotho-POST-clotho-transform__entry-200-status-code}{#clotho-POST-clotho-transform__entry-400-status-code}{#clotho-POST-clotho-transform__entry-401-status-code}{#clotho-POST-clotho-transform__entry-404-status-code}{#clotho-POST-clotho-transform__entry-405-status-code}{#clotho-POST-clotho-transform__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | | 405 | 잘못된 메서드입니다. 기능이 비활성화되었습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 24. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#clotho-POST-clotho-transform__entry__60} | 이름 | 설명 | |-|-| | 결과 | 쿼리를 충족하는 0개 이상의 반환 결과 객체입니다. 배열 또는 배열을 포함 series 합니다 grouped . 데이터 유형: 배열 "results":[ { "grouped": [Array], "marker": "String", "series": [Array] } ] | | results.grouped | 각 grouped 결과 객체가 특정 그룹에 해당하는 그룹화된 결과 객체의 목록입니다. 이 형식은 매개변수가 metrics.groupBy 요청 본문에 전달될 때 반환됩니다. 데이터 유형: 배열 "grouped": [ { "groupingBy": "String", "groups": [Array] } ] | | results.grouped.groupingBy | 요청의 매개변수에 metrics.groupBy 전달된 값입니다. 데이터 유형: 문자열 | | 결과.그룹화.그룹 | 요청의 매개변수 내용을 기반으로 생성된 그룹 목록입니다 metrics.groupBy . 데이터 유형: 배열 "groups": [ { "group": "String", "label": "String", "series": {Object} } ] | | results.grouped.groups.group | 그룹의 이름입니다. 데이터 유형: 문자열 | | results.grouped.groups.label | 그룹의 레이블입니다. 데이터 유형: 문자열 | | results.grouped.groups.series | 그룹 결과에 대해 변환된 값입니다. 데이터 유형: 배열 "series": [ { "label": "String", "seriesRef": {Object}, "values": [Array] } ] | | results.grouped.groups.series.label | 계열의 레이블입니다. 데이터 유형: 문자열 | | results.grouped.groups.series.seriesRef | 단일 데이터 계열의 결과입니다. 응답에 여러 데이터 계열이 있는 경우에는 표시되지 않습니다. 데이터 유형: 객체 "seriesRef": { "metric": "String", "subject": "String", "table": "String" } | | results.grouped.groups.series.seriesRef.metric | 데이터 계열을 가져온 메트릭의 이름입니다. 객체가 metrics 요청에 전달된 경우에만 나타납니다. 데이터 유형: 문자열 | | results.grouped.groups.series.seriesRef.subject | 데이터 계열 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 매개변수에 지정된 results.series.seriesRef.table 테이블입니다. | | results.grouped.groups.series.seriesRef.table | 데이터 계열을 가져온 테이블의 이름입니다. 데이터 유형: 문자열 | | results.grouped.groups.series.values | 그룹의 결과 값 목록입니다. 데이터 유형: 배열 "values": [ { "timestamp": "String", "value": Number } ] | | results.grouped.groups.series.values.timestamp | 값의 ISO 8601 타임스탬프입니다. 데이터 유형: 문자열 | | results.grouped.groups.series.values.value | 변환된 값입니다. 데이터 유형: 숫자 | | results.marker | 해당 결과의 고유 식별자입니다. 데이터 유형: 문자열 | | 결과.시리즈 | 그룹화되지 않은 일련의 결과 객체의 목록입니다. 데이터 유형: 객체 배열 "series": [ { "label": "String", "seriesRef": {Object}, "values": [Array] } ] | | 결과.시리즈.레이블 | 데이터 계열 레이블입니다. 이 값은 엔드포인트에 의해 생성되거나 매개변수에 전달된 값입니다 metrics.label . 데이터 유형: 문자열 | | results.series.seriesRef | 단일 데이터 계열의 결과입니다. 응답에 여러 데이터 계열이 있는 경우에는 표시되지 않습니다. 데이터 유형: 객체 "seriesRef": { "metric": "String", "subject": "String", "table": "String" } | | results.series.seriesRef.metric | 데이터 계열을 가져온 메트릭의 이름입니다. 객체가 metrics 요청에 전달된 경우에만 나타납니다. 데이터 유형: 문자열 | | results.series.seriesRef.subject | 데이터 계열 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 매개변수에 results.series.seriesRef.table 정의되어 있습니다. | | results.series.seriesRef.table | 데이터 계열을 가져온 테이블의 이름입니다. 데이터 유형: 문자열 | | 결과.시리즈.값 | 변환된 계열 값입니다. 데이터 유형: 객체 배열 "values": [ { "timestamp": "String", "value": Number } ] | | results.series.values.timestamp | 값의 ISO 8601 타임스탬프입니다. 데이터 유형: 문자열 | | 결과.시리즈.값.값 | 변환된 값입니다. 데이터 유형: 숫자 | [ ] ### 지원되는 변환 {#clotho-POST-clotho-transform__Supported_transforms} {#clotho-POST-clotho-transform__id_abm_vgl_2tb__entry__2}{#clotho-POST-clotho-transform__version-row-RESTAPI} | 변환 | 설명 | |-|-| | add | 각 타임스탬프 값에 지정된 숫자를 추가합니다. 인수: arg(10진수 데이터 유형) - 더할 숫자입니다. 예: "transforms": [ { "name": "add", "arg": 8 } ] | | 자동 상관 관계 | 1부터 시작하는 증가하는 기간 수로 구분된 타임스탬프 값 간의 상관 관계를 계산합니다. | | 평균 | 입력 전체에서 각 해당 타임스탬프의 평균 값을 포함하는 시계열을 하나의 계열로 시계열을 집계합니다. | | 하단 | 가장 낮은 값을 가진 지정된 수의 계열을 반환합니다. 인수: arg (정수) -- 반환할 계열 수입니다. 예를 들어, 다음은 가장 낮은 값 집합을 포함하는 두 시계열을 반환합니다. "transforms": [ { "name": "bottom", "arg": 2 } ] | | 씨일 | 각 타임스탬프의 값을 지정된 정밀도(`ceil(value / ) * )`로 반올림합니다. 인수: arg(10진수 데이터 유형) - 반올림할 10진수 정밀도입니다. | | 수집 | 변환 호출 수집 지점까지 변환 체인의 변환 결과를 표시합니다. 변환 결과 수집에는 고유한 마커가 포함되어 있지만 레이블을 정의할 수도 있습니다. 예: { "start": "PT1H", "end": "", "table": "mb_demo_drone", "limit": 5000, "metrics": [ { "metric": "mb_demo_mt_altitude", "transforms": [ { "name": "label", "arg": "Series Timestamp Values" }, { "name": "collect" }, { "name": "avg" }, { "name": "label", "arg": "Average Timestamp Values" } ] } ] } | | constrainValues | 지정된 범위 밖의 값을 해당하는 최대값 또는 최소값으로 바꿉니다. 예를 들어 다음을 지정한 경우 변환은 0보다 작은 값을 0으로 바꾸고 100보다 큰 값은 100으로 바꿉니다. "transforms": [ { "name": "constrainValues", "val1": 0, "val2": 100 } ] 인수: * val1(10진수 데이터 유형): 최소값 또는 최대값입니다. * val2(10진수 데이터 형식): 최소값 또는 최대값입니다. {#clotho-POST-clotho-transform__ul_uhk_nc1_rlb} | | 카운트 | 시계열을 하나의 계열로 집계합니다. 새 계열에는 계열의 각 해당 타임스탬프에 대해 NaN(숫자가 아님)이 아닌 값의 수가 포함됩니다. | | 파생 | 타임스탬프 간의 변경 비율을 결정합니다. 각 타임스탬프의 값과 다음 타임스탬프의 값 간의 차이를 타임스탬프의 기간으로 나눕니다. 주: 이 변환은 시계열의 값 수보다 하나 적은 값을 반환합니다. | | div | 각 타임스탬프의 값을 지정된 숫자(인수)로 나눕니다. 인수: arg(10진수 -- 각 타임스탬프의 값을 나눌 숫자입니다. | | 봉투 | 두 개의 시계열을 반환합니다. 여기서 어느 시점에서든 하나는 가장 큰 값을 포함하고 다른 하나는 가장 작은 값을 포함합니다. 주: NaN은 무시되지만 다른 반환 값이 없는 경우 반환됩니다. | | 경험 | 지정된 기준의 값을 각 타임스탬프의 값의 거듭제곱으로 올립니다. 인수: arg(10진수 데이터 형식) - 기준값입니다. | | 필터 | 이동 평균 생성과 같은 슬라이딩 창의 내용에 집계를 적용합니다. 인수: * 집계(집계기 데이터 유형): 수행할 집계의 유형입니다. * window(기간 데이터 유형): 슬라이딩 창의 기간입니다. {#clotho-POST-clotho-transform__ul_bzw_bpm_vlb} | | 층 | 각 타임스탬프의 값을 지정된 정밀도(`floor(value / ) * `로 내림합니다. 인수: arg(10진수 데이터 형식) -- 반올림할 10진수 정밀도입니다. | | 균열 | 지정된 배열의 각 분수에 대한 시계열을 반환합니다. 각 타임스탬프 값은 입력 계열의 해당 타임스탬프에 대해 지정된 값의 분수가 지정된 백분율보다 낮은 값입니다. 예를 들어 분수가 0.5이면 타임스탬프의 값은 입력 계열의 값 중 절반이 0.5 미만인 값입니다. 인수: arg(10진수 배열) -- 입력 계열에 사용할 분수입니다. 예: "transforms": [ { "name": "fractiles", "arg": [0.25, 0.5, 0.75, 1] } ] | | 그룹 기준 | 집계된 변환을 수집하거나 적용하기 전에 지정된 필드별로 데이터를 그룹화합니다. 인수: arg(문자열) - 변환 결과를 그룹화하는 데 사용할 테이블의 쉼표로 구분된 필드 목록입니다. 예: "transforms": [ { "name": "groupBy", "arg": "model" }, { "name": "avg" }, { "name": "label", "arg": "Model: %g" } ] | | 통합 | 각 타임스탬프의 값에 해당 기간을 곱합니다. | | 보간 | 인접한 데이터 값에서 보간하여 NaN 데이터 항목에 대한 데이터 값을 생성합니다. 인수: arg(정수) -- NaN이 아닌 값을 확인하기 위한 각 방향의 데이터 샘플 수입니다. NaN이 아닌 값을 찾을 수 없으면 NaN이 사용됩니다. | | 반전 | 각 타임스탬프 값의 역수를 계산합니다. | | IQR | 사분위수 범위 변환을 수행하고 다음 4개의 계열이 포함된 결과 집합을 만듭니다. 1. -IQR: `Q1 - (1.5 * IQR)` 미만의 모든 항목의 중앙값입니다. 2. Q1: 항목의 가장 작은 절반의 중앙값입니다. 3. Q3: 항목의 가장 큰 절반의 중앙값입니다. 4. +IQR: `Q3 + (1.5 * IQR)` 이상의 모든 항목의 중앙값입니다. {#clotho-POST-clotho-transform__ol_itt_vsm_vlb} 주: `IQR = Q3 - Q1` | | 레이블 | 변환 체인에 레이블을 지정합니다. 주: 후속 변환에서 레이블을 수정하거나 바꿀 수 있습니다. 인수: arg(문자열) - 레이블의 텍스트입니다. 다음 서식 표현식을 포함할 수 있습니다. * %%: "%" 리터럴을 이스케이프합니다. * %l: 대체 중인 현재 레이블. * %s: 시리즈 제목입니다. * %g: 필드별 그룹의 값입니다. 이것이 참조된 기록이면 기록의 이름 필드 값입니다. 변환에 groupBy 여러 그룹이 지정된 경우 레이블은 쉼표로 구분됩니다. * %G: 필드별 그룹의 값입니다. 이것이 참조된 기록이면 기록의 sys_id입니다. 여러 그룹을 선택하면 값이 쉼표로 구분됩니다. {#clotho-POST-clotho-transform__ul_v34_ptm_vlb} 예: "transforms": [ { "name": "label", "arg": "Series Timestamp Values" }, ] "transforms": [ { "name": "groupBy", "arg": "model" }, { "name": "avg" }, { "name": "label", "arg": "Model: %g" } ] | | 제한 | 가장 최근에 저장된 값부터 시작하여 최대 지정된 기간 또는 값 수를 반환합니다. 인수: * arg(정수): 각 시계열에 대해 반환할 타임스탬프 값의 수입니다.또는 * arg(기간 데이터 유형): 각 시계열을 제한하는 기간입니다. {#clotho-POST-clotho-transform__ul_dx1_ndr_vlb} | | log | 각 타임스탬프의 값에 대해 로그를 실행하며, 결과는 타임스탬프 값에 대해 지정된 기준의 로그입니다. 인수: arg(10진수 데이터 형식) - 로그 계산의 기준입니다. | | 맵값 | 지정된 범위(포함) 내의 모든 값을 지정된 값으로 바꿉니다. 와 upperBound 둘 다 lowerBound NaN으로 지정되면 NaN 값을 .targetValue 인수: * lowerBound(10진수 데이터 형식): 범위의 가장 낮은 값입니다. * upperBound(10진수 데이터 형식): 범위에서 가장 높은 값입니다. * targetValue(10진수 데이터 유형): 대체 값입니다. {#clotho-POST-clotho-transform__ul_gjm_3fr_vlb} 예를 들어, 다음은 .1에서 .9 사이의 시계열의 모든 값을 1로 변경합니다. "transforms": [ { "name": "mapValues", "lowerBound": .1, "upperBound": .9, "targetValue": 1 } ] | | 최대 | 입력 전체에서 각 해당 타임스탬프의 최대값을 포함하는 계열을 반환합니다. | | 중위값 | 계열 집합의 각 타임스탬프에 대한 값의 중앙값을 포함하는 계열을 만듭니다. `n` 계열이 있는 경우: * `n`이 홀수이면 중앙값은 타임스탬프의 `(n / 2 + 1)` 값입니다. * `n`이 짝수이면 중앙값은 타임스탬프에 대한 `(n/2)` 및 `(n/2 + 1)` 값의 평균입니다. {#clotho-POST-clotho-transform__ul_hd5_yfr_zlb} | | 최소 | 입력 전체에서 각 해당 타임스탬프의 최소값을 포함하는 계열을 반환합니다. | | 물 | 각 타임스탬프의 값에 지정된 숫자를 곱합니다. 인수: arg(10진수 데이터 형식) - 각 타임스탬프의 값을 곱할 숫자입니다. | | 파티션 | 지정된 집계기를 겹치지 않는 창에 적용하여 필터링된 값으로 새 계열을 작성합니다. 인수: * 집계(집계기 데이터 유형): 수행할 집계의 유형입니다. * base(DateTime 데이터 형식): 파티셔닝에 사용할 0 오프셋입니다. 예를 들어 일(24시간)별로 분할하려면 이 값을 시간대의 월요일 자정으로 설정합니다. 30일 기간으로 분할하려면 이 값을 최근 달의 첫 번째 날로 설정합니다.기본값: EPOCH의 시작. * window(기간 데이터 유형): 집계기를 적용할 겹치지 않는 기간입니다. {#clotho-POST-clotho-transform__ul_fzj_2kr_vlb} | | 포우 | 각 타임스탬프 값을 지정된 검정력으로 올립니다. 인수: arg(10진수 데이터 유형) -- 각 값을 올릴 거듭제곱입니다. | | 제품 | 선택한 메트릭 계열을 각 타임스탬프에 대한 모든 값의 곱을 포함하는 단일 계열로 집계합니다. NaN은 제외됩니다. 시계열의 모든 숫자가 NaN이면 출력도 NaN입니다. | | 리샘플링 | 시계열을 고정된 지점 수 또는 한 빈도에서 다른 빈도로 리샘플링합니다. 리샘플링 변환을 사용하여 결과 세트의 샘플 수를 줄여 표시할 샘플 수와 더 근접하게 일치시킵니다. 인수: 이 변환에 대해 다양한 인수를 전달할 수 있습니다. 다음은 가능한 각 인수 그룹 목록입니다. 이러한 인수 그룹 중 하나만 단일 변환 내에 전달할 수 있습니다. 다음 인수 그룹은 AND/OR로 구분됩니다. AND 인수가 현재 그룹의 일부임을 의미합니다. OR은 새 인수 그룹의 시작임을 의미합니다. * 인수(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * arg(기간 데이터 유형): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다.및 * maxValues(정수): 결과 집합에 포함할 최대 샘플 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * 값(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다. 또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * 기간(기간 데이터 유형): 다시 샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다. 또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다.및 * maxValues(정수): 결과 집합에 포함할 최대 샘플 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다. {#clotho-POST-clotho-transform__ul_kc4_n4w_wlb} | | 라운드 | 각 타임스탬프의 값을 지정된 정밀도(`(값/) * `)로 반올림합니다. 인수: arg(10진수 데이터 형식) -- 반올림할 10진수 정밀도입니다. | | 근본 | 지정된 인덱스를 사용하여 각 타임스탬프 값의 루트를 계산합니다. 인수: arg(10진수 데이터 형식) - 루트의 인덱스입니다. 예를 들어, 다음은 각 타임스탬프의 제곱근을 반환합니다. "transforms": [ { "name": "root", "arg": "2" }, ] | | 표준 개발 | 계열 집합의 각 타임스탬프에 대한 값의 표준 편차를 포함하는 계열을 만듭니다. | | 하위 | 각 타임스탬프의 값에서 지정된 숫자를 뺍니다. 인수: arg(숫자) -- 각 타임스탬프의 값에서 뺄 숫자입니다. | | 합계 | 선택한 메트릭 계열을 NaN을 제외하고 각 타임스탬프에 대한 모든 값의 합계를 포함하는 하나의 계열로 집계합니다. 시계열의 모든 숫자가 NaN이면 출력은 NaN입니다. | | 타임 시프트 | 값을 수정하지 않고 값의 타임스탬프에 지정된 오프셋을 추가하여 시간 범위를 이동합니다. 이 변환을 사용하여 타임스탬프를 다른 시간대로 이동합니다. 인수: arg(기간 데이터 유형) -- 이동할 시간입니다. | | 상위 | 가장 높은 값을 가진 지정된 수의 계열을 반환합니다. 인수: arg(정수) -- 반환할 계열 수입니다. 예를 들어, 다음은 가장 높은 값 집합을 포함하는 두 시계열을 반환합니다. "transforms": [ { "name": "top", "arg": 2 } ] | [표 25. 데이터 유형 변환] {#clotho-POST-clotho-transform__id_abm_vgl_2tb} {#clotho-POST-clotho-transform__id_uq3_hhl_2tb__entry__2}{#clotho-POST-clotho-transform__Aggregator}{#clotho-POST-clotho-transform__DateTime}{#clotho-POST-clotho-transform__Decimal}{#clotho-POST-clotho-transform__Duration} | 데이터 유형 | 설명 | |-|-| | 집계 | 변환 내에서 사용할 수 있는 집계기입니다. * 평균: 현재 선택된 모든 계열의 산술 평균을 계산합니다. * CHISQUARE: 통계 모델이 메트릭 데이터 세트에 얼마나 잘 맞는지 보여줍니다. * LAST: 기간 창에서 마지막으로 정의된 값을 반환합니다. * 최대값: 각 시점의 메트릭 데이터 세트의 가장 큰 값을 표시합니다. * MEDIAN: 메트릭 데이터 세트의 중앙값을 표시합니다. 중앙값은 메트릭 데이터 세트의 높은 값과 낮은 값을 구분합니다. * 최소값: 각 시점의 메트릭 데이터 세트에 대한 가장 작은 값을 표시합니다. * STDDEV: 기본 데이터의 표준 편차를 계산합니다. 메트릭 데이터 세트에서 데이터 값 집합의 변동 또는 분산을 정량화하는 데 사용됩니다. * SUM: 현재 선택된 모든 계열의 합계를 계산합니다. {#clotho-POST-clotho-transform__ul_ssr_nrb_xlb} | | 날짜/시간 | 절대 날짜/시간 값은 ISO 8601 날짜 및 시간 형식( `YYYY-MM-DDThh:mm:ss`)으로 지정됩니다. 예: 2020-02-28T13:10:42. 위치: * \[YYYY\]: 4자리 연도입니다. * \[MM\]: 01에서 12 사이의 0패딩 월입니다. * \[DD\]: 01에서 31 사이의 제로 패딩 날짜입니다. * T: 시간을 나타내며 시간 구성요소를 지정하기 전에 필수입니다. * \[hh\]: 00에서 23 사이의 채워진 0시간 * \[mm\]: 00에서 59 사이의 0패딩 시간(분)입니다. * \[ss\]: 00에서 59 사이의 0으로 채워진 초. 윤초는 이전 1,000초에 걸쳐 균등하게 분포됩니다. {#clotho-POST-clotho-transform__ul_hnf_zsb_xlb} 상대 날짜/시간은 현재 시간에서 제한 기간(기간 데이터 유형)을 사용하여 지정됩니다. 예: P7D = 7일 전. | | 10진수 | 10진수 값은 다음 중 하나일 수 있습니다. * 지수 표기법을 사용할 수 있는 임의 정밀도의 부호 있는 10진수입니다.예: * 2 * 1.7 * -3.47 * 1.0E+2 {#clotho-POST-clotho-transform__ul_e5c_v5b_xlb} * 문자열 표현: * 지수 표기법을 사용할 수 있으며 배정밀도 64비트 IEEE 754 부동 소수점 숫자로 보장되는 부호 있는 10진수입니다. * "나엔" * "-무한대" * "+무한대" {#clotho-POST-clotho-transform__ul_vty_z5b_xlb} {#clotho-POST-clotho-transform__ul_rvb_55b_xlb} | | 지속 시간 | 시간 간격의 시간량입니다. 지속 시간 값은 ISO 8601 지속 시간 형식(`P[n]Y[n]M[n]DT[n]H[n]M[n]S)`으로 지정됩니다. 위치: * P: "마침표"라고 하는 기간 지정자이며 항상 기간의 시작 부분에 배치됩니다. * \[n\]Y: 연수입니다. * \[n\]M: 개월 수. * \[n\]D: 날짜 수. * T: 시간 지정자이며 시간 구성요소를 지정하기 전에 필수입니다. * \[n\]H: 시간 수. * \[n\]M: 분 수입니다. * \[n\]S: 초 수입니다. {#clotho-POST-clotho-transform__ul_ilt_tzb_xlb} 예: * P7D: 7일 기간. * P1M: 1개월의 기간입니다. * PT15M: 15분의 기간. * P1DT12H: 1일 12시간의 기간입니다. {#clotho-POST-clotho-transform__ul_vbf_l1c_xlb} | [ ] {#clotho-POST-clotho-transform__id_uq3_hhl_2tb} ### cURL 요청 curl "https://instance.servicenow.com/api/now/v1/clotho/transform \ --request POST \ --header "Accept:application/json", "Content-Type:application/json" \ --user "username":"password" -d {\ "start": "PT15M",\ "end": "",\ "table": "mb_demo_drone",\ "query": "fleet.nameSTARTSWITHB",\ "limit": 5000,\ "metrics": [\ {\ "metric": "mb_demo_mt_altitude",\ "label": "Series - Avg",\ "transforms": [\ {\ "name": "partition",\ "arg": {\ "aggregator": "AVG",\ "window": "PT5M"\ }\ }, {\ "name": "avg"\ }\ ]\ }, {\ "metric": "mb_demo_mt_altitude",\ "groupBy": "fleet",\ "label": "Fleet - AVG",\ "transforms": [\ {\ "name": "partition",\ "arg": {\ "aggregator": "AVG",\ "window": "PT5M"\ }\ }, {\ "name": "avg"\ }\ ]\ }\ ]\ } \ 출력: "results:" [ { "marker": "674d86ba-a810-4065-942b-0b7ca2f95db2", "series": [ { "label": "Series - Avg", "values": [ { "timestamp": "2020-05-01T21:05:00Z", "value": 157.43086 }, { "timestamp": "2020-05-01T21:10:00Z", "value": 162.92278 } ] } ] }, { "marker": "846aa334-232a-4015-b033-d18ebc4b1d23", "grouped": [ { "groupingBy": "fleet", "groups": [ { "group": "86fac11787333200a328c5b836cb0b4e", "label": "Bantams", "series": { "label": "Fleet - AVG", "values": [ { "timestamp": "2020-05-01T21:05:00Z", "value": 159.70201 }, { "timestamp": "2020-05-01T21:10:00Z", "value": 165.1136 } ] } }, { "group": "4afac11787333200a328c5b836cb0b4e", "label": "Bumble Untd", "series": { "label": "Fleet - AVG", "values": [ { "timestamp": "2020-05-01T21:05:00Z", "value": 154.5403 }, { "timestamp": "2020-05-01T21:10:00Z", "value": 160.13445 } ] } } ] } ] } ] ## MetricBase 시계열 - POST /now/clotho/transform/stream {#ariaid-title6} 지정된 변환 목록을 적용한 후 하나 이상의 메트릭에 대해 변환된 시계열 데이터 스트림을 반환합니다. 이러한 방식으로 데이터를 스트리밍하면 모든 변환 결과가 완료되고 다운로드될 때까지 기다리지 않고 개별 변환이 완료되고 반환될 때 데이터를 처리할 수 있습니다. 클라이언트에서 많은 양의 데이터를 처리해야 하는 경우 이러한 유형의 처리는 엔드 투 엔드 처리 시간을 줄이고 잠재적으로 클라이언트의 메모리 사용량을 줄입니다. 요청에 해당하는 수락 헤더 값을 설정하여 다음을 수행할 수 있습니다. * 이진 형식으로 인코딩할 스트리밍 데이터를 지정합니다. * 스트리밍된 데이터를 JSON 배열로 직렬화하거나 * 데이터를 넓거나 좁은 CSV 형식으로 클라이언트로 다시 스트리밍합니다. {#clotho-POST-clotho-transform-stream__ul_nxv_dsy_wvb}엔드포인트는 그룹화나 미리 결정된 순서 없이 서버에서 변환이 완료 MetricBase 될 때 데이터를 스트리밍합니다. 이진 형식으로 스트리밍되는 데이터는 엔드포인트에서 반환하는 JSON 표현보다 크기가 [MetricBase 시계열 - POST /now/clotho/transform](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform "선형 파이프라인을 형성하는 지정된 변환 목록을 적용한 후 하나 이상의 메트릭에 대한 시계열 데이터를 검색하고 선택적으로 그룹화합니다.") 작습니다. ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/transform/stream ### 지원되는 요청 매개변수 {#clotho-POST-clotho-transform-stream__entry__2}{#clotho-POST-clotho-transform-stream__version-not_optional-RESTAPI} | 이름 | 설명 | |-|-| | api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 | [표 26. 경로 매개변수] {#clotho-POST-clotho-transform-stream__entry__6}{#clotho-POST-clotho-transform-stream__entry-sysparm_display_value-metricbase} | 이름 | 설명 | |-|-| | sysparm_display_value | 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 결과 데이터에 주체 기록 표시 값으로 레이블이 지정됩니다. * 아니오: 결과 데이터에 제목 기록 표시 값 레이블이 지정되지 않았습니다. {#clotho-POST-clotho-transform-stream__ul_mgs_vzy_tkb} 데이터 유형: 부울 기본값: false | [표 27. 쿼리 매개변수] {#clotho-POST-clotho-transform-stream__entry__10} | 이름 | 설명 | |-|-| | 끝 | 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다. 시간 값에는 이 종료 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\]입니다( `예: 2019-03-20T17:04:55`). * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-POST-clotho-transform-stream__ul_nxc_f5f_rlb} | | 제한 | 반환할 최대 기록 수입니다. 이례적으로 큰 값은 시스템 성능에 영향을 줄 수 있습니다. 데이터 유형: 숫자 기본값: 10,000 | | 메트릭 | 변환에 사용할 메트릭 객체의 목록입니다. 메트릭에 대한 자세한 내용은 [메트릭을 참조하십시오.](https://www.servicenow.com/docs/access?context=c_MetricDefinitionSupport&version=australia&pubname=australia-platform-administration&ft:locale=en-US) 데이터 유형: 배열 "metrics": [ { "label": "String", "metric": "String", "transforms": [Array] } ] | | metrics.label | 이 메트릭의 결과 세트에 사용할 레이블입니다. 변환 체인에서 생성된 모든 레이블을 대체합니다. 데이터 유형: 문자열 기본값: 생성된 기본 레이블. | | metrics.metric | 객체가 전달되면 필수 metrics 입니다. 변환에 사용할 메트릭 필드입니다. 이 필드는 매개변수에 table 지정된 테이블에 있어야 합니다. 데이터 유형: 문자열 | | metrics.transforms | 검색된 시계열 데이터에 적용할 변환(변환 체인) 목록입니다. 각 변환은 이전 변환의 결과를 기반으로 빌드됩니다. 사용 가능한 변환 목록은 아래에서 [지원되는 변환을 참조하십시오.](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 데이터 유형: 객체 배열 "transforms": [ { "arg": {Object}, "name": "String" } ] | | metrics.transforms.arg | 변환에 따라 다릅니다. 변환에 전달할 매개변수입니다. 일반 가이드라인: * 매개변수를 사용하지 않는 변환을 지정할 때는 이 arg 매개변수를 사용하지 마십시오. * 단일 매개변수를 사용하는 변환에는 숫자, 문자열 또는 부울을 사용합니다. * 둘 이상의 매개변수를 사용하는 변환에는 적절한 이름-값 쌍과 함께 JSON 객체를 사용합니다. {#clotho-POST-clotho-transform-stream__ul_grw_jrs_qlb} 데이터 유형: 변환에 따라 숫자, 문자열, 부울 또는 JSON 객체. (사용 가능한 변환 목록은 아래 [지원되는 변환](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 테이블을 참조하십시오.) | | metrics.transforms.name | 객체가 transforms 지정된 경우 필요합니다. 변환의 이름입니다. 사용 가능한 변환 목록은 아래 [지원되는 변환 테이블을 참조하십시오.](https://servicenow-prod.fluidtopics.net/FEQHxmriabjNojxYT5gdQg#clotho-POST-clotho-transform__Supported_transforms) 데이터 유형: 문자열 | | 쿼리 | 결과 세트를 필터링하는 데 사용할 인코딩된 쿼리입니다. 지정된 테이블의 필터 편집기를 사용하여 쿼리를 작성할 수 있습니다. 생성이 완료되면 필터의 이동 경로 컨텍스트 메뉴에서 URL 복사 를 선택합니다. 데이터 유형: 문자열 기본값: 없음 | | 시작 | 필수 평가 기간의 시작 시간입니다. 특수 값 `all` 을 사용하여 시작 시간을 현재 시간에서 지정된 메트릭의 최대 보존 기간을 뺀 값으로 설정할 수 있습니다. 비어 있거나 누락된 값은 암시적 `모두`로 처리됩니다. 시간 값에는 이 시작 시간이 포함됩니다. 데이터 유형: 문자열 형식: ISO 8601(UTC), 다음 중 하나입니다. * 절대 날짜 형식 \[YYYY-MM-DDThh:mm:ss\] (`예: 2019-03-20T17:04:55`) * 현재 기간 형식` [P(n)Y(n)M(n)DT(n)H(n)M(n)S]`를 기준으로 합니다( `예: P1M`). {#clotho-POST-clotho-transform-stream__ul_wzt_ntf_rlb} | | 테이블 | 필수 이 계열과 연결된 GlideRecord가 들어 있는 테이블의 이름입니다. 데이터 유형: 문자열 | [표 28. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-transform-stream__entry__34}{#clotho-POST-clotho-transform-stream__accept-JSON-only-entry-RESTAPI}{#clotho-POST-clotho-transform-stream__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. 다음을 지원합니다. * application/json * application/octet-stream 또는 * text/csv {#clotho-POST-clotho-transform-stream__ul_py2_wsy_wvb} CSV 형식을 지정하려면 `text/csv를 사용합니다. format=narrow` 또는 `text/csv; format=wide입니다`. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 29. 요청 헤더] {#clotho-POST-clotho-transform-stream__entry__40} | 머리글 | 설명 | |-|-| | 없음 | 응답 본문의 데이터 형식입니다. 요청의 지정된 수락 값에 따라 다음을 사용합니다. * application/json * application/octet-stream 또는 * text/csv {#clotho-POST-clotho-transform-stream__ul_t1z_1ty_wvb} 여러 수락 유형을 지정하면 지원되는 첫 번째 유형이 반환됩니다. | [표 30. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-clotho-transform-stream__entry__44}{#clotho-POST-clotho-transform-stream__entry-200-status-code}{#clotho-POST-clotho-transform-stream__entry-400-status-code}{#clotho-POST-clotho-transform-stream__entry-401-status-code}{#clotho-POST-clotho-transform-stream__entry-404-status-code}{#clotho-POST-clotho-transform-stream__entry-405-status-code}{#clotho-POST-clotho-transform-stream__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었으며 데이터 스트리밍이 시작됩니다. 주: 200 응답은 변환이 계산되는 동안 여전히 중간에 처리 오류가 발생할 수 있습니다. | | 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. | | 405 | 잘못된 메서드입니다. 기능이 비활성화되었습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 31. 상태 코드] ### 응답 본문 매개변수(Octet-스트림 또는 JSON) {#clotho-POST-clotho-transform-stream__entry__58} | 이름 | 설명 | |-|-| | 출력 스트림(옥텟 스트림) | 요청 수락 헤더가 로 설정된 application/octet-stream경우 일치하는 MetricBase 데이터가 이진 직렬화된 스트림으로 반환됩니다. Clotho-Util for Java 애플리케이션은 이 데이터를 구문 분석할 수 있는 역직렬 변환기를 제공합니다. 스트림은 각 데이터의 이진 직렬화로 구성되며, 그 앞에는 길이를 나타내는 정수가 옵니다. 다음 항목은 이진 표현 내의 데이터와 해당 데이터의 순서를 설명합니다. | | CSV 스트림(UTF-8 스트림) | 요청 수락 헤더가 로 설정된 text/csv경우 일치하는 MetricBase 데이터는 넓은 형식 또는 좁은 형식의 UTF-8로 인코딩된 CSV 데이터로 반환됩니다. 좁은 형식은 반환된 각 메트릭에 대해 주제 및 타임스탬프 열과 열을 반환합니다. 와이드 형식은 각 메트릭-주제 쌍에 대해 별도의 열이 있는 타임 스탬프 열을 반환합니다. | | 제목 | 데이터의 소스입니다. 예를 들어 데이터에 대한 메트릭이 드론 고도인 경우 이 값은 특정 드론의 ID일 수 있습니다. 콜론이 값에 포함되면 제목 뒤의 부분은 데이터가 속한 메트릭을 나타냅니다. null 값은 인코딩된 빈 문자열로 표시됩니다. 데이터 유형: 문자열(Java 수정 UTF) 크기: 2+ 바이트 | | 크기 | 데이터의 출처 메트릭입니다. null 값은 인코딩된 빈 문자열로 표시됩니다. 데이터 유형: 문자열(Java 수정 UTF) 크기: 2+ 바이트 | | 레이블 | 데이터의 레이블입니다. null 값은 인코딩된 빈 문자열로 표시됩니다. 데이터 유형: 문자열(Java 수정 UTF) 크기: 2+ 바이트 | | 유형 | 바이트로 인코딩된 데이터의 유형입니다. 가능한 값: * 부동 모드 * 부동 신호 * 더블 모델 * 이중 신호 데이터 유형: 바이트 크기: 1바이트 | | 플래그 | 인코딩된 serializeFlags 변수. 예이고 serializeTags 데이터에 태그가 포함되어 있으면 값은 2이고 그렇지 않으면 0입니다. 데이터 유형: 바이트 크기: 1바이트 | | 기간 | 데이터와 연결된 기간입니다. 데이터 유형: 숫자(정수) 크기: 4바이트 | | 태그 수 | 예일 경우 serializeTags 데이터에 저장된 태그 수입니다. 데이터 유형: 숫자(정수) 크기: 4바이트 | | 태그 | 예일 경우 serializeTags 각 태그가 데이터에 저장됩니다. 데이터 유형: 문자열(Java 수정 UTF) 크기: 태그 수(2+ 바이트)에 따라 다릅니다. | | 시작 에포크 초 | 이 데이터 계열의 시작 시간을 나타내는 Epoch UTC 시간입니다. 데이터 유형: 숫자(길게) 크기: 8바이트 | | 값 수 | 이 데이터에 저장된 값의 수입니다. 데이터 유형: 숫자(정수) 크기: 4바이트 | | 값 | 부동 신호인 경우 Type 나머지는 부동 소수점 값으로 구성됩니다. 크기 : Number of Values \* 4 데이터 유형: 숫자(부동) | | 값 | 이(가) 이중 신호인 경우 Type 나머지는 이중 값으로 구성됩니다. 데이터 유형: 번호(이중) 크기: Number of Values \* 4바이트 | | 모델 json(모델) | 부동 모델 또는 이중 모델인 경우 Type 나머지는 모델을 JSON으로 나타내는 Java 수정 UTF 문자열입니다. 데이터 유형: 문자열(Java 수정 UTF) 크기: 2+ 바이트 | | 큰 모델 마커(큰 모델) | 모델의 JSON 길이가 65,535바이트보다 크면 이 필드가 대신 Model Json작성됩니다. 데이터 유형: 문자열(Java 수정 UTF) 사이즈: 5 | | 큰 모델 크기(큰 모델) | 큰 모델의 JSON 표현의 길이입니다. 데이터 유형: 숫자(정수) 크기: 4바이트 | | 빅 모델 JSON(빅 모델) | 일련의 UTF 문자로 모델을 JSON 표현으로, 크기는 필드에 따라 Big Model Size 결정됩니다. 데이터 유형: 문자열(UTF 문자) 크기: 65535-256000바이트 | | JSON 스트림(JSON) | 요청 수락 헤더가 로 application/json설정된 경우 일치하는 MetricBase 데이터는 줄 바꿈으로 구분된 JSON 객체의 스트림으로 반환됩니다. 다음 항목에서는 반환된 각 객체에서 가능한 요소를 설명합니다. | | 레이블 | 데이터의 레이블입니다. 이 값은 엔드포인트에 의해 생성되거나 매개변수에 전달된 값입니다 metrics.label . 데이터 유형: 문자열 | | 기간 | 각 값 사이의 시간입니다. 예를 들어, 기간이 60이면 각 값이 1분 간격이라는 것을 의미합니다. 데이터 유형: 숫자 단위: 초 | | 범위 | 데이터의 시작 및 종료 시간 데이터 유형: 배열 형식: ISO 8601(UTC) | | 시리즈 | 개별 데이터를 식별합니다. 존재하는 경우 일반적으로 `[Glide 기록 ID]:[메트릭]` 형식입니다. 변환을 사용할 때는 나타나지 않을 수 있습니다. 데이터 유형: 문자열 | | 종 | 반환 데이터의 유형입니다. 부동 소수점 또는 이중 값의 연속의 경우 이는 FLOAT_SIGNAL 또는 DOUBLE_SIGNAL입니다. 부동 또는 이중 데이터를 분석하기 위한 모델의 경우 이는 FLOAT_MODEL 또는 DOUBLE_MODEL입니다. 데이터 유형: 문자열 | | 태그 | 데이터와 연결된 태그입니다. 데이터 유형: 문자열 배열 | | 값 | 데이터에 대한 부동 소수점 또는 이중 값입니다. 데이터 유형: 숫자 배열 | | 오류 | 지정된 데이터 계열의 변환이 실패할 경우의 오류 메시지입니다. 데이터 유형: 문자열 | [ ] ### 지원되는 변환 {#clotho-POST-clotho-transform-stream__Supported_transforms} {#clotho-POST-clotho-transform-stream__id_abm_vgl_2tb__entry__2}{#clotho-POST-clotho-transform-stream__version-row-RESTAPI} | 변환 | 설명 | |-|-| | add | 각 타임스탬프 값에 지정된 숫자를 추가합니다. 인수: arg(10진수 데이터 유형) - 더할 숫자입니다. 예: "transforms": [ { "name": "add", "arg": 8 } ] | | 자동 상관 관계 | 1부터 시작하는 증가하는 기간 수로 구분된 타임스탬프 값 간의 상관 관계를 계산합니다. | | 평균 | 입력 전체에서 각 해당 타임스탬프의 평균 값을 포함하는 시계열을 하나의 계열로 시계열을 집계합니다. | | 하단 | 가장 낮은 값을 가진 지정된 수의 계열을 반환합니다. 인수: arg (정수) -- 반환할 계열 수입니다. 예를 들어, 다음은 가장 낮은 값 집합을 포함하는 두 시계열을 반환합니다. "transforms": [ { "name": "bottom", "arg": 2 } ] | | 씨일 | 각 타임스탬프의 값을 지정된 정밀도(`ceil(value / ) * )`로 반올림합니다. 인수: arg(10진수 데이터 유형) - 반올림할 10진수 정밀도입니다. | | 수집 | 변환 호출 수집 지점까지 변환 체인의 변환 결과를 표시합니다. 변환 결과 수집에는 고유한 마커가 포함되어 있지만 레이블을 정의할 수도 있습니다. 예: { "start": "PT1H", "end": "", "table": "mb_demo_drone", "limit": 5000, "metrics": [ { "metric": "mb_demo_mt_altitude", "transforms": [ { "name": "label", "arg": "Series Timestamp Values" }, { "name": "collect" }, { "name": "avg" }, { "name": "label", "arg": "Average Timestamp Values" } ] } ] } | | constrainValues | 지정된 범위 밖의 값을 해당하는 최대값 또는 최소값으로 바꿉니다. 예를 들어 다음을 지정한 경우 변환은 0보다 작은 값을 0으로 바꾸고 100보다 큰 값은 100으로 바꿉니다. "transforms": [ { "name": "constrainValues", "val1": 0, "val2": 100 } ] 인수: * val1(10진수 데이터 유형): 최소값 또는 최대값입니다. * val2(10진수 데이터 형식): 최소값 또는 최대값입니다. {#clotho-POST-clotho-transform-stream__ul_uhk_nc1_rlb} | | 카운트 | 시계열을 하나의 계열로 집계합니다. 새 계열에는 계열의 각 해당 타임스탬프에 대해 NaN(숫자가 아님)이 아닌 값의 수가 포함됩니다. | | 파생 | 타임스탬프 간의 변경 비율을 결정합니다. 각 타임스탬프의 값과 다음 타임스탬프의 값 간의 차이를 타임스탬프의 기간으로 나눕니다. 주: 이 변환은 시계열의 값 수보다 하나 적은 값을 반환합니다. | | div | 각 타임스탬프의 값을 지정된 숫자(인수)로 나눕니다. 인수: arg(10진수 -- 각 타임스탬프의 값을 나눌 숫자입니다. | | 봉투 | 두 개의 시계열을 반환합니다. 여기서 어느 시점에서든 하나는 가장 큰 값을 포함하고 다른 하나는 가장 작은 값을 포함합니다. 주: NaN은 무시되지만 다른 반환 값이 없는 경우 반환됩니다. | | 경험 | 지정된 기준의 값을 각 타임스탬프의 값의 거듭제곱으로 올립니다. 인수: arg(10진수 데이터 형식) - 기준값입니다. | | 필터 | 이동 평균 생성과 같은 슬라이딩 창의 내용에 집계를 적용합니다. 인수: * 집계(집계기 데이터 유형): 수행할 집계의 유형입니다. * window(기간 데이터 유형): 슬라이딩 창의 기간입니다. {#clotho-POST-clotho-transform-stream__ul_bzw_bpm_vlb} | | 층 | 각 타임스탬프의 값을 지정된 정밀도(`floor(value / ) * `로 내림합니다. 인수: arg(10진수 데이터 형식) -- 반올림할 10진수 정밀도입니다. | | 균열 | 지정된 배열의 각 분수에 대한 시계열을 반환합니다. 각 타임스탬프 값은 입력 계열의 해당 타임스탬프에 대해 지정된 값의 분수가 지정된 백분율보다 낮은 값입니다. 예를 들어 분수가 0.5이면 타임스탬프의 값은 입력 계열의 값 중 절반이 0.5 미만인 값입니다. 인수: arg(10진수 배열) -- 입력 계열에 사용할 분수입니다. 예: "transforms": [ { "name": "fractiles", "arg": [0.25, 0.5, 0.75, 1] } ] | | 그룹 기준 | 집계된 변환을 수집하거나 적용하기 전에 지정된 필드별로 데이터를 그룹화합니다. 인수: arg(문자열) - 변환 결과를 그룹화하는 데 사용할 테이블의 쉼표로 구분된 필드 목록입니다. 예: "transforms": [ { "name": "groupBy", "arg": "model" }, { "name": "avg" }, { "name": "label", "arg": "Model: %g" } ] | | 통합 | 각 타임스탬프의 값에 해당 기간을 곱합니다. | | 보간 | 인접한 데이터 값에서 보간하여 NaN 데이터 항목에 대한 데이터 값을 생성합니다. 인수: arg(정수) -- NaN이 아닌 값을 확인하기 위한 각 방향의 데이터 샘플 수입니다. NaN이 아닌 값을 찾을 수 없으면 NaN이 사용됩니다. | | 반전 | 각 타임스탬프 값의 역수를 계산합니다. | | IQR | 사분위수 범위 변환을 수행하고 다음 4개의 계열이 포함된 결과 집합을 만듭니다. 1. -IQR: `Q1 - (1.5 * IQR)` 미만의 모든 항목의 중앙값입니다. 2. Q1: 항목의 가장 작은 절반의 중앙값입니다. 3. Q3: 항목의 가장 큰 절반의 중앙값입니다. 4. +IQR: `Q3 + (1.5 * IQR)` 이상의 모든 항목의 중앙값입니다. {#clotho-POST-clotho-transform-stream__ol_itt_vsm_vlb} 주: `IQR = Q3 - Q1` | | 레이블 | 변환 체인에 레이블을 지정합니다. 주: 후속 변환에서 레이블을 수정하거나 바꿀 수 있습니다. 인수: arg(문자열) - 레이블의 텍스트입니다. 다음 서식 표현식을 포함할 수 있습니다. * %%: "%" 리터럴을 이스케이프합니다. * %l: 대체 중인 현재 레이블. * %s: 시리즈 제목입니다. * %g: 필드별 그룹의 값입니다. 이것이 참조된 기록이면 기록의 이름 필드 값입니다. 변환에 groupBy 여러 그룹이 지정된 경우 레이블은 쉼표로 구분됩니다. * %G: 필드별 그룹의 값입니다. 이것이 참조된 기록이면 기록의 sys_id입니다. 여러 그룹을 선택하면 값이 쉼표로 구분됩니다. {#clotho-POST-clotho-transform-stream__ul_v34_ptm_vlb} 예: "transforms": [ { "name": "label", "arg": "Series Timestamp Values" }, ] "transforms": [ { "name": "groupBy", "arg": "model" }, { "name": "avg" }, { "name": "label", "arg": "Model: %g" } ] | | 제한 | 가장 최근에 저장된 값부터 시작하여 최대 지정된 기간 또는 값 수를 반환합니다. 인수: * arg(정수): 각 시계열에 대해 반환할 타임스탬프 값의 수입니다.또는 * arg(기간 데이터 유형): 각 시계열을 제한하는 기간입니다. {#clotho-POST-clotho-transform-stream__ul_dx1_ndr_vlb} | | log | 각 타임스탬프의 값에 대해 로그를 실행하며, 결과는 타임스탬프 값에 대해 지정된 기준의 로그입니다. 인수: arg(10진수 데이터 형식) - 로그 계산의 기준입니다. | | 맵값 | 지정된 범위(포함) 내의 모든 값을 지정된 값으로 바꿉니다. 와 upperBound 둘 다 lowerBound NaN으로 지정되면 NaN 값을 .targetValue 인수: * lowerBound(10진수 데이터 형식): 범위의 가장 낮은 값입니다. * upperBound(10진수 데이터 형식): 범위에서 가장 높은 값입니다. * targetValue(10진수 데이터 유형): 대체 값입니다. {#clotho-POST-clotho-transform-stream__ul_gjm_3fr_vlb} 예를 들어, 다음은 .1에서 .9 사이의 시계열의 모든 값을 1로 변경합니다. "transforms": [ { "name": "mapValues", "lowerBound": .1, "upperBound": .9, "targetValue": 1 } ] | | 최대 | 입력 전체에서 각 해당 타임스탬프의 최대값을 포함하는 계열을 반환합니다. | | 중위값 | 계열 집합의 각 타임스탬프에 대한 값의 중앙값을 포함하는 계열을 만듭니다. `n` 계열이 있는 경우: * `n`이 홀수이면 중앙값은 타임스탬프의 `(n / 2 + 1)` 값입니다. * `n`이 짝수이면 중앙값은 타임스탬프에 대한 `(n/2)` 및 `(n/2 + 1)` 값의 평균입니다. {#clotho-POST-clotho-transform-stream__ul_hd5_yfr_zlb} | | 최소 | 입력 전체에서 각 해당 타임스탬프의 최소값을 포함하는 계열을 반환합니다. | | 물 | 각 타임스탬프의 값에 지정된 숫자를 곱합니다. 인수: arg(10진수 데이터 형식) - 각 타임스탬프의 값을 곱할 숫자입니다. | | 파티션 | 지정된 집계기를 겹치지 않는 창에 적용하여 필터링된 값으로 새 계열을 작성합니다. 인수: * 집계(집계기 데이터 유형): 수행할 집계의 유형입니다. * base(DateTime 데이터 형식): 파티셔닝에 사용할 0 오프셋입니다. 예를 들어 일(24시간)별로 분할하려면 이 값을 시간대의 월요일 자정으로 설정합니다. 30일 기간으로 분할하려면 이 값을 최근 달의 첫 번째 날로 설정합니다.기본값: EPOCH의 시작. * window(기간 데이터 유형): 집계기를 적용할 겹치지 않는 기간입니다. {#clotho-POST-clotho-transform-stream__ul_fzj_2kr_vlb} | | 포우 | 각 타임스탬프 값을 지정된 검정력으로 올립니다. 인수: arg(10진수 데이터 유형) -- 각 값을 올릴 거듭제곱입니다. | | 제품 | 선택한 메트릭 계열을 각 타임스탬프에 대한 모든 값의 곱을 포함하는 단일 계열로 집계합니다. NaN은 제외됩니다. 시계열의 모든 숫자가 NaN이면 출력도 NaN입니다. | | 리샘플링 | 시계열을 고정된 지점 수 또는 한 빈도에서 다른 빈도로 리샘플링합니다. 리샘플링 변환을 사용하여 결과 세트의 샘플 수를 줄여 표시할 샘플 수와 더 근접하게 일치시킵니다. 인수: 이 변환에 대해 다양한 인수를 전달할 수 있습니다. 다음은 가능한 각 인수 그룹 목록입니다. 이러한 인수 그룹 중 하나만 단일 변환 내에 전달할 수 있습니다. 다음 인수 그룹은 AND/OR로 구분됩니다. AND 인수가 현재 그룹의 일부임을 의미합니다. OR은 새 인수 그룹의 시작임을 의미합니다. * 인수(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * arg(기간 데이터 유형): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다.및 * maxValues(정수): 결과 집합에 포함할 최대 샘플 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다.또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * 값(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다. 또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * 기간(기간 데이터 유형): 다시 샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다. 또는 * 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.및 * minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 적으면 엔드포인트가 보간을 사용하여 추가 샘플을 생성합니다.및 * maxValues(정수): 결과 집합에 포함할 최대 샘플 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 줄입니다. {#clotho-POST-clotho-transform-stream__ul_kc4_n4w_wlb} | | 라운드 | 각 타임스탬프의 값을 지정된 정밀도(`(값/) * `)로 반올림합니다. 인수: arg(10진수 데이터 형식) -- 반올림할 10진수 정밀도입니다. | | 근본 | 지정된 인덱스를 사용하여 각 타임스탬프 값의 루트를 계산합니다. 인수: arg(10진수 데이터 형식) - 루트의 인덱스입니다. 예를 들어, 다음은 각 타임스탬프의 제곱근을 반환합니다. "transforms": [ { "name": "root", "arg": "2" }, ] | | 표준 개발 | 계열 집합의 각 타임스탬프에 대한 값의 표준 편차를 포함하는 계열을 만듭니다. | | 하위 | 각 타임스탬프의 값에서 지정된 숫자를 뺍니다. 인수: arg(숫자) -- 각 타임스탬프의 값에서 뺄 숫자입니다. | | 합계 | 선택한 메트릭 계열을 NaN을 제외하고 각 타임스탬프에 대한 모든 값의 합계를 포함하는 하나의 계열로 집계합니다. 시계열의 모든 숫자가 NaN이면 출력은 NaN입니다. | | 타임 시프트 | 값을 수정하지 않고 값의 타임스탬프에 지정된 오프셋을 추가하여 시간 범위를 이동합니다. 이 변환을 사용하여 타임스탬프를 다른 시간대로 이동합니다. 인수: arg(기간 데이터 유형) -- 이동할 시간입니다. | | 상위 | 가장 높은 값을 가진 지정된 수의 계열을 반환합니다. 인수: arg(정수) -- 반환할 계열 수입니다. 예를 들어, 다음은 가장 높은 값 집합을 포함하는 두 시계열을 반환합니다. "transforms": [ { "name": "top", "arg": 2 } ] | [표 32. 데이터 유형 변환] {#clotho-POST-clotho-transform-stream__id_abm_vgl_2tb} {#clotho-POST-clotho-transform-stream__id_uq3_hhl_2tb__entry__2}{#clotho-POST-clotho-transform-stream__Aggregator}{#clotho-POST-clotho-transform-stream__DateTime}{#clotho-POST-clotho-transform-stream__Decimal}{#clotho-POST-clotho-transform-stream__Duration} | 데이터 유형 | 설명 | |-|-| | 집계 | 변환 내에서 사용할 수 있는 집계기입니다. * 평균: 현재 선택된 모든 계열의 산술 평균을 계산합니다. * CHISQUARE: 통계 모델이 메트릭 데이터 세트에 얼마나 잘 맞는지 보여줍니다. * LAST: 기간 창에서 마지막으로 정의된 값을 반환합니다. * 최대값: 각 시점의 메트릭 데이터 세트의 가장 큰 값을 표시합니다. * MEDIAN: 메트릭 데이터 세트의 중앙값을 표시합니다. 중앙값은 메트릭 데이터 세트의 높은 값과 낮은 값을 구분합니다. * 최소값: 각 시점의 메트릭 데이터 세트에 대한 가장 작은 값을 표시합니다. * STDDEV: 기본 데이터의 표준 편차를 계산합니다. 메트릭 데이터 세트에서 데이터 값 집합의 변동 또는 분산을 정량화하는 데 사용됩니다. * SUM: 현재 선택된 모든 계열의 합계를 계산합니다. {#clotho-POST-clotho-transform-stream__ul_ssr_nrb_xlb} | | 날짜/시간 | 절대 날짜/시간 값은 ISO 8601 날짜 및 시간 형식( `YYYY-MM-DDThh:mm:ss`)으로 지정됩니다. 예: 2020-02-28T13:10:42. 위치: * \[YYYY\]: 4자리 연도입니다. * \[MM\]: 01에서 12 사이의 0패딩 월입니다. * \[DD\]: 01에서 31 사이의 제로 패딩 날짜입니다. * T: 시간을 나타내며 시간 구성요소를 지정하기 전에 필수입니다. * \[hh\]: 00에서 23 사이의 채워진 0시간 * \[mm\]: 00에서 59 사이의 0패딩 시간(분)입니다. * \[ss\]: 00에서 59 사이의 0으로 채워진 초. 윤초는 이전 1,000초에 걸쳐 균등하게 분포됩니다. {#clotho-POST-clotho-transform-stream__ul_hnf_zsb_xlb} 상대 날짜/시간은 현재 시간에서 제한 기간(기간 데이터 유형)을 사용하여 지정됩니다. 예: P7D = 7일 전. | | 10진수 | 10진수 값은 다음 중 하나일 수 있습니다. * 지수 표기법을 사용할 수 있는 임의 정밀도의 부호 있는 10진수입니다.예: * 2 * 1.7 * -3.47 * 1.0E+2 {#clotho-POST-clotho-transform-stream__ul_e5c_v5b_xlb} * 문자열 표현: * 지수 표기법을 사용할 수 있으며 배정밀도 64비트 IEEE 754 부동 소수점 숫자로 보장되는 부호 있는 10진수입니다. * "나엔" * "-무한대" * "+무한대" {#clotho-POST-clotho-transform-stream__ul_vty_z5b_xlb} {#clotho-POST-clotho-transform-stream__ul_rvb_55b_xlb} | | 지속 시간 | 시간 간격의 시간량입니다. 지속 시간 값은 ISO 8601 지속 시간 형식(`P[n]Y[n]M[n]DT[n]H[n]M[n]S)`으로 지정됩니다. 위치: * P: "마침표"라고 하는 기간 지정자이며 항상 기간의 시작 부분에 배치됩니다. * \[n\]Y: 연수입니다. * \[n\]M: 개월 수. * \[n\]D: 날짜 수. * T: 시간 지정자이며 시간 구성요소를 지정하기 전에 필수입니다. * \[n\]H: 시간 수. * \[n\]M: 분 수입니다. * \[n\]S: 초 수입니다. {#clotho-POST-clotho-transform-stream__ul_ilt_tzb_xlb} 예: * P7D: 7일 기간. * P1M: 1개월의 기간입니다. * PT15M: 15분의 기간. * P1DT12H: 1일 12시간의 기간입니다. {#clotho-POST-clotho-transform-stream__ul_vbf_l1c_xlb} | [ ] {#clotho-POST-clotho-transform-stream__id_uq3_hhl_2tb} ### cURL 요청 다음 예제에서는 이 엔드포인트를 호출하여 mb_demo_drone 테이블의 메트릭에 대한 JSON 스트림을 반환하는 방법을 보여줍니다. 참고: 이 예시의 객체는 가독성을 위해 여러 줄로 확장되어 있지만 실제 결과에서는 반환된 각 객체가 자체 줄에 있습니다. `--header "Accept:application/octet-stream" \`을 설정하여 동일한 호출을 수행하고 옥텟 스트림을 반환할 수 있습니다. curl "localhost:8080/api/now/v1/clotho/transform/stream" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --user "username":"password" \ -d "{\ \"start\": \"PT5M\",\ \"end\": \"\",\ \"table\": \"mb_demo_drone\",\ \"query\": \"fleet.nameSTARTSWITHB\",\ \"limit\": 5000,\ \"metrics\": [\ {\ \"metric\": \"mb_demo_mt_altitude\",\ \"label\": \"Series - Avg\",\ \"transforms\": [\ {\ \"name\": \"partition\",\ \"arg\": {\ \"aggregator\": \"AVG\",\ \"window\": \"PT5M\"\ }\ }, {\ \"name\": \"avg\"\ }\ ]\ }, {\ \"metric\": \"mb_demo_mt_altitude\",\ \"groupBy\": \"fleet\",\ \"label\": \"Fleet - AVG\",\ \"transforms\": [\ {\ \"name\": \"partition\",\ \"arg\": {\ \"aggregator\": \"AVG\",\ \"window\": \"PT5M\"\ }\ }, {\ \"name\": \"avg\"\ }\ ]\ }\ ]\ }" 응답: [ { "label": "Series - Avg", "tags": [ "#4fb1114f-2426-4acb-8e3e-6435dd62134c" ], "species": "DOUBLE_SIGNAL", "range": [ "2022-06-16T17:50:00Z", "2022-06-16T17:50:00Z" ], "values": [ 132.86805196126303 ], "period": 300 }, { "label": "Fleet - AVG", "tags": [ ":fleet:86fac11787333200a328c5b836cb0b4e:Bantams", "#6641aab4-c55f-4d11-8846-26b0b706ec1c" ], "species": "DOUBLE_SIGNAL", "range": [ "2022-06-16T17:50:00Z", "2022-06-16T17:50:00Z" ], "values": [ 134.3775875908988 ], "period": 300 }, { "label": "Fleet - AVG", "tags": [ "#6641aab4-c55f-4d11-8846-26b0b706ec1c", ":fleet:4afac11787333200a328c5b836cb0b4e:Bumble Untd" ], "species": "DOUBLE_SIGNAL", "range": [ "2022-06-16T17:50:00Z", "2022-06-16T17:50:00Z" ], "values": [ 129.02530271356756 ], "period": 300 } ] 다음 cURL 예제에서는 CSV 형식 옵션을 사용하여 Metricbase 데모 플러그인의 mb_demo_drone \[Drones\] 테이블에 저장된 각 드론의 마지막 날의 고도 값(데이터베이스에 "mb_demo_mt_altitude"로 저장됨)을 다시 스트리밍합니다. 이 예에서 데이터는 드론을 식별하는 주체 Sys_id, 값의 타임 스탬프 및 고도 값이라는 세 개의 열이 있는 좁은 테이블 형식으로 반환됩니다. curl "https://instance.servicenow.com/api/now/v1/clotho/transform/stream" \ --request POST \ --header "Accept:text/csv;format=narrow" \ --header "Content-Type:application/json" \ --user "user name":"password" \ -d "{\ \"start\": \"P1D\",\ \"end\": \"\",\ \"table\": \"mb_demo_drone\",\ \"metrics\": [\ {\ \"metric\": \"mb_demo_mt_altitude\",\ \"transforms\": []\ }]\ }" 출력: Subject, Timestamp,"mb_demo_drone|mb_demo_mt_altitude" "a66b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,92.84400939941406 "a66b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,92.2428970336914 "6a6b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,92.0076904296875 "ea6b051787333200a328c5b836cb0b92",2022-11-07T22:35:00Z,97.3113021850586 "a66b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,108.49791717529297 "6a6b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,109.04239654541016 "6a6b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,93.72159576416016 "ee6b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,107.69989776611328 "ee6b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,100.86473083496094 "ee6b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,95.77774047851562 "666b051787333200a328c5b836cb0b92",2022-11-07T22:35:00Z,105.19712829589844 "666b051787333200a328c5b836cb0b95",2022-11-07T22:35:00Z,105.92308807373047 "6e6b051787333200a328c5b836cb0b99",2022-11-07T22:35:00Z,93.59339141845703 "666b051787333200a328c5b836cb0b98",2022-11-07T22:35:00Z,94.51266479492188 "e26b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,105.4367904663086 "6e6b051787333200a328c5b836cb0b96",2022-11-07T22:35:00Z,94.64836883544922 "6e6b051787333200a328c5b836cb0b93",2022-11-07T22:35:00Z,94.78523254394531 "e26b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,96.99283599853516 "aa6b051787333200a328c5b836cb0b96",2022-11-07T22:35:00Z,106.67017364501953 "e26b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,94.2446517944336 "aa6b051787333200a328c5b836cb0b93",2022-11-07T22:35:00Z,91.659912109375 "226b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,99.5401840209961 "226b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,98.13501739501953 "226b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,92.2428970336914 "226b051787333200a328c5b836cb0b90",2022-11-07T22:35:00Z,106.41876983642578 "aa6b051787333200a328c5b836cb0b99",2022-11-07T22:35:00Z,107.69989776611328 "626b051787333200a328c5b836cb0b93",2022-11-07T22:35:00Z,92.96666717529297 "e66b051787333200a328c5b836cb0b99",2022-11-07T22:35:00Z,93.85079193115234 "e66b051787333200a328c5b836cb0b93",2022-11-07T22:35:00Z,96.07303619384766 "e66b051787333200a328c5b836cb0b96",2022-11-07T22:35:00Z,98.47595977783203 "2a6b051787333200a328c5b836cb0b92",2022-11-07T22:35:00Z,95.9247055053711 "226b051787333200a328c5b836cb0b9a",2022-11-07T22:35:00Z,99.5401840209961 "2a6b051787333200a328c5b836cb0b98",2022-11-07T22:35:00Z,103.1417465209961 "2a6b051787333200a328c5b836cb0b95",2022-11-07T22:35:00Z,96.99283599853516 "ae6b051787333200a328c5b836cb0b95",2022-11-07T22:35:00Z,94.64836883544922 "ae6b051787333200a328c5b836cb0b98",2022-11-07T22:35:00Z,101.8689956665039 "ae6b051787333200a328c5b836cb0b92",2022-11-07T22:35:00Z,107.4388198852539 "a26b051787333200a328c5b836cb0b98",2022-11-07T22:35:00Z,94.78523254394531 "266b051787333200a328c5b836cb0b93",2022-11-07T22:35:00Z,94.51266479492188 "2e6b051787333200a328c5b836cb0b97",2022-11-07T22:35:00Z,108.49791717529297 "2e6b051787333200a328c5b836cb0b91",2022-11-07T22:35:00Z,97.15129852294922 "2e6b051787333200a328c5b836cb0b94",2022-11-07T22:35:00Z,103.36128997802734 "a26b051787333200a328c5b836cb0b92",2022-11-07T22:35:00Z,100.47681427001953 "266b051787333200a328c5b836cb0b96",2022-11-07T22:35:00Z,103.5830078125 "266b051787333200a328c5b836cb0b99",2022-11-07T22:35:00Z,97.3113021850586 "a26b051787333200a328c5b836cb0b95",2022-11-07T22:35:00Z,105.92308807373047 "ea6b051787333200a328c5b836cb0b98",2022-11-07T22:35:00Z,95.34477996826172 "ea6b051787333200a328c5b836cb0b95",2022-11-07T22:35:00Z,100.47681427001953 "626b051787333200a328c5b836cb0b99",2022-11-07T22:35:00Z,100.86473083496094 "626b051787333200a328c5b836cb0b96",2022-11-07T22:35:00Z,106.9239730834961 ## MetricBase 시계열 - POST /now/clotho/put {#ariaid-title7} 데이터베이스에 시계열 데이터를 추가합니다.MetricBase ### URL 형식 버전이 지정된 URL: /api/now/{api_version}/clotho/put ### 지원되는 요청 매개변수 {#clotho-POST-put__entry__2}{#clotho-POST-put__version-RESTAPI} | 이름 | 설명 | |-|-| | api_version | 액세스할 엔드포인트의 버전입니다. 예를 들어 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 | [표 33. 경로 매개변수] {#clotho-POST-put__entry__6} | 이름 | 설명 | |-|-| | sysparm_ignore_unknown_series | 알 수 없는 계열을 무시하고 오류를 반환하지 않고 트랜잭션을 계속할지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 알 수 없는 계열을 무시합니다. * 아니오: 알 수 없는 계열을 무시하지 않습니다. {#clotho-POST-put__ul_zxy_pbz_tkb} 기본값: true | [표 34. 쿼리 매개변수] {#clotho-POST-put__entry__10} | 이름 | 설명 | |-|-| | 시리즈 참조 | 필수 업데이트할 정보입니다. 데이터 유형: 객체 배열 "seriesRef": [ { "metric": "String", "subject": "String", "table": "String" } ] | | seriesRef.metric | 필수 업데이트할 메트릭의 이름입니다. 데이터 유형: 문자열 | | seriesRef.subject | 필수 데이터를 업데이트할 기록의 Sys_id입니다. 데이터 유형: 문자열 테이블: 매개변수에 seriesRef.table 지정됩니다. | | seriesRef.table | 필수 데이터를 저장할 테이블의 이름입니다. 데이터 유형: 문자열 | | 값 | 필수 저장할 계열 값입니다. 데이터 유형: 배열 "values": [ { "timestamp": "String", "value": Number } ] | | values.timestamp | 필수 값의 ISO 8601 타임스탬프입니다. 데이터 유형: 문자열 형식: `YYYY-MM-ddTHH:mm:ddZ` ISO 형식의 타임스탬프로 UTC 시간대를 나타내는 끝 'Z'는 선택 사항입니다. | | 값.값 | 필수 메트릭 값입니다. 데이터 유형: 숫자 | [표 35. 요청 본문 매개변수(XML 또는 JSON)] ### 헤더 다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-put__entry__26}{#clotho-POST-put__accept-JSON-only-entry-RESTAPI}{#clotho-POST-put__content_type-JSON-only-entry-RESTAPI} | 머리글 | 설명 | |-|-| | 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. | | 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. | [표 36. 요청 헤더] {#clotho-POST-put__entry__32} | 머리글 | 설명 | |-|-| | 안 함 | | [표 37. 응답 헤더] ### 상태 코드 이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.") {#clotho-POST-put__entry__36}{#clotho-POST-put__entry-200-status-code}{#clotho-POST-put__entry-401-status-code}{#clotho-POST-put__entry-500-status-code} | 상태 코드 | 설명 | |-|-| | 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. | | 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. | | 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. | [표 38. 상태 코드] ### 응답 본문 매개변수(JSON 또는 XML) {#clotho-POST-put__entry__44} | 이름 | 설명 | |-|-| | 메시지 | 요청이 성공적으로 처리되면 확인 과 같이 요청의 상태를 나타내는 메시지입니다. | [ ] ### cURL 요청 curl "https://instance.servicenow.com/api/now/v1/clotho/put" \ --request POST \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"seriesRef\": { \"subject\": \"3D666b051787333200a328c5b836cb0b92\", \"table\": \"mb_demo_drone\", \"metric\": \"mb_demo_mt_altitude\" }, \"values\": [ { \"timestamp\": \"2019-03-21T17:05:00Z\", \"value\": 0.150185 }, { \"timestamp\": \"2019-03-21T17:06:00Z\", \"value\": 0.46074 }, { \"timestamp\": \"2019-03-21T17:07:00Z\", \"value\": 0.83104 }, { \"timestamp\": \"2019-03-21T17:08:00Z\", \"value\": 1.260635 }, { \"timestamp\": \"2019-03-21T17:09:00Z\", \"value\": 1.749 } ] }" \ --user "username":"password" { "result": { "message": "ok" } }