Dados agregados de propriedades e outros ativos (métricas) - AWS IoT SiteWise
Definir métricas (console)Definir métricas (AWS 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á.

Dados agregados 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 Definir 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 obter mais informações, consulte Consulte 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 Objetos de referência com objetos externos IDs 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 recurso de preenchimento automático. Para obter mais informações, consulte Use 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 obter 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 UTC (12:00:00 AM, 01:00:00 AM, 02:00:00 AM e assim por diante).

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

    • 1 semana — 1 semana (7 dias), calculada no final de cada domingo em UTC (todas as 12:00:00 da manhã de 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 é o Tempo Coordenado Universal (UTC).

    • (UTC+ 00:00) Tempo 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 no 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) Horário Padrão do Vietnã

    • (UTC+ 08:00) Fuso horário da China e Taiwan de

    • (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) 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) Horário 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) Horário 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 18h30 (). PST

Para definir um intervalo personalizado com um deslocamento

  1. Em Intervalo de tempo, escolha Intervalo personalizado.

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

  3. Em Data de deslocamento, escolha 20/02/2021.

  4. Em Tempo de deslocamento, insira 18:30:30.

  5. Em Fuso horário Offset, 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 06:30:30 (PST), e assim por diante.

Definir métricas (AWS CLI)

Ao definir uma métrica para um modelo de ativo com o 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 Objetos de referência com objetos externos IDs 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 obter mais informações, consulte Use 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 TumblingWindowna AWS IoT SiteWise APIReferência.

    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 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 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 06:30:30 (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 obter 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 da CreateAssetModelsolicitação para criar uma propriedade métrica. Para obter mais informações, consulte Crie 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 da CreateAssetModelsolicitação para criar uma propriedade 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"
      }
    ],
    ...
}