Consultar agregados e valores de propriedade de ativos - AWS IoT SiteWise
Consultar valores atuaisConsultar valores históricosConsultar agregados

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

Consultar agregados e valores de propriedade de ativos

É possível usar as operações da API do AWS IoT SiteWise para consultar valores atuais, valores históricos e agregados das propriedades de ativos em intervalos de tempo específicos. É possível usar esses recursos para obter insights rápidos ou para desenvolver soluções de software que se integram aos dados industriais armazenados nos ativos do AWS IoT SiteWise.

Também é possível explorar os dados de ativos em tempo real no AWS IoT SiteWise Monitor. Para saber como configurarSiteWiseMonitore, consulteMonitorar dados com o AWS IoT SiteWise Monitor.

As operações descritas nesta seção retornam objetos de valor de propriedade que contêm estruturas de timestamp, qualidade e valor (TQV).

  • O timestamp contém o horário epoch Unix atual em segundos, com correção em nanossegundos.

  • quality contém uma das seguintes strings que indicam a qualidade do ponto de dados:

    • GOOD— Os dados não são afetados por nenhum problema.

    • BAD— Os dados são afetados por um problema, como falha no sensor.

    • UNCERTAIN— Os dados são afetados por um problema como a imprecisão do sensor.

  • O value contém um dos campos a seguir, dependendo do tipo de propriedade:

    • booleanValue

    • doubleValue

    • integerValue

    • stringValue

Consultar valores atuais de propriedade de ativos

Você pode usar o console ou a API do AWS IoT SiteWise para obter o valor atual de uma propriedade de ativo.

Consultar o valor atual de uma propriedade de ativo (console)

Você pode usar o console do AWS IoT SiteWise para exibir o valor atual de uma propriedade de ativo.

Como obter o valor atual de uma propriedade de ativo (console)

  1. Navegue até o console do AWS IoT SiteWise.

  2. No painel de navegação, selecione Ativos.

  3. Escolha o ativo com a propriedade a ser consultada.

    dica

    Você pode escolher o ícone de seta para expandir uma hierarquia de ativos para localizar seu ativo.

  4. Escolha a guia do tipo de propriedade. Por exemplo, escolha Medições para visualizar o valor atual de uma propriedade de medição.

    AWS IoT SiteWiseCaptura de tela das guias de propriedades da página “Ativo”.

  5. Encontre a propriedade a ser visualizada. O valor atual aparece na coluna Valor mais recente.

Consultar o valor atual de uma propriedade de ativo (CLI)

Você pode usar a AWS Command Line Interface (AWS CLI) para consultar o valor atual de uma propriedade de ativo.

Use oGetAssetPropertyValueoperação para consultar o valor atual de uma propriedade do ativo.

Para identificar uma propriedade de ativo, você pode especificar uma das seguintes opções:

  • OassetIdepropertyIdda propriedade do ativo para a qual você está enviando dados.

  • OpropertyAlias, que é um alias de fluxo de dados (por exemplo,/company/windfarm/3/turbine/7/temperature). Para usar esta opção, primeiro você deve definir o alias da propriedade do seu ativo. Para saber como definir aliases de propriedades, consulte Mapeamento de fluxos de dados industriais para propriedades de ativos.

Como obter o valor atual de uma propriedade de ativo (CLI)

  • Execute o seguinte comando para obter o valor atual da propriedade de ativo. Substitua asset-id pelo ID do ativo e property-id pelo ID da propriedade.

    aws iotsitewise get-asset-property-value \
  --asset-id asset-id \
  --property-id property-id

    A operação retorna uma resposta que contém o TQV atual da propriedade no formato a seguir.

    {
  "propertyValue": {
    "value": {
      "booleanValue": Boolean,
      "doubleValue": Number,
      "integerValue": Number,
      "stringValue": "String"
    },
    "timestamp": {
      "timeInSeconds": Number,
      "offsetInNanos": Number
    },
    "quality": "String"
  }
}

Consultar valores históricos de propriedade de ativos

Você pode usar a API do AWS IoT SiteWise para obter o histórico de valores de uma propriedade de ativo.

Use oGetAssetPropertyValueHistoryoperação para consultar os valores históricos de uma propriedade do ativo.

Para identificar uma propriedade de ativo, você pode especificar uma das seguintes opções:

  • OassetIdepropertyIdda propriedade do ativo para a qual você está enviando dados.

  • OpropertyAlias, que é um alias de fluxo de dados (por exemplo,/company/windfarm/3/turbine/7/temperature). Para usar esta opção, primeiro você deve definir o alias da propriedade do seu ativo. Para saber como definir aliases de propriedades, consulte Mapeamento de fluxos de dados industriais para propriedades de ativos.

Defina também qualquer um dos seguintes parâmetros para refinar os resultados:

  • startDate— O início exclusivo do intervalo a partir do qual consultar dados históricos, expresso em segundos na época do Unix.

  • endDate— O final inclusivo do intervalo a partir do qual consultar dados históricos, expresso em segundos na época do Unix.

  • maxResults— O número máximo de resultados a serem retornados em uma solicitação. O padrão é20resultados.

  • nextToken— Um token de paginação retornado de uma chamada anterior dessa operação.

  • timeOrdering— A ordem a ser aplicada aos valores retornados:ASCENDINGouDESCENDING.

  • qualities— A qualidade para filtrar os resultados por:GOOD,BAD, ouUNCERTAIN.

