Criação de uma definição de série temporal no MetricBase

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Especifique a métrica que você deseja armazenar, a frequência com que quer coletá-la e o prazo em que ela permanecerá armazenada no MetricBase.

    Antes de Iniciar

    Procedimento

    1. Navegar até MetricBase > Métricas de Série de Tempo.
    2. Selecione Novo.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de métrica de série temporal
      Campo Descrição
      Rótulo Nome intuitivo para o nome do campo Métrica. Por exemplo, a altitude pode ser o rótulo do nome do campo de métrica, mb-altitude.
      Nome da tabela Nome da tabela à qual a métrica será adicionada no banco de dados MetricBase. Por exemplo, em MetricBase Demo, a tabela mb_drone armazena os dados do drone. Cada coluna da tabela é uma métrica diferente, por exemplo, altitude, comprimento e velocidade.
      Nome do campo de métrica Nome da métrica de série temporal registrada. Por exemplo, mb-altitude. Você pode pensar nisso como o nome de uma coluna na tabela do banco de dados MetricBase .
      Política de retenção Frequência de amostragem e por quanto tempo MetricBase mantém os valores no banco de dados. Você não pode personalizar o valor. Para obter uma definição dos valores, clique na lupa e em uma política. Quanto mais grosseira for a taxa de amostragem, menos dados serão armazenados. Use a taxa de amostragem mais grosseira que funciona para o seu conjunto de dados. Por exemplo, não colete dados a cada minuto se a coleta uma vez por hora for suficiente. Consulte Políticas de retenção do MetricBase para obter uma descrição das políticas que você pode selecionar.
      Agregador de política de retenção Operador que agrega os dados em um período de amostragem. Por exemplo, último, mínimo, máximo e média.
      Agregador de valor de exibição O método de agregação em uso ao usar <table-name>.list em que <table-name> é uma tabela no banco de dados MetricBase. Este valor não está relacionado à política de retenção. Para obter uma definição das opções, consulte Transformações de MetricBase.
      Exibir duração do valor agregado Duração que é usada para calcular a agregação somente ao usar a exibição de lista. Por exemplo, <table-name>.list em que <table-name> é uma tabela no banco de dados MetricBase. Este valor não está relacionado à política de retenção.
      Campo de assunto Você pode selecionar uma coluna de tabela exclusiva como assunto para a métrica. A coluna exclusiva deve ser designada na tabela antes de ser selecionada. Por exemplo, se a sua métrica rastreia as temperaturas em casas diferentes, você pode tornar a coluna de endereço da casa o assunto da sua métrica. A coluna de endereço interno em sua tabela deve ser exclusiva antes de você definir o campo de assunto.
      Nota:
      A coluna sys_id é a coluna exclusiva padrão.
      Tipo de Dados Você pode especificar o tipo de dados do campo de assunto.
    4. Selecione Enviar.

    Resultado

    Você criou uma especificação de série de tempo para uma métrica que deseja rastrear.

    O que Fazer Depois

    Faça uma amostragem dos dados de acordo com a especificação da série temporal e os envie de uma instância para o servidor de banco de dados do MetricBase.

    Use as APIs REST ou JavaScript para enviar dados ao banco de dados MetricBase na taxa prescrita pela definição da série temporal. Consulte Recursos do desenvolvedor.

    Importante:
    Envie os dados na taxa prescrita pela definição da série de tempo. Se você enviar os dados em uma taxa diferente ou por uma duração diferente, receberá um erro. Agregue os dados de acordo com a definição da métrica da série temporal. Além disso, o banco de dados MetricBase armazena somente valores do tipo de dados flutuante.