Todos os produtos
Search
Central de documentação

IoT Platform:Métricas

Última atualização: Jun 26, 2026

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.