Definir métricas (console)Definindo métricas (AWS CLI)

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

As métricas são expressões matemáticas que usam funções agregadas 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 entrada de ativos associados, para que você possa calcular estatísticas que forneçam informações sobre sua operação ou sobre um subconjunto da 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 hierarquias de modelos de ativos.

As métricas também podem inserir dados de entrada de outras propriedades sem agregar dados a 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 durante o qual ela calcula a fórmula. Isso significa que você pode definir métricas como OEE = Availability * Quality * Performance, onde Availability, Quality e Performance são todas as outras métricas no mesmo modelo de ativos.

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 ter mais informações, consulte Consultando agregados de propriedades de ativos.

Definir métricas (console)

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

Nome — o nome da propriedade.
Tipo de dado — tipo de dado da transformação, que pode ser Duplo ou String.
ID externa — (Opcional) Essa é uma ID definida pelo usuário. Para obter mais informações, consulte Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .
Fórmula — a expressão métrica. As expressões métricas podem usar funções de agregação para inserir dados de entrada de uma propriedade para todos os ativos associados em uma hierarquia. Comece digitando ou pressionando a seta para baixo para abrir o atributo de preenchimento automático. Para ter mais informações, consulte Usando expressões de fórmula.

Importante
Métricas só podem inserir propriedades do tipo inteiro, duplo, Booleano ou string. Os Booleanos são convertidos em 0 (falso) e 1 (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 produzir valores duplos ou de string. Expressões aninhadas podem gerar outros tipos de dados, como strings, mas a fórmula como um todo deve ser avaliada como um número ou string. 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 ter mais informações, consulte Valores indefinidos, infinitos e excedidos.
Intervalo de tempo – tempo de intervalo métrico. AWS IoT SiteWise é compatível com a seguinte janela em cascata de intervalos de tempo, onde cada intervalo começa quando o anterior termina:
- 1 minuto – 1 minuto, calculado no final de cada minuto (00:00:00, 00:01:00, 00:02:00 e assim por diante).
- 5 minutos – 5 minutos, calculados no final de cada cinco minutos a partir da hora (00:00:00, 00:05:00, 00:10:00 e assim por diante).
- 15 minutos – 15 minutos, calculados no final de cada quinze minutos a partir da hora (00:00:00, 00:15:00, 00:30:00 e assim por diante).
- 1 hora – 1 hora (60 minutos), calculada no final de cada hora em UTC (00:00:00, 01:00:00, 02:00:00 e assim por diante).
- 1 dia – 1 dia (24 horas), calculado no final de cada dia em UTC (00:00:00 segunda-feira, 00:00:00 terça-feira e assim por diante).
- 1 semana – 1 semana (7 dias), calculada no final de cada domingo em UTC (a cada 00:00:00 segunda-feira).
- Intervalo personalizado — você pode inserir qualquer intervalo de tempo entre um minuto e uma semana.
Data de deslocamento — (opcional) data de referência a partir da qual agregar dados.
Tempo de deslocamento — (opcional) horário de referência a partir do qual agregar dados. O horário de deslocamento deve ser entre 00:00:00 e 23:59:59.
Fuso horário de deslocamento — (opcional) fuso horário do deslocamento. Se não for especificado, o fuso horário de compensação padrão é Horário Universal Coordenado (UTC).
- (UTC+ 00:00) Tempo Universal Coordenado
- (UTC+ 01:00) Hora Central Europeia
- (UTC+ 02:00) Leste Europeu
- (UTC+ 03:00) Hora da África Oriental
- (UTC+ 04:00) Hora do Oriente Próximo
- (UTC+ 05:00) Horário de Lahore, no Paquistão
- (UTC+ 05:30) Horário padrão da Índia
- (UTC+ 06:00) Horário padrão de Bangladesh
- (UTC+ 07:00) Horário padrão do Vietnã
- (UTC+ 08:00) Hora China Taipei
- (UTC+ 09:00) Horário Padrão do Japão
- (UTC+ 09:30) Hora Central da Austrália
- (UTC+ 10:00) Horário do Leste da Austrália
- (UTC+ 11:00) Horário Padrão de Salomão
- (UTC+ 12:00) 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) Horário padrão do Alasca
- (UTC- 08:00) Hora padrão do Pacífico
- (UTC- 07:00) 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 dos EUA
- (UTC- 03:00) Horário Padrão da Argentina
- (UTC- 02:00) Hora da Geórgia do Sul
- (UTC- 01:00) 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 um deslocamento em 20 de fevereiro de 2021, às 18:30:30 (PST).

