MetricBase 시계열 API

  • 릴리스 버전: Washingtondc
  • 업데이트 날짜 2024년 02월 01일
  • 읽기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}

    데이터베이스에서 지정된 시계열 데이터를 MetricBase 검색합니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/clotho/table/{table}/{ subject}/{metric}

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    api_version 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    메트릭 메트릭으로 사용할 매개변수에서 식별된 subject 테이블의 열 이름입니다.

    데이터 유형: 문자열
    제목 이 계열과 연결된 GlideRecord의 Sys_id입니다.

    데이터 유형: 문자열
    테이블 이 계열과 관련된 GlideRecord가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열
    표 2. 쿼리 매개변수
    이름 설명
    sysparm_display_value 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과 데이터에 제목 기록 표시 값으로 레이블이 지정됩니다.
    • false: 결과 데이터가 제목 기록 표시 값으로 레이블 지정되지 않습니다.

    데이터 유형: 부울

    기본값: 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).
    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).
    표 3. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    없음

    헤더

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

    표 4. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

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

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

    이름 설명
    레이블 이 메트릭의 결과 집합을 식별하는 데 사용되는 레이블입니다.

    데이터 유형: 문자열
    seriesRef 데이터 계열 결과입니다.

    데이터 유형: 배열

    "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 타임스탬프입니다.

    데이터 유형: 문자열
    가치.값 메트릭 값입니다.

    데이터 유형: 숫자

    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}

    지정된 매개변수를 기반으로 지정된 데이터를 변환합니다.

    URL 형식

    버전이 지정된 URL: /api/now/{api_version}/ clotho/transform/{table}/{metric}

    지원되는 요청 매개변수

    표 7. 경로 매개변수
    이름 설명
    api_version 액세스할 엔드포인트의 버전입니다. 예: v1 또는 v2 . 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    메트릭 메트릭으로 사용할 매개변수에서 식별된 subject 테이블의 열 이름입니다.

    데이터 유형: 문자열
    테이블 이 계열과 관련된 GlideRecord가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열
    표 8. 쿼리 매개변수
    이름 설명
    sysparm_display_value 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과 데이터에 제목 기록 표시 값으로 레이블이 지정됩니다.
    • false: 결과 데이터가 제목 기록 표시 값으로 레이블 지정되지 않습니다.

    데이터 유형: 부울

    기본값: 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).
    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).
    sysparm_subject_limit 제목 쿼리 결과의 크기를 제한합니다.

    데이터 유형: 숫자

    기본값: 10,000
    sysparm_transforms 쉼표로 구분된 변환 목록입니다.
    유효한 변환:
    • add
    • 평균
    • 레이블
    • Mul
    • 리샘플링
    • 합계
    • 상단

    데이터 유형: 문자열

    기본값: 없음
    표 9. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    없음

    헤더

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

    표 10. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다.

    기본값: application/json
    표 11. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

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

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

    이름 설명
    레이블 이 메트릭의 결과 집합을 식별하는 데 사용되는 레이블입니다.

    데이터 유형: 문자열
    seriesRef 데이터 계열 결과입니다.

    데이터 유형: 배열

    "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 타임스탬프입니다.

    데이터 유형: 문자열
    가치.값 메트릭 값입니다.

    데이터 유형: 숫자

    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

    지정된 타임 스탬프에 메트릭 값을 누적하고 값을 덮어쓰지 않고 결과를 데이터베이스에 저장합니다.

    이 API 사용 사용하여 전기 킬로와트시(kWhs)와 같이 누적에 대해 합산할 수 있는 메트릭을 처리합니다. 누적 제공된 타임스탬프에 각 메트릭을 호출합니다. 예를 들어, 히터, 전기 주전자 및 세탁기에 대해 수집 된 킬로와트는 누적되는 세 번의 호출이 발생합니다.

    URL 형식

    버전이 지정된 URL: / api/now/{api_version}/clotho/accumulate

    지원되는 요청 매개변수

    표 13. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    표 14. 쿼리 매개변수
    이름 설명
    기본_값 지정된 타임스탬프에 누적하기 위한 기본값입니다. 지정된 타임스탬프에 값을 사용할 수 없는 경우 누적하기 위해 첫 번째 호출 중에만 사용됩니다.

    사용 사례는 total_power에 대한 와트 메트릭을 누적하는 것일 수 있습니다. 측정할 전력계 없이 콘센트에 연결된 라우터에 대한 와트를 누적하려고 합니다. 소비 값을 알고 있고 상수인 경우) 상수 값을 기본값으로 사용하여 total_power 누적할 수 있습니다. 예를 들어 라우터가 지속적으로 연결되어 있고 20와트를 소비하는 경우 20을 사용합니다.

    데이터 유형: 문자열

    기본값: 0
    sysparm_ignore_unknown_series

    알 수 없는 계열을 무시하고 오류를 반환하지 않고 트랜잭션을 계속할지 여부를 나타내는 플래그입니다.

    유효한 값은 다음과 같습니다.
    • true: 알 수 없는 계열을 무시합니다.
    • false: 알 수 없는 계열을 무시하지 않습니다.

    기본값: true
    표 15. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    seriesRef 업데이트할 데이터 계열 정보를 나타내는 문자열 목록입니다.

    데이터 유형: 배열

    "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
    가치.값 필수 메트릭 값입니다.

    데이터 유형: 숫자

    헤더

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

    표 16. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 17. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

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

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

    이름 설명
    메시지 성공(OK) 또는 오류를 나타내는 메시지입니다.

    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

    선형 파이프라인을 형성하는 지정된 변환 목록을 적용한 후 하나 이상의 메트릭에 대한 시계열 데이터를 검색하고 선택적으로 그룹화합니다.

    URL 형식

    버전이 지정된 URL: / api/now/{api_version}/clotho/transform

    지원되는 요청 매개변수

    표 19. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    표 20. 쿼리 매개변수
    이름 설명
    sysparm_display_value 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과 데이터에 제목 기록 표시 값으로 레이블이 지정됩니다.
    • false: 결과 데이터가 제목 기록 표시 값으로 레이블 지정되지 않습니다.

    데이터 유형: 부울

    기본값: false
    표 21. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    종료 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다.

    데이터 유형: 문자열

    형식: 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).
    제한 반환할 최대 기록 수입니다. 이례적으로 큰 값은 시스템 성능에 영향을 줄 수 있습니다.

    데이터 유형: 숫자

    기본값: 10,000
    메트릭 변환에 사용할 메트릭 객체의 목록입니다. 메트릭에 대한 자세한 내용은 Metrics 문서를 참조하십시오.

    데이터 유형: 배열

    "metrics": [
  {
    "groupBy": "String"
    "label": "String",
    "metric": "String",
    "transforms": [Array]
  }
]
    metrics.groupBy 집계된 변환을 수집하거나 적용하기 전에 계열을 그룹화하기 위해 매개변수에 table 지정된 테이블에 포함된 쉼표로 구분된 필드 목록입니다.

    목록에 있는 항목의 순서는 데이터가 그룹화되는 순서입니다. 예를 들어 목록에 "시/도, 우편 번호"라는 두 개의 항목이 있는 경우 계열은 먼저 상태별로 그룹화된 다음 주 내의 우편 번호별로 그룹화됩니다.

    데이터 유형: 문자열

    기본값: 데이터가 그룹화되지 않습니다.
    metrics.label 이 메트릭의 결과 세트에 사용할 레이블입니다. 변환 체인에서 생성된 모든 레이블을 대체합니다.

    데이터 유형: 문자열

    기본값: 생성된 기본 레이블입니다.
    metrics.metric 객체가 전달되는 경우 metrics 필요합니다. 변환에 사용할 메트릭 필드입니다. 이 필드는 매개변수에 table 지정된 테이블에 있어야 합니다.

    데이터 유형: 문자열
    metrics.transforms 검색된 시계열 데이터에 적용할 변환(변환 체인) 목록입니다. 각 변환은 이전 변환의 결과를 기반으로 합니다. 사용 가능한 변환 목록은 아래의 지원되는 변환을 참조하세요.

    데이터 유형: 배열

    "transforms": [
  {
    "arg": {Object},
    "name": "String"
  }
]
    metrics.transforms.arg 변환에 따라 다릅니다. 변환에 전달할 매개변수입니다.
    일반 지침:
    • 매개 변수를 사용하지 않는 변환을 지정할 때는 매개 변수를 사용하지 arg 마십시오.
    • 단일 매개변수를 사용하는 변환에는 숫자, 문자열 또는 부울을 사용합니다.
    • 두 개 이상의 파라미터를 사용하는 변환에 대해 적절한 이름-값 쌍과 함께 JSON 객체를 사용합니다.

    데이터 유형: 변환에 따라 숫자, 문자열, 부울 또는 JSON 객체입니다. (사용 가능한 변환 목록은 아래의 지원되는 변환 테이블을 참조하세요.)
    metrics.transforms.name 개체가 지정된 경우 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).
    테이블 필수 이 계열과 관련된 GlideRecord가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열

    헤더

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

    표 22. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 23. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

    표 24. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    405 잘못된 메서드입니다. 기능이 비활성화되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

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

    이름 설명
    결과 쿼리를 만족하는 0개 이상의 반환 결과 개체입니다. 배열 또는 배열을 seriesgrouped 포함합니다.

    데이터 유형: 배열

    "results":[
  {
    "grouped": [Array],
    "marker": "String",
    "series": [Array]
  }
]
    결과.그룹화됨 각 grouped 결과 객체가 특정 그룹에 해당하는 그룹화된 결과 객체의 목록입니다. 이 형식은 매개 변수가 요청 본문에 전달될 때 metrics.groupBy 반환됩니다.

    데이터 유형: 배열

    "grouped": [
  {
    "groupingBy": "String",
    "groups": [Array]
  }
]
    결과.그룹화.그룹화 기준 요청의 매개변수에 전달된 metrics.groupBy 값입니다.

    데이터 유형: 문자열
    결과.그룹화.그룹 요청의 매개변수 내용을 metrics.groupBy 기반으로 생성된 그룹 목록입니다.

    데이터 유형: 배열

    "groups": [
  {
    "group": "String",
    "label": "String",
    "series": {Object}
  }
]
    결과.그룹화.그룹.그룹 그룹의 이름입니다.

    데이터 유형: 문자열
    결과.그룹화.그룹.레이블 그룹의 레이블입니다.

    데이터 유형: 문자열
    결과.그룹화.그룹.시리즈 그룹 결과의 변환된 값입니다.

    데이터 유형: 배열

    "series": [
  {
    "label": "String",
    "seriesRef": {Object},
    "values": [Array]
  }
]
    결과.그룹화.그룹.시리즈.레이블 계열의 레이블입니다.

    데이터 유형: 문자열
    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 데이터 계열을 가져온 테이블의 이름입니다.

    데이터 유형: 문자열
    결과.그룹화.그룹.시리즈.값 그룹의 결과 값 목록입니다.

    데이터 유형: 배열

    "values": [
  {
    "timestamp": "String",
    "value": Number
  }
]
    results.grouped.groups.series.values.timestamp 값의 ISO 8601 타임스탬프입니다.

    데이터 유형: 문자열
    결과.그룹화.그룹.시리즈.값.값 변환된 값입니다.

    데이터 유형: 숫자
    결과.마커 해당 결과의 고유 식별자입니다.

    데이터 유형: 문자열
    결과.시리즈 그룹화되지 않은 일련의 결과 객체 목록입니다.

    데이터 유형: 배열

    "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 타임스탬프입니다.

    데이터 유형: 문자열
    결과.시리즈.값.값 변환된 값입니다.

    데이터 유형: 숫자

    지원되는 변환

    표 25. 변환 데이터 형식
    변환 설명
    add 각 타임스탬프 값에 지정된 숫자를 더합니다.

    인수: arg(10진수 데이터 유형) – 추가할 숫자입니다.

    예:
    "transforms": [
  {
    "name": "add",
    "arg": 8
  }
]
    자동 상관 관계 1부터 시작하여 증가하는 기간 수로 구분된 타임스탬프 값 간의 상관 관계를 계산합니다.
    평균 입력 전체에서 각 해당 타임스탬프의 평균 값을 포함하는 시계열을 하나의 계열로 집계합니다.
    하단 가장 낮은 값을 가진 지정된 수의 계열을 반환합니다.

    인수: arg (정수) – 반환할 시리즈의 수입니다.

    예를 들어, 다음은 가장 낮은 값 집합을 포함하는 두 개의 시계열을 반환합니다.
    "transforms": [
  {
     "name": "bottom",
     "arg": 2
  }
]
    Ceil 각 타임 스탬프의 값을 지정된 전체 자릿수로 반올림합니다. ceil(value / <arg>) * <arg>)

    인수: 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(Decimal 데이터 형식): 최소값 또는 최대값입니다.
    • val2(Decimal 데이터 형식): 최소값 또는 최대값입니다.
    카운트 시계열을 하나의 계열로 집계합니다. 새 계열에는 계열의 각 해당 타임스탬프에 대해 NaN(숫자가 아님)이 아닌 값의 수가 포함됩니다.
    파생 타임스탬프 간의 변경률을 결정합니다. 각 타임 스탬프의 값과 다음 타임 스탬프의 값 간의 차이를 타임 스탬프의 기간으로 나눕니다.
    주:
    이 변환은 계열의 값 수보다 하나 작은 값을 반환합니다.
    Div 각 타임 스탬프의 값을 지정된 숫자(arg)로 나눕니다.

    인수: arg (10진수 – 각 타임스탬프의 값을 나눌 수 있는 숫자입니다.
    봉투 두 개의 시계열을 반환하며, 여기서 특정 시점에 하나는 가장 큰 값을 포함하고 다른 하나는 가장 작은 값을 포함합니다.
    주:
    NaN은 무시되지만 다른 반환 값이 없으면 반환됩니다.
    특급 지정된 밑의 값을 각 타임스탬프 값의 검정력으로 올립니다.

    인수: arg(10진수 데이터 유형) – 기준 값입니다.
    필터 이동 평균 생성과 같은 슬라이딩 윈도우의 내용에 집계자를 적용합니다.
    인수:
    • 집계기(집계기 데이터 유형): 수행할 집계의 유형입니다.
    • window(지속 시간 데이터 유형): 슬라이딩 윈도우의 지속 시간입니다.
    층 각 타임 스탬프의 값을 지정된 정밀도로 반올림합니다. floor(value / <arg>) * <arg>

    인수: 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) 이상의 모든 항목의 중앙값.
    주:
    IQR = 3분기 - 1분기
    레이블 변환 체인에 레이블을 지정합니다.
    주:
    후속 변환은 레이블을 수정하거나 대체할 수 있습니다.
    인수: arg(문자열) – 레이블의 텍스트입니다. 다음과 같은 형식 지정 식을 포함할 수 있습니다.
    • %%: "%" 리터럴을 이스케이프합니다.
    • %l: 교체 중인 현재 레이블입니다.
    • %s: 계열 제목입니다.
    • %g: 그룹 기준 필드의 값입니다. 이 기록이 참조된 기록이면 기록의 이름 필드 값입니다. 변환에 groupBy 여러 그룹이 지정된 경우 레이블은 쉼표로 구분됩니다.
    • %G: 필드별 그룹 값입니다. 이 기록이 참조된 기록이면 해당 기록은 sys_id. 여러 그룹을 선택하면 값이 쉼표로 구분됩니다.
    예:
    "transforms": [
  {
    "name": "label",
    "arg": "Series Timestamp Values"
  },
]
    "transforms": [
  {
    "name": "groupBy",
    "arg": "model"
  },
  {
    "name": "avg"
  },
  {
    "name": "label",
    "arg": "Model: %g"
  }
]
    제한 가장 최근에 저장된 값부터 시작하여 지정된 기간 또는 최대 값 수를 반환합니다.
    인수:
    • arg(정수): 각 시계열별로 반환할 타임스탬프 값의 수입니다.

      또는

    • arg(기간 데이터 유형): 각 시계열을 제한하는 기간입니다.
    log 결과가 타임스탬프 값에 대해 지정된 기준의 로그인 각 타임스탬프의 값에 대해 로그를 실행합니다.

    인수: arg(10진수 데이터 형식) – 로그 계산의 기준입니다.
    mapValues 지정된 범위(포함) 내의 모든 값을 지정된 값으로 바꿉니다. and lowerBound 가 upperBound 모두 NaN으로 지정되면 모든 NaN 값이 targetValue.
    인수:
    • lowerBound(Decimal 데이터 형식): 범위의 가장 낮은 값입니다.
    • upperBound(Decimal 데이터 형식): 범위에서 가장 높은 값입니다.
    • targetValue(Decimal 데이터 형식): 대체 값입니다.
    예를 들어, 다음은 .1과 .9 사이의 시계열의 모든 값을 1로 변경합니다.
    "transforms": [
  {
    "name": "mapValues",
    "lowerBound": .1,
    "upperBound": .9,
    "targetValue": 1
  }
]
    최대 입력 전체에서 각 해당 타임스탬프의 최대값을 포함하는 계열을 반환합니다.
    중간 계열 집합의 각 타임스탬프에 대한 값의 중간값을 포함하는 계열을 작성합니다.
    n개의 계열이 있는 경우:
    • n이 홀수인 경우 중앙값은 타임스탬프에 대한 (n/2+1) 값입니다.
    • n이 짝수인 경우 중앙값은 타임스탬프에 대한 (n/2) 및 (n/2+1) 값의 평균입니다.
    최소 입력 전체에서 해당하는 각 타임스탬프의 최소값을 포함하는 계열을 반환합니다.
    Mul 각 타임스탬프의 값에 지정된 숫자를 곱합니다.

    인수: arg(10진수 데이터 유형) – 각 타임스탬프의 값을 곱하는 숫자입니다.
    파티션

    겹치지 않는 창에 지정된 집계기를 적용하여 필터링된 값으로 새 계열을 생성합니다.

    인수:
    • 집계기(집계기 데이터 유형): 수행할 집계의 유형입니다.
    • 창(기간 데이터 유형): 집계기를 적용하기 위한 겹치지 않는 기간입니다.
    • base(DateTime 데이터 형식): 분할에 사용할 0 오프셋입니다. 예를 들어 일별(24시간)로 분할하려면 이 값을 해당 시간대의 월요일 자정으로 설정합니다. 30일 기간으로 분할하려면 이 값을 가장 최근 달의 첫 번째 날로 설정합니다.

      기본값: EPOCH의 시작
    포로 각 타임스탬프 값을 지정된 검정력으로 올립니다.

    인수: arg(10진수 데이터 유형) – 각 값을 올릴 거듭제곱입니다.
    제품 선택한 메트릭 계열을 각 타임스탬프에 대한 모든 값의 곱을 포함하는 단일 계열로 집계합니다. NaN은 제외됩니다. 급수의 모든 숫자가 NaN이면 출력값도 NaN입니다.
    리샘플링 시계열을 고정된 수의 점으로 또는 한 주파수에서 다른 주파수로 리샘플링합니다.

    리샘플링 변환을 사용하여 결과 집합의 샘플 수를 줄이면 표시할 샘플 수와 더 근접하게 일치할 수 있습니다.

    인수: 이 변환에 대해 다양한 인수를 전달할 수 있습니다. 다음은 가능한 각 인수 그룹의 목록입니다. 이러한 인수 그룹 중 하나만 단일 변환 내에서 전달할 수 있습니다. 다음 인수 그룹은 AND/OR로 구분됩니다. AND는 인수가 현재 그룹의 일부임을 의미합니다. OR은 새로운 인수 그룹의 시작임을 의미합니다.
    • arg(정수): 결과 세트에 포함할 샘플의 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • arg(기간 데이터 형식): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다.

      및

    • maxValues(정수): 결과 집합에 포함할 샘플의 최대 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • values(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • period(기간 데이터 형식): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다.

      및

    • maxValues(정수): 결과 집합에 포함할 샘플의 최대 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.
    라운드 각 타임 스탬프의 값을 지정된 정밀도로 반올림합니다. (value / <arg>) * <arg>

    인수: arg(10진수 데이터 유형) – 반올림할 10진수 정밀도입니다.
    루트 지정된 인덱스를 사용하여 각 타임스탬프 값의 루트를 계산합니다.

    인수: arg(10진수 데이터 유형) – 루트의 인덱스입니다.

    예를 들어 다음은 각 타임스탬프의 제곱근을 반환합니다.
    "transforms": [
  {
    "name": "root",
    "arg": "2"
  },
]
    표준 개발 계열 집합의 각 타임스탬프 값의 표준 편차가 포함된 계열을 만듭니다.
    하위 각 타임스탬프의 값에서 지정된 숫자를 뺍니다.

    인수: arg(숫자) – 각 타임스탬프의 값에서 뺄 숫자입니다.
    합계 선택한 메트릭 계열을 NaN을 제외한 각 타임스탬프의 모든 값 합계를 포함하는 하나의 계열로 집계합니다. 급수의 모든 숫자가 NaN이면 출력값은 NaN입니다.
    타임시프트 값을 수정하지 않고 값의 타임스탬프에 지정된 오프셋을 추가하여 시간 범위를 이동합니다. 이 변환을 사용하여 타임스탬프를 다른 시간대로 이동합니다.

    인수: arg(기간 데이터 유형) – 이동할 시간의 양입니다.
    상단 가장 높은 값을 가진 지정된 수의 계열을 반환합니다.

    인수: arg(정수) – 반환할 시리즈의 수입니다.

    예를 들어 다음은 가장 높은 값 집합을 포함하는 두 개의 시계열을 반환합니다.
    "transforms": [
  {
     "name": "top",
     "arg": 2
  }
]
    데이터 유형 설명
    집계 변환 내에서 사용할 수 있는 집계기입니다.
    • AVG: 현재 선택된 모든 계열의 산술 평균을 계산합니다.
    • CHISQUARE: 통계 모델이 메트릭 데이터 세트에 얼마나 잘 맞는지 보여줍니다.
    • LAST: 기간 창에서 마지막으로 정의된 값을 반환합니다.
    • MAX: 각 시점에서 메트릭 데이터 세트의 가장 큰 값을 표시합니다.
    • 중앙값: 메트릭 데이터 세트의 중앙값을 표시합니다. 중앙값은 메트릭 데이터 세트의 높은 값과 낮은 값을 구분합니다.
    • MIN: 각 시점에서 메트릭 데이터 세트의 가장 작은 값을 표시합니다.
    • STDDEV: 기본 데이터에서 표준 편차를 계산합니다. 메트릭 데이터 세트에서 데이터 값 세트의 변형 또는 분산을 수량화하는 데 사용됩니다.
    • SUM: 현재 선택된 모든 계열의 합계를 계산합니다.
    날짜/시간 절대 날짜/시간 값은 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초에 걸쳐 균등하게 분산됩니다.

    상대 날짜/시간 값은 현재 시간에서 뺀 기간(Duration 데이터 유형)을 사용하여 지정됩니다.

    예: P7D = 7일 전입니다.
    10진수 10진수 값으로, 다음 중 하나가 될 수 있습니다.
    • 지수 표기법을 사용할 수 있는 임의 정밀도의 부호 있는 10진수입니다.

      같은:

      • 2
      • 1.7
      • -3.47
      • 1.0E+2
    • 문자열 표현:
      • 지수 표기법을 사용할 수 있고 배정밀도 64비트 IEEE 754 부동 소수점 숫자로 보장되는 부호 있는 10진수입니다.
      • "난"
      • "-무한대"
      • "+무한대"
    지속 시간 시간 간격의 시간입니다. 기간 값은 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: 시간(초)입니다.
    예:
    • P7D: 7일의 기간.
    • P1M: 한 달의 기간입니다.
    • PT15M: 15분의 기간.
    • P1DT12H: 1일 12시간의 기간입니다.

    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

    지정된 변환 목록을 적용한 후 하나 이상의 메트릭에 대한 변환된 시계열 데이터 스트림을 반환합니다.

    이러한 방식으로 데이터를 스트리밍하면 모든 변환 결과가 완료되고 다운로드될 때까지 기다리지 않고 개별 변환이 완료되고 반환될 때 데이터를 처리할 수 있습니다. 클라이언트에서 많은 양의 데이터를 처리해야 하는 경우 이러한 유형의 처리는 종단 간 처리 시간을 줄이고 잠재적으로 클라이언트의 메모리 사용량을 줄입니다.

    요청에서 해당 Accept 헤더 값을 설정하면 다음을 수행할 수 있습니다.
    • 이진 형식으로 인코딩할 스트리밍 데이터를 지정합니다.
    • 스트리밍된 데이터를 JSON 배열로 직렬화하거나,
    • 와이드 또는 좁은 CSV 형식으로 데이터를 클라이언트로 다시 스트리밍합니다.
    엔드포인트는 서버에서 변환이 완료될 MetricBase 때 그룹화 또는 미리 결정된 순서 없이 데이터를 스트리밍합니다. 이진 형식으로 스트리밍된 데이터의 크기는 엔드포인트에서 반환된 JSON 표현보다 MetricBase 시계열 - POST /now/clotho/transform 작습니다.

    URL 형식

    버전이 지정된 URL: / api/now/{api_version}/clotho/transform/stream

    지원되는 요청 매개변수

    표 26. 경로 매개변수
    이름 설명
    api_version 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    표 27. 쿼리 매개변수
    이름 설명
    sysparm_display_value 다른 레이블이 지정되지 않은 경우 결과 데이터에 제목 기록 표시 값으로 레이블을 지정할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 결과 데이터에 제목 기록 표시 값으로 레이블이 지정됩니다.
    • false: 결과 데이터가 제목 기록 표시 값으로 레이블 지정되지 않습니다.

    데이터 유형: 부울

    기본값: false
    표 28. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    종료 필수 평가 기간의 종료 시간입니다. 비어 있거나 누락된 값은 현재 시간으로 처리됩니다.

    데이터 유형: 문자열

    형식: 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).
    제한 반환할 최대 기록 수입니다. 이례적으로 큰 값은 시스템 성능에 영향을 줄 수 있습니다.

    데이터 유형: 숫자

    기본값: 10,000
    메트릭 변환에 사용할 메트릭 객체의 목록입니다. 메트릭에 대한 자세한 내용은 메트릭을 참조하십시오.

    데이터 유형: 배열

    "metrics": [
  {
    "label": "String",
    "metric": "String",
    "transforms": [Array]
  }
]
    metrics.label 이 메트릭의 결과 세트에 사용할 레이블입니다. 변환 체인에서 생성된 모든 레이블을 대체합니다.

    데이터 유형: 문자열

    기본값: 생성된 기본 레이블입니다.
    metrics.metric 객체가 전달되는 경우 metrics 필요합니다. 변환에 사용할 메트릭 필드입니다. 이 필드는 매개변수에 table 지정된 테이블에 있어야 합니다.

    데이터 유형: 문자열
    metrics.transforms 검색된 시계열 데이터에 적용할 변환(변환 체인) 목록입니다. 각 변환은 이전 변환의 결과를 기반으로 합니다. 사용 가능한 변환 목록은 아래의 지원되는 변환을 참조하세요.

    데이터 유형: 배열

    "transforms": [
  {
    "arg": {Object},
    "name": "String"
  }
]
    metrics.transforms.arg 변환에 따라 다릅니다. 변환에 전달할 매개변수입니다.
    일반 지침:
    • 매개 변수를 사용하지 않는 변환을 지정할 때는 매개 변수를 사용하지 arg 마십시오.
    • 단일 매개변수를 사용하는 변환에는 숫자, 문자열 또는 부울을 사용합니다.
    • 두 개 이상의 파라미터를 사용하는 변환에 대해 적절한 이름-값 쌍과 함께 JSON 객체를 사용합니다.

    데이터 유형: 변환에 따라 숫자, 문자열, 부울 또는 JSON 객체입니다. (사용 가능한 변환 목록은 아래의 지원되는 변환 테이블을 참조하세요.)
    metrics.transforms.name 개체가 지정된 경우 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).
    테이블 필수 이 계열과 관련된 GlideRecord가 포함된 테이블의 이름입니다.

    데이터 유형: 문자열

    헤더

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

    표 29. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. 다음을 지원합니다.
    • application/json
    • application/octet-stream 또는
    • text/csv
    CSV 형식을 지정하려면 text/csv를 사용합니다. 형식 = 좁은 또는 텍스트 / csv; format=와이드입니다.
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 30. 응답 헤더
    헤더 설명
    없음 응답 본문의 데이터 형식입니다. 요청의 지정된 수락 값에 따라 다음을 사용합니다.
    • application/json
    • application/octet-stream 또는
    • text/csv

    여러 Accept 형식을 지정하면 지원되는 첫 번째 형식이 반환됩니다.

    상태 코드

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

    표 31. 상태 코드
    상태 코드 설명
    200 성공입니다. 요청이 성공적으로 처리되었으며 데이터가 스트리밍되기 시작합니다.
    주:
    200 응답은 변환이 계산되는 동안 중간에 처리 오류를 계속 발생시킬 수 있습니다.
    400 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다.
    401 승인되지 않았습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다.
    404 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다.
    405 잘못된 메서드입니다. 기능이 비활성화되었습니다.
    500 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다.

    응답 본문 매개변수(Octet-stream 또는 JSON)

    이름 설명
    출력 스트림(옥텟-스트림) 수락 요청 헤더가 로 설정된 application/octet-stream경우 일치하는 MetricBase 데이터는 이진 직렬 스트림으로 반환됩니다. Java 애플리케이션용 Clotho-Util은 이 데이터를 구문 분석할 수 있는 역직렬 변환기를 제공합니다.

    스트림은 각 데이텀의 이진 직렬화로 구성되며, 그 앞에는 길이를 나타내는 정수가 옵니다. 다음 항목은 이진 표현 내의 데이터와 해당 데이터의 순서를 설명합니다.
    CSV 스트림(UTF-8 스트림) 수락 요청 헤더가 로 설정된 text/csv경우 일치하는 MetricBase 데이터는 와이드 또는 좁은 형식의 UTF-8 인코딩 CSV 데이터로 반환됩니다.

    좁은 형식은 제목 및 타임스탬프 열과 반환된 각 메트릭에 대한 열을 반환합니다. 와이드 형식은 각 메트릭-제목 쌍에 대해 별도의 열이 있는 타임스탬프 열을 반환합니다.
    제목 데이터의 소스입니다. 예를 들어 데이터의 메트릭이 드론 고도인 경우 이 값은 특정 드론의 ID일 수 있습니다. 콜론이 값에 포함된 경우 제목 뒤의 부분은 데이터가 속한 메트릭을 나타냅니다. Null 값은 인코딩된 빈 문자열로 표시됩니다.

    크기: 2+ 바이트

    데이터 유형: Java 수정 UTF 문자열
    크기 데이터의 출처인 메트릭입니다. Null 값은 인코딩된 빈 문자열로 표시됩니다.

    크기: 2+ 바이트

    데이터 유형: Java 수정 UTF 문자열
    레이블 데이터의 레이블입니다. Null 값은 인코딩된 빈 문자열로 표시됩니다.

    크기: 2+ 바이트

    데이터 유형: Java 수정 UTF 문자열
    유형 바이트로 인코딩된 데이터의 유형입니다.

    가능한 값:

    • 플로트 신호
    • 이중 신호
    • 플로트 모드
    • 더블 모델

    크기: 1 바이트

    데이터 유형: 바이트
    플래그 인코딩된 serializeFlags 변수입니다. serializeTags true이고 데이터에 태그가 포함되어 있으면 값은 2이고, 그렇지 않으면 0입니다.

    크기: 1 바이트

    데이터 유형: 바이트
    기간 데이터와 연결된 기간입니다.

    크기: 4 바이트

    데이터 유형: 정수
    태그 수 serializeTags true이면 데이터에 저장된 태그 수입니다.

    크기: 4 바이트

    데이터 유형: 정수
    태그 true이면 serializeTags 각 태그가 데이터에 저장됩니다.

    크기: 태그 수(2+ 바이트)에 따라 다릅니다.

    데이터 유형: Java 수정 UTF 문자열
    에포크 초 시작 이 데이터 계열의 시작 시간을 나타내는 Epoch UTC 시간입니다.

    크기: 8 바이트

    데이터 유형: Long
    값의 수 이 데이터에 저장된 값의 수입니다.

    크기: 4 바이트

    데이터 유형: 정수
    값 가 Float Signal인 경우 Type 나머지는 float 값으로 구성됩니다.

    사이즈: Number of Values *4

    데이터 유형: 부동
    값 Type가 Double Signal이면 나머지는 double 값으로 구성됩니다.

    크기: Number of Values * 4 바이트

    데이터 유형: 복식
    모델 JSON(모델) Float Model 또는 Double Model인 경우 Type 나머지는 모델을 JSON으로 나타내는 Java Modified UTF String입니다.

    크기: 2+ 바이트

    데이터 유형: JSON(Java 수정 UTF 문자열)
    빅 모델 마커 (빅 모델) 모델의 JSON 길이가 65,535바이트보다 크면 .Model Json

    사이즈: 5

    데이터 유형: Java 수정 UTF 문자열
    큰 모델 크기 (큰 모델) 큰 모델의 JSON 표현 길이입니다.

    크기: 4 바이트

    데이터 유형: 정수
    빅 모델 JSON(빅 모델) 모델을 일련의 UTF 문자로 JSON으로 표현하며, 크기는 필드에 의해 Big Model Size 결정됩니다.

    크기: 65535-256000 바이트

    데이터 유형: UTF 문자
    JSON 스트림(JSON) 수락 요청 헤더가 로 설정된 application/json경우 일치하는 MetricBase 데이터는 줄 바꿈으로 구분된 JSON 객체의 스트림으로 반환됩니다. 다음 항목에서는 반환된 각 개체에서 사용할 수 있는 요소에 대해 설명합니다.
    레이블 데이터의 레이블입니다. 이 값은 끝점에서 생성되거나 매개 변수에 전달되는 metrics.label 값입니다.

    데이터 유형: 문자열
    기간 각 값 사이의 시간입니다. 예를 들어, 기간이 60이면 각 값의 간격이 1분이라는 의미입니다.

    단위: 초

    데이터 유형: 숫자
    범위 ISO 8601(UTC) 형식으로 된 데이터의 시작 및 종료 시간입니다.

    데이터 유형: 배열
    계열 개별 데이터를 식별합니다. 있는 경우 일반적으로 [ Glide 기록 ID]:[메트릭] 형식입니다. 변환을 사용할 때는 나타나지 않을 수 있습니다.

    데이터 유형: 문자열
    종 반환 데이터의 유형입니다. 일련의 float 또는 double 값의 경우 이 값은 FLOAT_SIGNAL 또는 DOUBLE_SIGNAL입니다. 부동 데이터 또는 이중 데이터를 분석하기 위한 모델의 경우 FLOAT_MODEL 또는 DOUBLE_MODEL입니다.

    데이터 유형: 문자열
    tags 데이터와 연결된 태그입니다.

    데이터 유형: 문자열 배열
    값 데이터에 대한 Float 또는 Double 값입니다.

    데이터 유형: 숫자 배열
    오류 지정된 데이터 계열의 변환이 실패할 경우의 오류 메시지입니다.

    데이터 유형: 문자열

    지원되는 변환

    표 32. 변환 데이터 형식
    변환 설명
    add 각 타임스탬프 값에 지정된 숫자를 더합니다.

    인수: arg(10진수 데이터 유형) – 추가할 숫자입니다.

    예:
    "transforms": [
  {
    "name": "add",
    "arg": 8
  }
]
    자동 상관 관계 1부터 시작하여 증가하는 기간 수로 구분된 타임스탬프 값 간의 상관 관계를 계산합니다.
    평균 입력 전체에서 각 해당 타임스탬프의 평균 값을 포함하는 시계열을 하나의 계열로 집계합니다.
    하단 가장 낮은 값을 가진 지정된 수의 계열을 반환합니다.

    인수: arg (정수) – 반환할 시리즈의 수입니다.

    예를 들어, 다음은 가장 낮은 값 집합을 포함하는 두 개의 시계열을 반환합니다.
    "transforms": [
  {
     "name": "bottom",
     "arg": 2
  }
]
    Ceil 각 타임 스탬프의 값을 지정된 전체 자릿수로 반올림합니다. ceil(value / <arg>) * <arg>)

    인수: 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(Decimal 데이터 형식): 최소값 또는 최대값입니다.
    • val2(Decimal 데이터 형식): 최소값 또는 최대값입니다.
    카운트 시계열을 하나의 계열로 집계합니다. 새 계열에는 계열의 각 해당 타임스탬프에 대해 NaN(숫자가 아님)이 아닌 값의 수가 포함됩니다.
    파생 타임스탬프 간의 변경률을 결정합니다. 각 타임 스탬프의 값과 다음 타임 스탬프의 값 간의 차이를 타임 스탬프의 기간으로 나눕니다.
    주:
    이 변환은 계열의 값 수보다 하나 작은 값을 반환합니다.
    Div 각 타임 스탬프의 값을 지정된 숫자(arg)로 나눕니다.

    인수: arg (10진수 – 각 타임스탬프의 값을 나눌 수 있는 숫자입니다.
    봉투 두 개의 시계열을 반환하며, 여기서 특정 시점에 하나는 가장 큰 값을 포함하고 다른 하나는 가장 작은 값을 포함합니다.
    주:
    NaN은 무시되지만 다른 반환 값이 없으면 반환됩니다.
    특급 지정된 밑의 값을 각 타임스탬프 값의 검정력으로 올립니다.

    인수: arg(10진수 데이터 유형) – 기준 값입니다.
    필터 이동 평균 생성과 같은 슬라이딩 윈도우의 내용에 집계자를 적용합니다.
    인수:
    • 집계기(집계기 데이터 유형): 수행할 집계의 유형입니다.
    • window(지속 시간 데이터 유형): 슬라이딩 윈도우의 지속 시간입니다.
    층 각 타임 스탬프의 값을 지정된 정밀도로 반올림합니다. floor(value / <arg>) * <arg>

    인수: 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) 이상의 모든 항목의 중앙값.
    주:
    IQR = 3분기 - 1분기
    레이블 변환 체인에 레이블을 지정합니다.
    주:
    후속 변환은 레이블을 수정하거나 대체할 수 있습니다.
    인수: arg(문자열) – 레이블의 텍스트입니다. 다음과 같은 형식 지정 식을 포함할 수 있습니다.
    • %%: "%" 리터럴을 이스케이프합니다.
    • %l: 교체 중인 현재 레이블입니다.
    • %s: 계열 제목입니다.
    • %g: 그룹 기준 필드의 값입니다. 이 기록이 참조된 기록이면 기록의 이름 필드 값입니다. 변환에 groupBy 여러 그룹이 지정된 경우 레이블은 쉼표로 구분됩니다.
    • %G: 필드별 그룹 값입니다. 이 기록이 참조된 기록이면 해당 기록은 sys_id. 여러 그룹을 선택하면 값이 쉼표로 구분됩니다.
    예:
    "transforms": [
  {
    "name": "label",
    "arg": "Series Timestamp Values"
  },
]
    "transforms": [
  {
    "name": "groupBy",
    "arg": "model"
  },
  {
    "name": "avg"
  },
  {
    "name": "label",
    "arg": "Model: %g"
  }
]
    제한 가장 최근에 저장된 값부터 시작하여 지정된 기간 또는 최대 값 수를 반환합니다.
    인수:
    • arg(정수): 각 시계열별로 반환할 타임스탬프 값의 수입니다.

      또는

    • arg(기간 데이터 유형): 각 시계열을 제한하는 기간입니다.
    log 결과가 타임스탬프 값에 대해 지정된 기준의 로그인 각 타임스탬프의 값에 대해 로그를 실행합니다.

    인수: arg(10진수 데이터 형식) – 로그 계산의 기준입니다.
    mapValues 지정된 범위(포함) 내의 모든 값을 지정된 값으로 바꿉니다. and lowerBound 가 upperBound 모두 NaN으로 지정되면 모든 NaN 값이 targetValue.
    인수:
    • lowerBound(Decimal 데이터 형식): 범위의 가장 낮은 값입니다.
    • upperBound(Decimal 데이터 형식): 범위에서 가장 높은 값입니다.
    • targetValue(Decimal 데이터 형식): 대체 값입니다.
    예를 들어, 다음은 .1과 .9 사이의 시계열의 모든 값을 1로 변경합니다.
    "transforms": [
  {
    "name": "mapValues",
    "lowerBound": .1,
    "upperBound": .9,
    "targetValue": 1
  }
]
    최대 입력 전체에서 각 해당 타임스탬프의 최대값을 포함하는 계열을 반환합니다.
    중간 계열 집합의 각 타임스탬프에 대한 값의 중간값을 포함하는 계열을 작성합니다.
    n개의 계열이 있는 경우:
    • n이 홀수인 경우 중앙값은 타임스탬프에 대한 (n/2+1) 값입니다.
    • n이 짝수인 경우 중앙값은 타임스탬프에 대한 (n/2) 및 (n/2+1) 값의 평균입니다.
    최소 입력 전체에서 해당하는 각 타임스탬프의 최소값을 포함하는 계열을 반환합니다.
    Mul 각 타임스탬프의 값에 지정된 숫자를 곱합니다.

    인수: arg(10진수 데이터 유형) – 각 타임스탬프의 값을 곱하는 숫자입니다.
    파티션

    겹치지 않는 창에 지정된 집계기를 적용하여 필터링된 값으로 새 계열을 생성합니다.

    인수:
    • 집계기(집계기 데이터 유형): 수행할 집계의 유형입니다.
    • 창(기간 데이터 유형): 집계기를 적용하기 위한 겹치지 않는 기간입니다.
    • base(DateTime 데이터 형식): 분할에 사용할 0 오프셋입니다. 예를 들어 일별(24시간)로 분할하려면 이 값을 해당 시간대의 월요일 자정으로 설정합니다. 30일 기간으로 분할하려면 이 값을 가장 최근 달의 첫 번째 날로 설정합니다.

      기본값: EPOCH의 시작
    포로 각 타임스탬프 값을 지정된 검정력으로 올립니다.

    인수: arg(10진수 데이터 유형) – 각 값을 올릴 거듭제곱입니다.
    제품 선택한 메트릭 계열을 각 타임스탬프에 대한 모든 값의 곱을 포함하는 단일 계열로 집계합니다. NaN은 제외됩니다. 급수의 모든 숫자가 NaN이면 출력값도 NaN입니다.
    리샘플링 시계열을 고정된 수의 점으로 또는 한 주파수에서 다른 주파수로 리샘플링합니다.

    리샘플링 변환을 사용하여 결과 집합의 샘플 수를 줄이면 표시할 샘플 수와 더 근접하게 일치할 수 있습니다.

    인수: 이 변환에 대해 다양한 인수를 전달할 수 있습니다. 다음은 가능한 각 인수 그룹의 목록입니다. 이러한 인수 그룹 중 하나만 단일 변환 내에서 전달할 수 있습니다. 다음 인수 그룹은 AND/OR로 구분됩니다. AND는 인수가 현재 그룹의 일부임을 의미합니다. OR은 새로운 인수 그룹의 시작임을 의미합니다.
    • arg(정수): 결과 세트에 포함할 샘플의 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • arg(기간 데이터 형식): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다.

      및

    • maxValues(정수): 결과 집합에 포함할 샘플의 최대 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • values(정수): 결과 집합에 포함할 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • period(기간 데이터 형식): 리샘플링할 빈도입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다. 이 숫자보다 많은 샘플이 있는 경우 지정된 aggregator 값을 적용하여 줄입니다.

      또는

    • 집계기(집계기 데이터 형식): 리샘플링 시 사용할 집계기입니다.

      및

    • minValues(정수): 결과 집합에 포함할 최소 샘플 수입니다. 사용 가능한 샘플이 이 수보다 작으면 엔드포인트는 보간을 사용하여 추가 샘플을 만듭니다.

      및

    • maxValues(정수): 결과 집합에 포함할 샘플의 최대 수입니다. 이 숫자보다 많은 샘플이 있는 경우 평균을 구하여 샘플을 줄입니다.
    라운드 각 타임 스탬프의 값을 지정된 정밀도로 반올림합니다. (value / <arg>) * <arg>

    인수: arg(10진수 데이터 유형) – 반올림할 10진수 정밀도입니다.
    루트 지정된 인덱스를 사용하여 각 타임스탬프 값의 루트를 계산합니다.

    인수: arg(10진수 데이터 유형) – 루트의 인덱스입니다.

    예를 들어 다음은 각 타임스탬프의 제곱근을 반환합니다.
    "transforms": [
  {
    "name": "root",
    "arg": "2"
  },
]
    표준 개발 계열 집합의 각 타임스탬프 값의 표준 편차가 포함된 계열을 만듭니다.
    하위 각 타임스탬프의 값에서 지정된 숫자를 뺍니다.

    인수: arg(숫자) – 각 타임스탬프의 값에서 뺄 숫자입니다.
    합계 선택한 메트릭 계열을 NaN을 제외한 각 타임스탬프의 모든 값 합계를 포함하는 하나의 계열로 집계합니다. 급수의 모든 숫자가 NaN이면 출력값은 NaN입니다.
    타임시프트 값을 수정하지 않고 값의 타임스탬프에 지정된 오프셋을 추가하여 시간 범위를 이동합니다. 이 변환을 사용하여 타임스탬프를 다른 시간대로 이동합니다.

    인수: arg(기간 데이터 유형) – 이동할 시간의 양입니다.
    상단 가장 높은 값을 가진 지정된 수의 계열을 반환합니다.

    인수: arg(정수) – 반환할 시리즈의 수입니다.

    예를 들어 다음은 가장 높은 값 집합을 포함하는 두 개의 시계열을 반환합니다.
    "transforms": [
  {
     "name": "top",
     "arg": 2
  }
]
    데이터 유형 설명
    집계 변환 내에서 사용할 수 있는 집계기입니다.
    • AVG: 현재 선택된 모든 계열의 산술 평균을 계산합니다.
    • CHISQUARE: 통계 모델이 메트릭 데이터 세트에 얼마나 잘 맞는지 보여줍니다.
    • LAST: 기간 창에서 마지막으로 정의된 값을 반환합니다.
    • MAX: 각 시점에서 메트릭 데이터 세트의 가장 큰 값을 표시합니다.
    • 중앙값: 메트릭 데이터 세트의 중앙값을 표시합니다. 중앙값은 메트릭 데이터 세트의 높은 값과 낮은 값을 구분합니다.
    • MIN: 각 시점에서 메트릭 데이터 세트의 가장 작은 값을 표시합니다.
    • STDDEV: 기본 데이터에서 표준 편차를 계산합니다. 메트릭 데이터 세트에서 데이터 값 세트의 변형 또는 분산을 수량화하는 데 사용됩니다.
    • SUM: 현재 선택된 모든 계열의 합계를 계산합니다.
    날짜/시간 절대 날짜/시간 값은 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초에 걸쳐 균등하게 분산됩니다.

    상대 날짜/시간 값은 현재 시간에서 뺀 기간(Duration 데이터 유형)을 사용하여 지정됩니다.

    예: P7D = 7일 전입니다.
    10진수 10진수 값으로, 다음 중 하나가 될 수 있습니다.
    • 지수 표기법을 사용할 수 있는 임의 정밀도의 부호 있는 10진수입니다.

      같은:

      • 2
      • 1.7
      • -3.47
      • 1.0E+2
    • 문자열 표현:
      • 지수 표기법을 사용할 수 있고 배정밀도 64비트 IEEE 754 부동 소수점 숫자로 보장되는 부호 있는 10진수입니다.
      • "난"
      • "-무한대"
      • "+무한대"
    지속 시간 시간 간격의 시간입니다. 기간 값은 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: 시간(초)입니다.
    예:
    • P7D: 7일의 기간.
    • P1M: 한 달의 기간입니다.
    • PT15M: 15분의 기간.
    • P1DT12H: 1일 12시간의 기간입니다.

    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 Demo 플러그인의 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

    데이터베이스에 시계열 데이터를 MetricBase 추가합니다.

    URL 형식

    버전이 지정된 URL: / api/now/{api_version}/clotho/put

    지원되는 요청 매개변수

    표 33. 경로 매개변수
    이름 설명
    api_version 액세스할 엔드포인트의 버전입니다. 예를 들면 v1 또는 v2입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하려면 이 값만 지정합니다.

    데이터 유형: 문자열
    표 34. 쿼리 매개변수
    이름 설명
    sysparm_ignore_unknown_series 알 수 없는 계열을 무시하고 오류를 반환하지 않고 트랜잭션을 계속할지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 알 수 없는 계열을 무시합니다.
    • false: 알 수 없는 계열을 무시하지 않습니다.

    기본값: true
    표 35. 요청 본문 매개변수(XML 또는 JSON)
    이름 설명
    seriesRef 필수 업데이트할 정보입니다.

    데이터 유형: 배열

    "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'는 선택 사항입니다.
    가치.값 필수 메트릭 값입니다.

    데이터 유형: 숫자

    헤더

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

    표 36. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 37. 응답 헤더
    헤더 설명
    없음

    상태 코드

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

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

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

    이름 설명
    메시지 요청의 상태를 나타내는 메시지입니다(예: 요청이 성공적으로 처리된 경우 확인 ).

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