Agregando dados de propriedades e outros ativos (métricas) - AWS IoT SiteWise

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Agregando dados de propriedades e outros ativos (métricas)

Métricas são expressões matemáticas que usam funções de agregação para processar todos os pontos de dados de entrada e gerar um único ponto de dados por intervalo de tempo especificado. Por exemplo, uma métrica pode calcular a temperatura média por hora a partir de um fluxo de dados de temperatura.

As métricas podem inserir dados de métricas de ativos associados, para que você possa calcular estatísticas que fornecem informações sobre sua operação ou um sobre um subconjunto de sua operação. Por exemplo, uma métrica pode calcular a temperatura média horária em todas as turbinas eólicas em um parque eólico. Para obter mais informações sobre como definir associações entre ativos, consulte Definindo relacionamentos entre modelos de ativos (hierarquias).

As métricas também podem inserir dados de outras propriedades sem agregar dados em cada intervalo de tempo. Se você especificar umatributoem uma fórmula,AWS IoT SiteWiseusa omais recentevalor desse atributo quando ele computa a fórmula. Se você especificar uma métrica em uma fórmula,AWS IoT SiteWiseusa oúltimovalor para o intervalo de tempo no qual ele calcula a fórmula. Isso significa que você pode definir métricas comoOEE = Availability * Quality * Performance, ondeAvailability,Quality, ePerformancesão todas as outras métricas no mesmo modelo de ativos.

O AWS IoT SiteWise também calcula automaticamente um conjunto de métricas básicas de agregação para todas as propriedades do ativo. Para reduzir os custos de computação, você pode usar esses agregados em vez de definir métricas personalizadas para cálculos básicos. Para obter mais informações, consulte Consultar agregados de propriedades de ativos.

Definir métricas (console)

Ao definir uma métrica para um modelo de ativo no console do AWS IoT SiteWise, especifique os seguintes parâmetros:

  • Nome— O nome da propriedade.

  • Fórmula— A expressão métrica. Expressões métricas podem usarfunções de agregaçãopara inserir dados de uma propriedade para todos os ativos associados em uma hierarquia. Comece a digitar ou pressione a tecla de seta para baixo para abrir o recurso de preenchimento automático. Para obter mais informações, consulte Usar expressões de fórmula.

    Importante

    As métricas só podem ser propriedades do tipo inteiro, duplo, booleano ou string. Os booleanos se convertem em0(falso) e1(verdadeiro).

    Se você definir quaisquer variáveis de entrada de métrica na expressão de uma métrica, essas entradas deverão ter o mesmo intervalo de tempo que a métrica de saída.

    As expressões de fórmula só podem gerar valores duplos ou de sequência de caracteres. Expressões aninhadas podem gerar outros tipos de dados, como cadeias de caracteres, mas a fórmula como um todo deve ser avaliada como um número ou sequência de caracteres. Você pode usar ofunção jppara converter uma string em um número. O valor booleano deve ser 1 (verdadeiro) ou 0 (falso). Para obter mais informações, consulte Valores indefinidos, infinitos e excedidos.

  • Tipo de dados— O tipo de dados da transformação, que pode serDuploouCorda.

  • Intervalo de tempo— O intervalo de tempo métrico.AWS IoT SiteWisesuporta os seguintes intervalos de tempo de janela giratória, em que cada intervalo começa quando o anterior termina:

    • 1 minuto1 minuto, calculado no final de cada minuto (12:00:00 AM, 12:01:00 AM, 12:02:00 AM e assim por diante).

    • 5 minutos5 minutos, calculados ao final de cada cinco minutos a partir da hora (12:00:00 AM, 12:05:00 AM, 12:10:00 AM e assim por diante).

    • 15 minutos15 minutos, computados ao final de cada quinze minutos a partir da hora (12:00:00 AM, 12:15:00 AM, 12:30:00 AM e assim por diante).

    • 1 hora1 hora (60 minutos), calculada ao final de cada hora em UTC (12:00:00 AM, 01:00:00 AM, 02:00:00 AM e assim por diante).

    • 1 dia1 dia (24 horas), calculado no final de cada dia em UTC (00:00 de segunda-feira, 00:00 de terça-feira e assim por diante).

    • 1 semana1 semana (7 dias), calculada no final de cada domingo em UTC (a cada 12h de segunda-feira).

    • Intervalo personalizado— Você pode inserir qualquer intervalo de tempo entre um minuto e uma semana.

  • Data de compensação— (Opcional) A data de referência a partir da qual agregar dados.

  • Tempo de compensação— (Opcional) A hora de referência a partir da qual agregar dados. O tempo de compensação deve estar entre 00:00:00 e 23:59:59:59.

  • Fuso horário de compensação— (Opcional) O fuso horário da compensação. Se não for especificado, o fuso horário de compensação padrão é o Tempo Coordenado Universal (UTC).

    • (UTC+ 00:00) Horário coordenado universal

    • (UTC+ 01:00) Horário Central Europeu

    • (UTC+ 02:00) Europa Oriental

    • (UTC03+:00) Horário da África Oriental

    • (UTC+ 04:00) Horário do Oriente Próximo

    • (UTC+ 05:00) Fuso horário de Lahore do Paquistão

    • (UTC+ 05:30) Fuso horário padrão da Índia

    • (UTC+ 06:00) Fuso horário padrão de Bangladesh

    • (UTC+ 07:00) Fuso horário padrão do Vietnã

    • (UTC+ 08:00) ChinaTaiwanHora

    • (UTC+ 09:00) Fuso horário padrão do Japão

    • (UTC+ 09:30) Fuso horário da Austrália Central

    • (UTC+ 10:00) Horário do Leste da Austrália

    • (UTC+ 11:00) Fuso horário padrão de Salomão

    • (UTC+ 12:00) Fuso horário padrão da Nova Zelândia

    • (UTC- 11:00) Fuso horário das Ilhas Midway

    • (UTC- 10:00) Horário padrão do Havaí

    • (UTC- 09:00) Fuso horário padrão do Alasca

    • (UTC- 08:00) Horário Padrão do Pacífico

    • (UTC- 07:00) Fuso horário padrão de Phoenix

    • (UTC- 06:00) Horário Padrão Central

    • (UTC- 05:00) Horário Padrão do Leste

    • (UTC- 04:00) Horário de Porto Rico e Ilhas Virgens Americanas

    • (UTC- 03:00) Fuso horário padrão da Argentina

    • (UTC- 02:00) Horário da Geórgia do Sul

    • (UTC- 01:00) Fuso horário da África Central