Para definir um intervalo personalizado com um deslocamento

Em Intervalo de tempo, escolha Intervalo personalizado.
Para Intervalo de tempo, execute uma das opções a seguir:
- Insira 12 e escolha horas.
- Insira 720 e escolha minutos.
- Insira 43200 e escolha segundos.
Importante
O intervalo de tempo deve ser um número inteiro, independente da unidade.
Em Data de deslocamento, escolha 20/02/2021.
Em Tempo de deslocamento, insira 18:30:30.
Em Fuso horário de deslocamento, 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 da agregação em 1º de julho de 2021, às 18h30 (PST). O segundo resultado da agregação é em 2 de julho de 2021, às 06h30 (PST), e assim por diante.

Definindo métricas (AWS CLI)

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

name – o nome da propriedade.
dataType — tipo de dados da métrica, que pode ser DOUBLE ou STRING.
externalId— (Opcional) Essa é uma ID definida pelo usuário. Para obter mais informações, consulte Referenciando objetos com IDs externos no Guia de Usuário AWS IoT SiteWise .
expression — a expressão métrica. As expressões métricas podem usar funções de agregação para inserir dados de entrada de uma propriedade para todos os ativos associados em uma hierarquia. Para ter mais informações, consulte Usando expressões de fórmula.
window — intervalo de tempo e deslocamento da janela de queda da métrica, onde cada intervalo começa quando o anterior termina:
- interval – intervalo de tempo da janela em cascata. O intervalo de tempo deve estar entre um minuto e uma semana.
- offsets – deslocamento da janela em cascata.
Para obter mais informações, consulte TumblingWindow na Referência de APIs 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 um deslocamento em 20 de fevereiro de 2021, às 18:30:30 (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 da agregação em 1º de julho de 2021, às 18h30 (PST). O segundo resultado da agregação é em 2 de julho de 2021, às 06h30 (PST), e assim por diante.
variables – uma lista de que define as outras propriedades de seu ativo ou ativos filho a serem usados 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 à variável. A estrutura value contém as seguintes informações:
- propertyId – ID da propriedade da qual deseja extrair valores. Você pode usar o nome da propriedade em vez da ID se a propriedade for definida no modelo atual (em vez de definida em um modelo de uma hierarquia).
- hierarchyId – (opcional) ID da hierarquia da qual consultar ativos filhos para a propriedade. Você pode usar o nome da definição de hierarquia em vez da ID. Se você omitir esse valor, AWS IoT SiteWise localizará a propriedade no modelo atual.
Importante
Métricas só podem inserir propriedades do tipo inteiro, duplo, Booleano ou string. Os Booleanos são convertidos em 0 (falso) e 1 (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 produzir valores duplos ou de string. Expressões aninhadas podem gerar outros tipos de dados, como strings, mas a fórmula como um todo deve ser avaliada como um número ou string. 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 ter mais informações, consulte Valores indefinidos, infinitos e excedidos.
unit – (opcional) 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 ter mais informações, consulte Criação de um modelo de ativo (AWS 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 entrada de ativos associados

O exemplo a seguir demonstra uma propriedade métrica que agrega múltiplos dados de potência média de 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.


{
      ...
      "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"
      }
    ],
    ...
}

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Transformando dados (transformações)

Usando expressões de fórmula

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

Tópicos

Definir métricas (console)

Importante

exemplo intervalo de tempo personalizado com um deslocamento (console)

Para definir um intervalo personalizado com um deslocamento

Importante

Definindo métricas (AWS CLI)

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

Importante

exemplo Exemplo de definição de métrica

exemplo Exemplo de definição de métrica que insere dados de entrada de ativos associados