DataBuilder - 범위 지정, 전역

DataBuilder API는 메트릭에 대한 일련의 데이터 포인트를 생성하는 메서드를 제공합니다. sn_clotho 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.

범위가 지정된 스크립트와 전역 서버 스크립트에서 이 클래스를 호출할 수 있습니다. DataBuilder 클래스를 사용하는 경우 sn_clotho 네임스페이스 식별자를 사용합니다.

이 클래스는 애플리케이션의 일부입니다 MetricBase .

DataBuilder - DataBuilder(객체 glideRecord, 문자열 제목, 문자열 메트릭)

DataBuilder 클래스의 인스턴스를 작성합니다.

표 1. 매개변수

이름	유형	설명
glideRecord	객체	도메인을 가져올 GlideRecord입니다.
주제	문자열	이 계열과 연결된 GlideRecord의 sys_id입니다.
메트릭	문자열	메트릭의 필드 이름입니다.

다음 예제에서는 현재 시간 또는 특정 시간 범위를 나타내는 now_GR 매개 변수와 추적 중인 메트릭의 이름인 문자열 매개 변수 'cpu_percentage'를 사용하여 sn_clotho 네임스페이스에서 DataBuilder의 새 인스턴스를 초기화합니다.

// Where cpu_percentage is the name of the metric
        var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');

DataBuilder - add(GlideDateTime 시작, 배열 값)

DataBuilder 개체에 일련의 데이터 요소를 추가합니다. 각 데이터 요소는 타임스탬프이자 값입니다.

start 매개변수와 보존 정책 수집 기간을 사용하여 배열의 각 값에 대한 타임스탬프를 계산합니다. 첫 번째 값에는 타임스탬프로 start 매개변수가 있습니다. 이 메서드는 MetricBase 데이터베이스에 데이터를 저장하지 않습니다. sn_clotho 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.

표 2. 매개변수

이름	유형	설명
시작	Glide날짜/시간	첫 번째 데이터 요소의 타임스탬프입니다. 후속 타임 스탬프는 보존 정책 수집 기간을 사용하여 계산됩니다.
값	배열	숫자 배열입니다.

표 3. 반환

유형	설명
데이터 빌더	동일한 DataBuilder 객체입니다.

다음 예제에서는 먼저 지정된 타임스탬프에서 CPU 사용량과 관련된 서로 다른 데이터 요소를 나타내는 7, 0.5 및 273의 세 가지 숫자 값을 포함하는 배열(points)을 초기화합니다. 그런 다음 코드는 새 sn_clotho 초기화합니다. now_GR 사용하는 DataBuilder 객체(GlideRecord 객체)는 이 데이터가 저장되는 대상 데이터베이스 기록을 나타냅니다.'cpu_percentage'는 CPU 사용량을 추적하는 데 사용되는 메트릭 이름입니다.

객체를 현재 날짜 및 시간으로 설정하는 GlideDateTime을 사용하여 새 시간 변수가 생성됩니다. 마지막으로 이 코드는 dataBuilder.add(time, points) 를 사용하여 Data Builder 개체에 여러 데이터 요소를 저장합니다.

var points = [7,0.5,273];
var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, points);

DataBuilder - add(GlideDateTime 시작, 숫자 값)

DataBuilder 개체에 데이터 요소를 추가합니다. 각 데이터 요소는 타임스탬프이자 값입니다. 이 메서드는 메트릭에 데이터 요소를 저장하지 않습니다. sn_clotho 사용합니다 . Client.put() 메서드를 사용하여 값을 저장합니다.

표 4. 매개변수

이름	유형	설명
시작	Glide날짜/시간	데이터 요소에 대한 타임스탬프입니다.
값	번호	데이터 요소의 값입니다.

표 5. 반환

유형	설명
데이터 빌더	DataBuilder 객체입니다.

다음 예에서는 먼저 now_GR(대상 기록) 및 'cpu_percentage'(추적할 메트릭) 매개변수를 사용하여 sn_clotho 네임스페이스에서 DataBuilder의 새 인스턴스를 초기화합니다. GlideDateTime 은 시간을 현재 날짜 및 시간으로 초기화합니다. 마지막으로 dataBuilder.add() 는 현재 타임스탬프에 값 0.6 (CPU 사용량 60% 값을 나타냄)을 저장합니다.

var dataBuilder = new sn_clotho.DataBuilder(now_GR, 'cpu_percentage');
// this creates a GlideDateTime object set to the current date and time
var time = new GlideDateTime();
dataBuilder.add(time, 0.6);