exemplo intervalo de tempo personalizado com um deslocamento (console)

O exemplo a seguir mostra como definir um intervalo de 12 horas com uma compensação em 20 de fevereiro de 2021, às 18h30 (PST).

Para definir um intervalo personalizado com um deslocamento
  1. ParaIntervalo de tempo, escolhaIntervalo personalizado.

  2. ParaIntervalo de tempo, execute um dos seguintes procedimentos:

    • Entrar12e, em seguida, escolhahoras.

    • Entrar720e, em seguida, escolhaata.

    • Entrar43200e, em seguida, escolhasegundos.

    Importante

    OIntervalo de tempodeve ser um número inteiro, independentemente da unidade.

  3. ParaData de compensação, escolha2021/02/20.

  4. ParaTempo de compensação, insira18:30:30.

  5. ParaFuso horário de compensação, escolha(UTC- 08:00) Horário Padrão do Pacífico.

Se você criar a métrica em 1º de julho de 2021, antes ou às 18h30 (PST), obterá o primeiro resultado de agregação em 1º de julho de 2021, às 18h30 (PST), o segundo resultado de agregação em 2 de julho de 2021, às 06h30 (PST) e assim por diante.

exemplo Exemplo de definição de métrica

O exemplo a seguir demonstra uma propriedade de métrica que agrega os dados de temperatura de um ativo para calcular a temperatura máxima por hora.


                AWS IoT SiteWiseCaptura de tela da página “Criar modelo” com um exemplo de parâmetros de métrica destacados.
exemplo Exemplo de definição de métrica que insere dados de ativos associados

O exemplo a seguir demonstra uma propriedade métrica que agrega os dados de potência média de várias turbinas eólicas para calcular a potência média total de um parque eólico.


                AWS IoT SiteWiseCaptura de tela da página “Criar modelo” com um exemplo de parâmetros de métrica destacados.

Definir métricas (CLI)

