IoT Platform:Criar uma métrica

Pré-requisitos

Importe as métricas de definição original e adicione termos atômicos. Para mais informações, consulte Importar métricas predefinidas e Adicionar termos atômicos.

Procedimento

1. No console do IoT Platform, acesse a página Overview e clique em ID ou no alias da instância Enterprise Edition desejada.

2. No painel de navegação à esquerda, selecione Data Service > Data Metric e clique em Customize Metric.

3. Acesse a aba All Metrics e clique em Create a Metric.

4. Siga as instruções na tela para configurar a definição da métrica.

   1. Selecione o domínio da nova métrica e escolha a entidade específica e o Derivation Scope conforme as orientações exibidas.

      Parâmetro	Observações
      Esta Entidade	A entidade atual.
      Subentidade	Uma subentidade da entidade atual. Para métricas de definição derivada, selecione uma subentidade. Por exemplo, se a subentidade de um produto for um dispositivo, o sistema calculará a métrica de definição derivada para cada dispositivo individualmente, e não para o produto como um todo.

   2. Use as diretrizes abaixo para definir a métrica.

      Parâmetro	Observações
      Modificador de Tempo	Selecione um modificador de tempo para definir o intervalo de dados estatísticos da nova métrica.
      Termo Atômico	Selecione os termos atômicos adicionados anteriormente no domínio da métrica. Para adicionar termos atômicos, clique em botão Go to Create Atomic Term à direita. Para mais informações, consulte Adicionar termos atômicos.
      Nome da Métrica	O nome da métrica é fixo e combina automaticamente o modificador de tempo com o termo atômico. Exemplo: Average Temperature of the Last 1 Day.
      Unidade de Medida	Selecione o tipo de unidade e a unidade desejada.
      Tipo de Dados	Defina o tipo de dados, precisão, casas decimais e intervalo de valores. Clique em ícone de ajuda para ver descrições detalhadas dos tipos de dados.
      Método de Processamento	Derivado de ativos de métricas existentes. Não é possível modificar este valor.
      É Calculável	Para métricas numéricas acumuláveis, como contagem, quantidade ou frequência, selecione Yes.
      Frequência Estatística	O sistema processa e gera os dados diariamente. Não é possível modificar este valor.
      Data de Expiração	Defina a data de expiração da métrica. Importante Após a expiração da métrica, o agendamento de produção de dados é interrompido.
      Descrição da Métrica	Forneça uma descrição de negócios para a métrica, incluindo geralmente o modificador de tempo e o termo atômico. Exemplo: Time Modifier: Last 1 Day, Atomic Term: Average Temperature

   3. Siga estas instruções para estabelecer as regras de cálculo.

      Método de Cálculo	Observações	Exemplo
      Cálculo Agregado	Selecione uma função de agregação, métrica e operador no menu suspenso. É possível adicionar até 10 expressões.	Por exemplo, ao selecionar a subentidade do domínio de produto, a função COUNT(Count) e a temperatura do produto (od3**), você indica o cálculo da quantidade de registros de temperatura no produto (od3**) por meio de métricas de definição derivada.
      Cálculo por Expressão	Insira a expressão de operação na caixa de entrada. Para funções compatíveis, consulte o Apêndice: Lista de Funções abaixo. Clique em botão Function acima da caixa de entrada para obter instruções e exemplos. A sintaxe da expressão envolve inserir a função de agregação na caixa de entrada, inserir o símbolo $ ou @ no corpo da função, selecionar o domínio da métrica, adicionar um ponto (.), escolher a entidade dentro do domínio da métrica, inserir outro ponto (.) e, finalmente, selecionar a métrica para derivação e cálculo. Os símbolos $ e @ atendem a diferentes tipos de métricas: $: Métricas de definição original e derivada. @: Métricas originais e derivadas. Nota Não há suporte para operadores básicos em expressões de funções de agregação.	Para o produto Sensor de Temperatura e Umidade com 100 dispositivos, incluindo o TH_sensor, a expressão da métrica derivada para Temperatura Média do Último Dia, baseada na métrica original e na definição de Temperatura, é a seguinte: avg($Product.Temperature and Humidity Sensor.Temperature): Calcula a temperatura média em todos os dispositivos do produto usando métricas de definição derivada. avg(@Device.TH_sensor.Temperature): Calcula a temperatura média para o dispositivo TH_sensor usando métricas de definição derivada.

5. Clique em Complete and Publish.

   Visualize as novas métricas concluídas na lista All Metrics.

   Nota

   • Métricas finalizadas com um clique em botão Complete serão marcadas como Unpublished e não coletarão dados.

   • Você pode enviar métricas incompletas para a caixa de rascunhos ao clicar em Enter Draft Box. Isso permite edição posterior e a conclusão do processo de publicação.

6. Opcionalmente, na lista All Metrics, localize a métrica desejada, clique em botão de função na coluna de operações e execute as seguintes ações:

   Nota

   As métricas de definição original limitam-se às funções de visualização e exclusão.

   Operação	Observações
   View	Visualize informações básicas, lógica de cálculo, prévia de dados e outros detalhes da métrica.
   Edit	Modifique a configuração da métrica derivada.
   Unpublish	Reverte a métrica para o status não publicado. Métricas derivadas e serviços relacionados falharão.
   Publish	Torna a métrica disponível publicamente.
   Clone	Duplica a métrica. Na página de clonagem, modifique a definição e as configurações conforme necessário para criar uma nova métrica. Importante Não é possível salvar métricas com configurações idênticas à original.
   Delete	Remove a métrica do sistema. Importante A exclusão de uma métrica falha nas seguintes condições: A métrica possui métricas downstream associadas. A métrica está em uso em relatórios de análise de dados.

Próximos passos

As métricas derivadas representam dados estatísticos de T+1 dia. Para visualizar os dados imediatamente após adicionar novas métricas, inicie manualmente uma tarefa de atualização.

Para instruções detalhadas, consulte Atualização de Métricas.

Apêndice: Lista de Funções