DataBuilder - Com escopo, global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 3 min. de leitura
  • . Construtor de dados A API fornece métodos para criar uma série de pontos de dados para uma métrica. Use sn_clotho.Client.put() método para salvar os valores.

    Você pode chamar esta classe em scripts de servidor com escopo e globais. Ao usar o. Construtor de dados classe, use sn_clotho identificador de namespace.

    Esta classe faz parte de MetricBase aplicação.

    DataBuilder - DataBuilder (objeto glideRecord, assunto de cadeia de caracteres, métrica de cadeia de caracteres)

    Cria uma instância da classe DataBuilder.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    GlideRecord Objeto GlideRecord do qual obter o domínio.
    assunto Cadeia de caracteres O sys_id do GlideRecord associado a esta série.
    métrica Cadeia de caracteres O nome do campo da métrica.

    O exemplo a seguir inicializa uma nova instância de Construtor de dados em sn_clotho namespace usando Now_GR parâmetro, que representa a hora atual ou um intervalo de tempo específico e o parâmetro de cadeia de caracteres "cpu_percentage" , que é o nome da métrica que está sendo rastreada.

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

    DataBuilder - adicionar (início GlideDateTime, valor de matriz)

    Adiciona uma série de pontos de dados ao objeto DataBuilder. Cada ponto de dados é um carimbo de data/hora e um valor.

    Usa o parâmetro de início e o período de coleta da política de retenção para calcular o carimbo de data/hora de cada valor na matriz. O primeiro valor tem o parâmetro de início como o carimbo de data/hora. Este método não salva os dados no banco de dados MetricBase. Use sn_clotho.Client.put() método para salvar os valores.

    Tabela 2. Parâmetros
    Nome Tipo Descrição
    início GlideDateTime O carimbo de data/hora do primeiro ponto de dados. Carimbos de data/hora subsequentes são calculados usando o período de coleta da política de retenção.
    valor Matriz Uma matriz de números.
    Tabela 3. Retornos
    Tipo Descrição
    Construtor de dados O mesmo objeto DataBuilder.

    Primeiro, o exemplo a seguir inicializa uma matriz (pontos) que contém três valores numéricos: 7, 0,5 e 273, que representam diferentes pontos de dados relacionados ao uso da CPU em um determinado carimbo de data/hora. Em seguida, o código inicializa um novo sn_clotho.DataBuilder objeto usando Now_GR (Um objeto GlideRecord) Representa o registro do banco de dados de destino em que esses dados estão sendo armazenados. "cpu_percentage" É o nome da métrica usado para rastrear o uso da CPU.

    Uma nova variável de tempo é criada usando GlideDateTime, que define o objeto como a data e a hora atuais. Por fim, o código usa DataBuilder.add (tempo, pontos) Para armazenar vários pontos de dados no objeto Construtor de dados.

    
    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 - adicionar (início GlideDateTime, valor numérico)

    Adiciona um ponto de dados ao objeto DataBuilder. Cada ponto de dados é um carimbo de data/hora e um valor. Este método não salva o ponto de dados na métrica. Use sn_clotho.Client.put() método para salvar os valores.

    Tabela 4. Parâmetros
    Nome Tipo Descrição
    início GlideDateTime O carimbo de data/hora do ponto de dados.
    valor Número O valor do ponto de dados.
    Tabela 5. Retornos
    Tipo Descrição
    Construtor de dados O objeto DataBuilder.

    Primeiro, o exemplo a seguir inicializa uma nova instância de Construtor de dados em sn_clotho namespace usando os parâmetros Now_GR (o registro de destino) e. "cpu_percentage" (a métrica a ser rastreada). GlideDateTime inicializa a hora até a data e hora atuais. Por fim, DataBuilder.add() armazena o valor 0,6 (Representando um valor de 60% de uso de CPU) no carimbo de data/hora atual.

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