Ao definir uma métrica para um modelo de ativo com a API do AWS IoT SiteWise, você especifica os seguintes parâmetros:

  • name— O nome da propriedade.

  • dataType— O tipo de dados da métrica, que pode serDOUBLEouSTRING.

  • expression— A expressão métrica. Expressões métricas podem usarfunções de agregaçãopara inserir dados de uma propriedade para todos os ativos associados em uma hierarquia. Para obter mais informações, consulte Usar expressões de fórmula.

  • window— O intervalo de tempo e o deslocamento da janela de variação da métrica, em que cada intervalo começa quando o anterior termina:

    • interval— O intervalo de tempo para a janela que está caindo. O intervalo de tempo deve estar entre um minuto e uma semana.

    • offsets— O deslocamento da janela que está caindo.

    Para obter mais informações, consulte TumblingWindow na Referência da API do AWS IoT SiteWise.

    exemplo intervalo de tempo personalizado com um deslocamento (AWS CLI)

    O exemplo a seguir mostra como definir um intervalo de 12 horas com uma compensação em 20 de fevereiro de 2021, às 18h30 (PST).

    { "window": { "tumbling": { "interval": "12h", "offset": " 2021-07-23T18:30:30-08" } } }

    Se você criar a métrica em 1º de julho de 2021, antes ou às 18h30 (PST), obterá o primeiro resultado de agregação em 1º de julho de 2021, às 18h30 (PST), o segundo resultado de agregação em 2 de julho de 2021, às 06h30 (PST) e assim por diante.

  • variables— A lista de variáveis que define as outras propriedades do seu ativo ou ativos secundários a serem usadas na expressão. Cada estrutura variável contém um nome simples para uso na expressão e uma estrutura value que identifica qual propriedade deve ser vinculada a essa variável. A estrutura value contém as seguintes informações:

    • propertyId— O ID da propriedade da qual extrair valores. Você pode usar o nome da propriedade em vez do ID se a propriedade estiver definida no modelo atual (em vez de definida em um modelo de uma hierarquia).

    • hierarchyId— (Opcional) O ID da hierarquia a partir da qual consultar ativos secundários da propriedade. Você pode usar o nome da definição de hierarquia em vez do ID. Se você omitir esse valor, o AWS IoT SiteWise localizará a propriedade no modelo atual.

    Importante

    As métricas só podem ser propriedades do tipo inteiro, duplo, booleano ou string. Os booleanos se convertem em0(falso) e1(verdadeiro).

    Se você definir quaisquer variáveis de entrada de métrica na expressão de uma métrica, essas entradas deverão ter o mesmo intervalo de tempo que a métrica de saída.

    As expressões de fórmula só podem gerar valores duplos ou de sequência de caracteres. Expressões aninhadas podem gerar outros tipos de dados, como cadeias de caracteres, mas a fórmula como um todo deve ser avaliada como um número ou sequência de caracteres. Você pode usar ofunção jppara converter uma string em um número. O valor booleano deve ser 1 (verdadeiro) ou 0 (falso). Para obter mais informações, consulte Valores indefinidos, infinitos e excedidos.

  • unit— (Opcional) A unidade científica da propriedade, como mm ou Celsius.

exemplo Exemplo de definição de métrica

O exemplo a seguir demonstra uma propriedade de métrica que agrega dados de medição de temperatura de um ativo para calcular a temperatura máxima por hora em Fahrenheit. Esse objeto é um exemplo de umAssetModelPropertyque contém umMétrica. Você pode especificar esse objeto como parte da carga útil da solicitação CreateAssetModel para criar uma propriedade de métrica. Para obter mais informações, consulte Criar um modelo de ativo (CLI).

{ ... "assetModelProperties": [ ... { "name": "Max temperature", "dataType": "DOUBLE", "type": { "metric": { "expression": "max(temp_f)", "variables": [ { "name": "temp_f", "value": { "propertyId": "Temperature F" } } ], "window": { "tumbling": { "interval": "1h" } } } }, "unit": "Fahrenheit" } ], ... }
exemplo Exemplo de definição de métrica que insere dados de ativos associados

O exemplo a seguir demonstra uma propriedade métrica que agrega os dados de potência média de várias turbinas eólicas para calcular a potência média total de um parque eólico. Esse objeto é um exemplo de umAssetModelPropertyque contém umMétrica. Você pode especificar esse objeto como parte da carga útil da solicitação CreateAssetModel para criar uma propriedade de métrica. Para obter mais informações, consulte Criar um modelo de ativo (CLI).

{ ... "assetModelProperties": [ ... { "name": "Total Average Power", "dataType": "DOUBLE", "type": { "metric": { "expression": "avg(power)", "variables": [ { "name": "power", "value": { "propertyId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE", "hierarchyId": "Turbine Asset Model" } } ], "window": { "tumbling": { "interval": "5m" } } } }, "unit": "kWh" } ], ... }