Como consultar o histórico de valores de uma propriedade de ativo (CLI)

  1. Execute o seguinte comando para obter o histórico de valores da propriedade de ativo. Esse comando consulta o histórico da propriedade em um intervalo específico de 10 minutos. Substitua asset-id pelo ID do ativo e property-id pelo ID da propriedade. Substitua os parâmetros de data pelo intervalo a ser consultado.

    aws iotsitewise get-asset-property-value-history \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575216600

    A operação retorna uma resposta que contém os TQVs históricos da propriedade no formato a seguir.

    {
  "assetPropertyValueHistory": [
    {
      "value": {
        "booleanValue": Boolean,
        "doubleValue": Number,
        "integerValue": Number,
        "stringValue": "String"
      },
      "timestamp": {
        "timeInSeconds": Number,
        "offsetInNanos": Number
      },
      "quality": "String"
    }
  ],
  "nextToken": "String"
}

  2. Se existirem mais entradas de valor, você poderá passar o token de paginação donextTokencampo para uma chamada subsequente para oGetAssetPropertyValueHistoryoperação.

Consultar agregados de propriedades de ativos

O AWS IoT SiteWise calcula automaticamente os valores de propriedades de ativos agregados, que são um conjunto de métricas básicas calculadas em vários intervalos de tempo. O AWS IoT SiteWise calcula os seguintes agregados a cada minuto, hora e dia para suas propriedades de ativos:

  • média— A média (média) dos valores de uma propriedade em um intervalo de tempo.

  • contagem— O número de pontos de dados de uma propriedade em um intervalo de tempo.

  • máximo— O máximo dos valores de uma propriedade em um intervalo de tempo.

  • mínimo— O mínimo dos valores de uma propriedade em um intervalo de tempo.

  • desvio padrão— O desvio padrão dos valores de uma propriedade em um intervalo de tempo.

  • soma— A soma dos valores de uma propriedade em um intervalo de tempo.

Para propriedades não numéricas, como strings e boolianos, o AWS IoT SiteWise calcula somente o agregado de contagem.

Você também pode calcular métricas personalizadas para os dados dos ativos. As propriedades de métricas permitem definir agregações específicas para sua operação. As propriedades de métricas oferecem funções de agregação adicionais e intervalos de tempo que não estão pré-calculados para a API do AWS IoT SiteWise. Para obter mais informações, consulte Agregando dados de propriedades e outros ativos (métricas).

Você pode usar a API do AWS IoT SiteWise para obter os agregados de uma propriedade de ativo.

Use oGetAssetPropertyAggregatesoperação para consultar agregados de uma propriedade do ativo.

Para identificar uma propriedade de ativo, você pode especificar uma das seguintes opções:

  • OassetIdepropertyIdda propriedade do ativo para a qual você está enviando dados.

  • OpropertyAlias, que é um alias de fluxo de dados (por exemplo,/company/windfarm/3/turbine/7/temperature). Para usar esta opção, primeiro você deve definir o alias da propriedade do seu ativo. Para saber como definir aliases de propriedades, consulte Mapeamento de fluxos de dados industriais para propriedades de ativos.

Você também deve definir os seguintes parâmetros necessários:

  • aggregateTypes— A lista de agregados a serem recuperados. Você pode especificar qualquer opção entre AVERAGE, COUNT, MAXIMUM, MINIMUM, STANDARD_DEVIATION e SUM

  • resolution— O intervalo de tempo para o qual recuperar a métrica:1m(1 minuto),1h(1 hora), ou1d(1 dia).

  • startDate— O início exclusivo do intervalo a partir do qual consultar dados históricos, expresso em segundos na época do Unix.

  • endDate— O final inclusivo do intervalo a partir do qual consultar dados históricos, expresso em segundos na época do Unix.

Defina também qualquer um dos seguintes parâmetros para refinar os resultados:

  • maxResults— O número máximo de resultados a serem retornados em uma solicitação. O padrão é20resultados.

  • nextToken— Um token de paginação retornado de uma chamada anterior dessa operação.

  • timeOrdering— A ordem a ser aplicada aos valores retornados:ASCENDINGouDESCENDING.

  • qualities— A qualidade para filtrar os resultados por:GOOD,BAD, ouUNCERTAIN.

nota

OGetAssetPropertyAggregatesA operação retorna um TQV com um formato diferente das outras operações descritas nesta seção. A estrutura de value contém um campo para cada um dos aggregateTypes na solicitação. O timestamp contém a hora em que a agregação ocorreu, em segundos, no horário Unix epoch.

Como consultar agregados de uma propriedade de ativo (CLI)

  1. Execute o seguinte comando para obter os agregados para a propriedade de ativo. Este comando consulta a média e a soma com uma resolução de uma hora para um intervalo específico de uma hora. Substitua asset-id pelo ID do ativo e property-id pelo ID da propriedade. Substitua os parâmetros pelos agregados e o intervalo a ser consultado.

    aws iotsitewise get-asset-property-aggregates \
  --asset-id asset-id \
  --property-id property-id \
  --start-date 1575216000 \
  --end-date 1575219600 \
  --aggregate-types AVERAGE SUM \
  --resolution 1h

    A operação retorna uma resposta que contém os TQVs históricos da propriedade no formato a seguir. A resposta inclui apenas os agregados solicitados.

    {
  "aggregatedValues": [
    {
      "timestamp": Number,
      "quality": "String",
      "value": {
        "average": Number,
        "count": Number,
        "maximum": Number,
        "minimum": Number,
        "standardDeviation": Number,
        "sum": Number
      }
    }
  ],
  "nextToken": "String"
}

  2. Se existirem mais entradas de valor, você poderá passar o token de paginação donextTokencampo para uma chamada subsequente para oGetAssetPropertyAggregatesoperação.