---
sourceDocument: Xanadu API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - ko-KR

ft:publication_title :

    - Xanadu API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 클라이언트 - 범위, 전역

# 클라이언트 - 범위, 전역 {#ariaid-title1}

* 릴리스 버전: Xanadu
* 
* 업데이트 날짜 2024년 08월 01일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 6분

클라이언트 API는 데이터베이스에 데이터를 MetricBase 추가하고, 데이터베이스에서 MetricBase 변환을 실행하고, 변환 결과를 수신하는 메서드를 제공합니다.

Client 클래스는 범위가 지정된 서버 스크립트와 전역 서버 스크립트 모두에서 사용할 수 있습니다. 이 클래스는 응용 프로그램의 일부 MetricBase 이며 `sn_clotho` 네임스페이스 내에서 실행되어야 합니다.

## 클라이언트 - Client() {#ariaid-title2}

클라이언트 클래스의 인스턴스를 만들어 데이터베이스에 액세스합니다 MetricBase .
{#ClientS-Client__table_pzg_hvz_31b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 없음 |   |   |
[표 1. 매개변수]

{#ClientS-Client__table_pzg_hvz_31b}  

    var client = new sn_clotho.Client();

## 클라이언트 - 누적(GlideRecord now_GR, 문자열 메트릭) {#ariaid-title3}

지정된 타임스탬프로 메트릭 값을 누적하고 값을 덮어쓰지 않고 데이터베이스에 결과를 저장합니다.
이 방법 사용 사용하여 킬로와트시(kWhs)의 전기와 같이 누적에 대해 합산할 수 있는 메트릭을 처리합니다. 누적은 제공된 타임스탬프에서 각 메트릭을 호출합니다. 예를 들어, 히터, 전기 주전자 및 세탁기에 대해 수집된 킬로와트는 누적되는 데 세 번의 호출이 발생합니다.
{#ClientS-accumulate_GR_N__table_zsz_5jd_1db__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| now_GR | GlideRecord | 누적 값을 가져올 GlideRecord 계열의 이름입니다. 참고 항목: [getSeries()](https://servicenow-prod.fluidtopics.net/tGIF7kVLoFMddV0oKS_JpA#ClientS-getSeries_O_S_O "특정 차원에서 모든 계열을 가져옵니다.") |
| default_value | 번호 | 옵션입니다. 지정된 타임스탬프에서 누적의 기본값입니다. 지정된 타임스탬프에 값을 사용할 수 없는 경우 첫 번째 호출 중에만 누적됩니다. 사용 사례는 total_power에 대한 와트 메트릭을 누적하는 것일 수 있습니다. 측정할 파워 미터가 없는 콘센트에 연결된 라우터의 와트를 축적하려고 합니다. 소비 값을 알고 있고 상수인 경우), 상수 값을 기본값으로 사용하여 total_power 누적할 수 있습니다. 예를 들어 라우터가 지속적으로 연결되어 있고 20와트를 소비하는 경우 20을 사용합니다. 타임스탬프 값은 [DataBuilder](https://servicenow-prod.fluidtopics.net/xnVq1fbW2ULDoKLXcaCNGA#DataBuilderScopedAPI "DataBuilder API는 메트릭에 대한 일련의 데이터 포인트를 생성하는 메서드를 제공합니다. sn_clotho 사용합니다 . Client.put() 메서드를 사용하여 값을 저장할 수 있습니다.") API를 사용하여 제공할 수 있습니다. 기본값: 0 |
[표 2. 매개변수]

{#ClientS-accumulate_GR_N__table_zsz_5jd_1db} {#ClientS-accumulate_GR_N__table_atz_5jd_1db__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 3. 반환]

{#ClientS-accumulate_GR_N__table_atz_5jd_1db}  
다음 예는 `building_a`라는 레코드에 `total_power` 메트릭 값을 누적하는 방법을 보여줍니다.

    var time = new GlideDateTime();

    // total_power is the name of a metric within building_a which stores accumulated values

    var dataBuilder1 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder1.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder1, 0);

    var dataBuilder2 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder2.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder2, 0);

    var dataBuilder3 = new sn_clotho.DataBuilder(building_a, "total_power");
    // values to be accumulated
    dataBuilder3.add(time, 3.5);
    new sn_clotho.Client().accumulate(dataBuilder3, 0);

    // As a result of these operations client will save value of
    // 3.5+12+4.3+0(default value) at the timestamp 'time'

## 클라이언트 - deleteMetric(String tableName, String metricName) {#ariaid-title4}

데이터베이스의 지정된 테이블에서 지정된 메트릭을 MetricBase 제거합니다
주:  
이 메서드는 데이터베이스에서 MetricBase 데이터를 삭제합니다. 복구 메커니즘이 없습니다.
{#ClientS-deleteMetric_S_S__table_zsz_5jd_1db__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| tableName | 문자열 | 지정된 메트릭이 삭제될 테이블의 이름입니다. |
| metricName | 문자열 | 메트릭의 이름입니다. |
[표 4. 매개변수]

{#ClientS-deleteMetric_S_S__table_zsz_5jd_1db} {#ClientS-deleteMetric_S_S__table_atz_5jd_1db__entry__2}

| 유형 | 설명 |
|-|-|
| 없음 |   |
[표 5. 반환]

{#ClientS-deleteMetric_S_S__table_atz_5jd_1db}  
다음 예제에서는 테이블에서 메트릭을 제거하는 방법을 보여 줍니다.

    var client = new sn_clotho.Client();

    // delete metric (Speed) from the Drones table
    client.deleteMetric("mb_demo_drone", "mb_demo_mt_speed");

## 클라이언트 - deleteSeries(GlideRecord now_GR, 문자열 메트릭) {#ariaid-title5}

지정된 GlideRecord에서 지정된 메트릭과 연결된 데이터베이스의 데이터를 MetricBase 제거합니다. 테스트 데이터를 제거하는 데 이 방법을 사용합니다.
주:  
이 메서드는 데이터베이스에서 MetricBase 데이터를 삭제합니다. 복구 메커니즘이 없습니다.
{#ClientS-deleteSeries_GR_S__table_zsz_5jd_1db__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| now_GR | GlideRecord | 지정된 메트릭에 대한 시계열 데이터가 삭제될 기록입니다. |
| 메트릭 | 문자열 | 메트릭의 이름입니다. |
[표 6. 매개변수]

{#ClientS-deleteSeries_GR_S__table_zsz_5jd_1db} {#ClientS-deleteSeries_GR_S__table_atz_5jd_1db__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 7. 반환]

{#ClientS-deleteSeries_GR_S__table_atz_5jd_1db}  

    var client = new sn_clotho.Client();
    //query drones of a specific model
    var drones = new GlideRecord("mb_demo_drone");
    drones.addQuery("model", "Kingfisher Phantom");
    drones.query();

    client.deleteSeries(drones, 'mb_demo_mt_speed');

## 클라이언트 - getSeries(GlideRecord now_GR, String metricName, GlideDateTime lastUpdateBefore) {#ariaid-title6}

특정 차원에서 모든 계열을 가져옵니다.
{#ClientS-getSeries_O_S_O__table_zsz_5jd_1db__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| now_GR | [GlideRecord](https://servicenow-prod.fluidtopics.net/2W~ifl1LvyXJ6zdY~n~R1Q#c_GlideRecordScopedAPI "범위가 지정된 GlideRecord API는 데이터베이스 운영에 사용됩니다.") | 계열을 가져올 레코드입니다. |
| 메트릭 | 문자열 | 메트릭의 이름입니다. |
| lastUpdateBefore | [GlideDateTime](https://servicenow-prod.fluidtopics.net/NwMMt_1~FgRp~tItiAEjOQ#c_GlideDateTimeScoped "범위가 지정된 GlideDateTime 클래스는 GlideDateTime 개체에 대한 작업을 수행하기 위한 메서드를 제공합니다.") | 옵션입니다. 평가할 기간의 끝을 나타내는 미래의 날짜입니다. |
[표 8. 매개변수]

{#ClientS-getSeries_O_S_O__table_zsz_5jd_1db} {#ClientS-getSeries_O_S_O__table_atz_5jd_1db__entry__2}

| 유형 | 설명 |
|-|-|
| 배열 | 지정된 메트릭에 대한 데이터가 포함된 계열을 나타내는 문자열 sys_ids 목록입니다. lastUpdateBefore 매개 변수가 제공되면 lastUpdateBefore 날짜보다 최신의 데이터가 없는 계열을 반환합니다(비포함). |
[표 9. 반환]

{#ClientS-getSeries_O_S_O__table_atz_5jd_1db}  
다음 예제에서는 드론 \[mb_demo_drone\] 테이블에 나열된 속도 값의 전체 목록을 가져오는 방법을 보여 줍니다.

    var client = new sn_clotho.Client();

    // query subject records
    var grDrone = new GlideRecord('mb_demo_drone');
    grDrone.query();

    var series = client.getSeries(grDrone,'mb_demo_mt_speed');

## 클라이언트 - put(Object metricData) {#ariaid-title7}

메트릭 데이터를 MetricBase 데이터베이스에 저장합니다.
{#ClientS-put_DB__table_vxt_wvz_31b__entry__3}

| 이름 | 유형 | 설명 |
|-|-|-|
| 메트릭데이터 | 객체 | 다음 중 하나입니다. * 메트릭 데이터를 포함하는 [DataBuilder](https://servicenow-prod.fluidtopics.net/xnVq1fbW2ULDoKLXcaCNGA#DataBuilderScopedAPI "DataBuilder API는 메트릭에 대한 일련의 데이터 포인트를 생성하는 메서드를 제공합니다. sn_clotho 사용합니다 . Client.put() 메서드를 사용하여 값을 저장할 수 있습니다.") 객체입니다. * 메트릭 데이터를 포함하는 DataBuilder 객체의 배열입니다. {#ClientS-put_DB__ul_ldw_bbh_yjb} |
[표 10. 매개변수]

{#ClientS-put_DB__table_vxt_wvz_31b} {#ClientS-put_DB__table_wxt_wvz_31b__entry__2}

| 유형 | 설명 |
|-|-|
| void |   |
[표 11. 반환]

{#ClientS-put_DB__table_wxt_wvz_31b}  

    var time = new GlideDateTime();
    ​
    // two different GlideRecord instances and metrics
    var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
    dataBuilder.add(time, 0.6);
    ​
    var dataBuilder2 = new sn_clotho.DataBuilder(gr2, 'disk_free_percentage');
    dataBuilder2.add(time, 0.2);
    ​
    new sn_clotho.Client().put([dataBuilder,dataBuilder2]);