Este tópico define métricas, domínios de métrica e tipos de métrica.
Métrica
Uma métrica, também conhecida como medida, é um padrão para mensurar mudanças ou evoluções. Exemplos incluem temperatura, população, PIB, receita, número de usuários, margem de lucro, taxa de retenção e taxa de cobertura.
Domínio de métrica
O domínio de métrica é o objeto associado a uma métrica, usado para categorizar e gerenciar métricas. O IoT Data Service oferece dois domínios de métrica: produto e dispositivo.
Tipo de métrica
-
Definição original
As métricas de definição original derivam do modelo de coisa (thing model) de um produto no IoT Platform.
No console do IoT Platform, acesse Device Management > Product, selecione um produto para abrir a página Product Details e clique em Function Definition para visualizar o modelo de coisa definido.
-
Métrica bruta
As métricas brutas originam-se das propriedades que os dispositivos reportam ao IoT Platform ou das propriedades analisadas a partir de tópicos personalizados.
No console do IoT Platform, acesse Device Management > Device para abrir a página Device Details. Clique em TSL Data para visualizar as propriedades. Por exemplo, na página Device Details, escolha TSL Data > Running Status para ver as propriedades reportadas por um dispositivo, como métricas de um instrumento de medição de parâmetros elétricos: potência de carga (28 kW), corrente operacional (15 A) e tensão (20 V).
-
Definição derivada
A definição derivada baseia-se em uma definição original e aplica-se às subentidades de um produto.
Assim como a definição original, a definição derivada é uma definição de propriedade e não possui um valor de dados específico.
Os dados agregados tornam-se o valor da métrica derivada de cada dispositivo.
A definição derivada de um produto e a métrica derivada de cada dispositivo sob esse produto compartilham o mesmo metric code.
-
Métrica derivada
A métrica derivada é calculada a partir de métricas brutas, definições originais ou definições derivadas por meio de métodos de agregação, como soma e média.
Para uma métrica derivada, um modificador de tempo define o intervalo de tempo de agregação (restrição temporal), enquanto modificadores de negócio definem outras restrições.
Portanto, uma métrica derivada consiste em três elementos: modificador de tempo (obrigatório) + modificador de negócio (opcional) + métrica atômica (obrigatória).
Para saber como adicionar uma métrica, consulte Adicionar métrica.
Aplicabilidade dos tipos de métrica
A tabela a seguir mostra quais tipos de métrica têm suporte em cada domínio de métrica.
|
Tipo |
Produto |
Dispositivo |
|
Definição original |
Suportado |
Não suportado |
|
Métrica bruta |
Não suportado |
Suportado |
|
Definição derivada |
Suportado |
Não suportado |
|
Métrica derivada |
Suportado |
Suportado |
Um dispositivo vinculado a um produto pode incluir métricas dos tipos definição derivada e métrica derivada.
Por exemplo, considere uma definição derivada para o produto PK1 chamada Average Temperature in the Last 24 Hours. Esse produto possui 100 dispositivos, denominados DNn (onde n=1 a 100). Criar uma métrica derivada Average Temperature in the Last 24 Hours separada para cada dispositivo exigiria repetir a configuração 100 vezes. No entanto, criar uma única definição derivada para o produto PK1 gera automaticamente a métrica derivada Average Temperature in the Last 24 Hours para todos os 100 dispositivos.