DataBuilder : dans le champ d’application, global

L’API DataBuilder fournit des méthodes pour créer une série de points de données pour une mesure. Utilisez le sn_clotho. Client.put() pour enregistrer les valeurs.

Vous pouvez appeler cette classe dans les scripts serveur inclus dans le champ d’application et globaux. Lors de l’utilisation de la classe DataBuilder , utilisez l’identificateur d’espace de noms sn_clotho .

Cette classe fait partie de l’application MetricBase .

DataBuilder : DataBuilder (objet glideRecord, objet de chaîne, mesure de chaîne)

Crée une instance de la classe DataBuilder.

Tableau 1. Paramètres

Nom	Type	Description
glideRecord	Objet	GlideRecord à partir duquel obtenir le domaine.
objet	Chaîne	Le sys_id du GlideRecord associé à cette série.
mesure	Chaîne	Le nom de champ de la mesure.

L’exemple suivant initialise une nouvelle instance de DataBuilder à partir de l’espace de noms sn_clotho à l’aide du paramètre now_GR , qui représente l’heure actuelle ou une plage horaire spécifique, et du paramètre de chaîne « cpu_percentage », qui est le nom de la mesure suivie.

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

DataBuilder : add (début GlideDateTime, valeur de tableau)

Ajoute une série de points de données à l’objet DataBuilder. Chaque point de données est un horodatage et une valeur.

Utilise le paramètre de début et la période de collecte de la politique de conservation pour calculer l’horodatage de chaque valeur du tableau. La première valeur a le paramètre de début comme horodatage. Cette méthode n’enregistre pas les données dans la base de données MetricBase. Utilisez le sn_clotho. Client.put() pour enregistrer les valeurs.

Tableau 2. Paramètres

Nom	Type	Description
début	GlideDateTime	Horodatage du premier point de données. Les horodatages suivants sont calculés à l’aide de la période de collecte de la politique de conservation.
valide	Tableau	Un tableau de chiffres.

Tableau 3. Renvoie

Type	Description
Générateur de données	Le même objet DataBuilder.

L’exemple suivant initialise d’abord un tableau (points) contenant trois valeurs numériques : 7, 0,5 et 273, qui représentent différents points de données liés à l’utilisation du processeur à un horodatage donné. Ensuite, le code initialise une nouvelle sn_clotho. L’objet DataBuilder utilisant now_GR (un objet GlideRecord) représente l’enregistrement de base de données cible où ces données sont stockées. « cpu_percentage » est le nom de la mesure utilisé pour suivre l’utilisation du processeur.

Une nouvelle variable d’heure est créée à l’aide de GlideDateTime, qui définit l’objet à la date et à l’heure actuelles. Enfin, le code utilise dataBuilder.add(time, points) pour stocker plusieurs points de données dans l’objet 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 : ajouter (début GlideDateTime, valeur numérique)

Ajoute un point de données à l’objet DataBuilder. Chaque point de données est un horodatage et une valeur. Cette méthode n’enregistre pas le point de données dans la mesure. Utilisez le sn_clotho. Client.put() pour enregistrer les valeurs.

Tableau 4. Paramètres

Nom	Type	Description
début	GlideDateTime	Horodatage du point de données.
valide	Numéro	Valeur du point de données.

Tableau 5. Renvoie

Type	Description
Générateur de données	L’objet DataBuilder

L’exemple suivant initialise d’abord une nouvelle instance de DataBuilder à partir de l’espace de noms sn_clotho à l’aide des paramètres now_GR ( l’enregistrement cible) et « cpu_percentage » (la mesure à suivre). GlideDateTime initialise l’heure à la date et à l’heure actuelles. Enfin, dataBuilder.add() stocke la valeur 0.6 (représentant une valeur de 60 % d’utilisation du processeur) à l’horodatage actuel.

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);