Agregar dados de propriedades e outros ativos (métricas) - AWS IoT SiteWise
Definir métricas (console)Definir métricas (CLI)

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á.

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

As 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 produzir 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 um atributo em uma fórmula,AWS IoT SiteWise usa o valor mais recente desse atributo ao computar a fórmula. Se você especificar uma métrica em uma fórmula,AWS IoT SiteWise usa o último valor para o intervalo de tempo no qual ela calcula a fórmula. Isso significa que você pode definir métricas comoOEE = Availability * Quality * PerformanceAvailabilityQuality, onde ePerformance sã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. As expressões métricas podem usar funções de agregação para 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 são convertidos 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 em 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 a função jp para 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 ser Double ou String.

  • 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 minuto — 1 minuto, calculado no final de cada minuto (12:00:00 AM, 00:01:00 AM, 00:02:00 AM e assim por diante).

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

    • 15 minutos — 15 minutos, calculados no 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 hora — 1 hora (60 minutos), calculada no final de cada hora em UTC (12:00:00 AM, 01:00 AM, 02:00:00 AM e assim por diante).

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

    • 1 semana — 1 semana (7 dias), calculada no final de cada domingo em UTC (toda segunda-feira às 12h).

    • 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) O tempo de referência a partir do qual agregar dados. O horário de compensação deve ser entre 00:00:00 e 23:59:59.

  • O fuso horário do time stamp — (Opcional) O fuso horário do time stamp. Se não for especificado, o fuso horário padrão do time stamp é o Tempo Universal Coordenado (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) Fuso horário de , Taiwan, China

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

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

    • (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) 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) Fuso horário da Geórgia do Sul

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

exemplo intervalo de tempo personalizado com um offset (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. Em Intervalo de tempo, escolha Intervalo personalizado.

  2. Em Intervalo de tempo, faça o seguinte:

    • Insira e12, em seguida, escolha o horário.

    • Digite e720, em seguida, escolha minutos.

    • Digite e43200, em seguida, escolha segundos.

    Importante

    O intervalo de tempo deve ser um número inteiro, independentemente da unidade.

  3. Em Data de compensação, escolha 2021/02/20.

  4. Em Tempo de compensação, insira18:30:30.

  5. Para Fuso 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 serDOUBLE ouSTRING.

  • expression— A expressão métrica. As expressões métricas podem usar funções de agregação para 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 a compensação da janela de variação da métrica, em que cada intervalo começa quando o anterior termina:

    • interval— O intervalo de tempo da janela rolante. O intervalo de tempo deve estar entre um minuto e uma semana.

    • offsets— O deslocamento da janela rolante.

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

    exemplo intervalo de tempo personalizado com um offset (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 para a 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 são convertidos 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 em 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 a função jp para 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 um AssetModelPropertyque contém uma mé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 um AssetModelPropertyque contém uma mé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"
    }
  ],
  ...
}