Processador de IoT SiteWise - AWS IoT Greengrass

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

Processador de IoT SiteWise

O componente do SiteWise processador de IoT (aws.iot.SiteWiseEdgeProcessor) permite que os AWS IoT SiteWise gateways processem dados na borda.

Com esse componente, os AWS IoT SiteWise gateways podem usar modelos e ativos de ativos para processar dados em dispositivos de gateway. Para obter mais informações sobre AWS IoT SiteWise gateways, consulte Usando AWS IoT SiteWise na borda no Guia do AWS IoT SiteWise usuário.

Versões

Esse componente tem as seguintes versões:

  • 3.3.x

  • 3.2.x

  • 3.1.x

  • 3.0.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Este componente é um componente genérico (aws.greengrass.generic). O núcleo do Greengrass executa os scripts do ciclo de vida do componente.

Para obter mais informações, consulte Tipos de componentes.

Sistema operacional

Esse componente pode ser instalado em dispositivos principais que executam os seguintes sistemas operacionais:

  • Linux

  • Windows

Requisitos

Esse componente tem os seguintes requisitos:

  • O dispositivo principal do Greengrass deve ser executado em uma das seguintes plataformas:

    • SISTEMA OPERACIONAL: Ubuntu 20.04 ou 18.04

      Arquitetura: x86_64 () AMD64

    • Sistema Operativo: Red Hat Enterprise Linux (8RHEL)

      Arquitetura: x86_64 () AMD64

    • SO: Amazon Linux 2

      Arquitetura: x86_64 () AMD64

    • SISTEMA OPERACIONAL: Windows Server 2019 ou posterior

      Arquitetura: x86_64 () AMD64

  • O dispositivo principal do Greengrass deve permitir tráfego de entrada na porta 443.

  • O dispositivo principal do Greengrass deve permitir tráfego de saída nas portas 443 e 8883.

  • As seguintes portas são reservadas para uso por AWS IoT SiteWise: 80, 443, 3001, 4569, 4572, 8000, 8081, 8082, 8084, 8085, 8086, 8445, 9000, 9500, 11080 e 50010. Usar uma porta reservada para tráfego pode resultar no encerramento de uma conexão.

    nota

    A porta 8087 é necessária somente para a versão 2.0.15 e posterior desse componente.

  • A função de dispositivo do Greengrass deve ter permissões que permitam que você use AWS IoT SiteWise gateways em seus dispositivos. AWS IoT Greengrass V2 Para obter mais informações, consulte Requisitos no Guia AWS IoT SiteWise do usuário.

Endpoints e portas

Esse componente deve ser capaz de realizar solicitações de saída para os seguintes endpoints e portas, além dos endpoints e portas necessários para a operação básica. Para obter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Endpoint Port (Porta) Obrigatório Descrição

model.iotsitewise.region.amazonaws.com

443 Sim

Obtenha informações sobre seus AWS IoT SiteWise ativos e modelos de ativos.

edge.iotsitewise.region.amazonaws.com

443 Sim

Obtenha informações sobre a configuração do AWS IoT SiteWise gateway do dispositivo principal.

ecr.region.amazonaws.com

443 Sim

Baixe imagens do AWS IoT SiteWise Edge Gateway Docker do Amazon Elastic Container Registry.

iot.region.amazonaws.com

443 Sim

Obtenha endpoints de dispositivos para seu. Conta da AWS

sts.region.amazonaws.com

443 Sim

Obtenha o ID do seu Conta da AWS.

monitor.iotsitewise.region.amazonaws.com

443 Não

Obrigatório se você acessar AWS IoT SiteWise Monitor portais no dispositivo principal.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que você deve atender aos requisitos do componente e de todas as suas dependências para implantá-lo com êxito. Esta seção lista as dependências das versões lançadas desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Você também pode visualizar as dependências de cada versão do componente no AWS IoT Greengrass console. Na página de detalhes do componente, procure a lista de dependências.

A tabela a seguir lista as dependências das versões 2.0.x a 2.1.x desse componente.

Dependência Versões compatíveis Tipo de dependência
Serviço de troca de tokens >=2.0.3 <3.0.0 Rígido
Gerenciador de fluxo >=2.0.10 <3.0.0 Rígido
Greengrass CLI >=2.3.0 <3.0.0 Rígido

Para obter mais informações sobre dependências de componentes, consulte a referência da receita do componente.

Configuração

Esse componente não tem nenhum parâmetro de configuração.

Arquivo de log local

Esse componente usa o seguinte arquivo de log.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log
Para ver os registros desse componente
  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substituir /greengrass/v2 ou C:\greengrass\v2 com o caminho para a pasta AWS IoT Greengrass raiz.

    Linux
    sudo tail -f /greengrass/v2/logs/aws.iot.SiteWiseEdgeProcessor.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\aws.iot.SiteWiseEdgeProcessor.log -Tail 10 -Wait

Licenças

Esse componente inclui o seguinte software/licenciamento de terceiros:

  • Apache-2.0

  • MIT

  • BSDCláusula -2

  • BSD-Cláusula 3

  • CDDL-1,0

  • CDDL-1,1

  • ISC

  • Zlib

  • GPL-3.0 com- -exceção GCC

  • Domínio público

  • Python-2.0

  • Unicode- -2015 DFS

  • BSDCláusula -1

  • Aberto SSL

  • EPL-1,0

  • EPL-2,0

  • GPL-2,0- with-classpath-exception

  • MPL-2,0

  • CC0-1.0

  • JSON

Esse componente é lançado de acordo com o Contrato de Licença de Software Principal do Greengrass.

Changelog

A tabela a seguir descreve as alterações em cada versão do componente.

Version (Versão)

Alterações

3.3.1

Novo atributo
  • Foi adicionado CORS suporte opcional ao SiteWise EdgeAPIs, aprimorando os recursos de compartilhamento de recursos entre origens. Esse recurso melhora a flexibilidade dos aplicativos da web que interagem com o. APIs

3.3.0

Melhorias de performance
  • Mecanismo de atualização de cache otimizado para reduzir o uso de E/S entre sincronizações de AWS IoT SiteWise ativos, atualizando somente as entradas de ativos novos ou atualizados.

  • Consumo de memória reduzido para manter um cache com um grande número de propriedades de ativos sincronizados.

Correções de erros e melhorias
  • Registros suprimidos para ingestão de valores de propriedades individuais quando não há erros de ingestão, o que reduz o ruído do registro durante altas taxas de ingestão.

  • Melhor legibilidade do registro usando formatação legível por humanos para determinadas entradas de registro.

  • Foi adicionado suporte para Java 17 e versões posteriores.

3.2.1

Correções de erros e melhorias
  • Corrige o problema em que as AWS IoT SiteWise API chamadas não paginam de forma síncrona com o Edge. SiteWise

  • Corrija o problema de não publicar mais a MessageRemaining.SiteWise_Edge_Stream métrica.

  • Foram adicionadas as seguintes CloudWatch métricas para monitorar a conexão com o MQTT corretor.

    • IoTSiteWiseProcessor.IsConnectedToMqttBroker

    • IoTSiteWiseProcessor.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWiseProcessor.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWiseProcessor.MqttMessageReceivedSuccessCount

    • IoTSiteWiseProcessor.MqttReceivedSuccessBytes

    Para obter mais informações sobre essas métricas, consulte métricas do AWS IoT Greengrass Version 2 gateway.

3.2.0

Melhorias de performance
  • Otimize API os serviços para ocupar menos memória e exigir menos espaço em disco para instalação

    • Isso proporciona uma redução de 2 GB no uso inicial da memória (agora usa 7,5 GB de memória na inicialização, no entanto, 16 GB ainda é recomendado) e uma redução de 500 MB no tamanho do download (agora requer um download de 1,4 GB) para todo o componente.

Novos atributos
  • GetAssetPropertyValueAggregatesAPIagora suporta janelas de agregação de 15 minutos na borda.

  • As portas 8081 e 8082 não precisam mais estar disponíveis para que esse componente seja executado corretamente.

    nota

    O endpoint local do plano de AWS IoT SiteWise dadosAPIs, comoget-asset-property-value, está sendo alterado de http://localhost:8081 parahttp://localhost:11080/data. O ponto final local do plano de AWS IoT SiteWise controleAPIs, comolist-asset-models, está sendo alterado de http://localhost:11080 parahttp://localhost:11080/control. AWS sempre recomenda que você use os HTTPS endpoints do gateway SiteWise Edge. Esses endpoints não foram alterados.

Correções de erros e melhorias
  • A sincronização de agora AWS IoT SiteWise transformará os recursos em um estado válido se a sincronização anterior tiver sido interrompida. Isso corrigirá problemas com alguns recursos corrompidos após uma reinicialização forçada.

  • Corrige uma condição rara em que um recurso pode ser corrompido na borda se for modificado durante a sincronização. A sincronização agora falhará se essa condição for detectada, e o recurso será repetido na próxima sincronização.

  • Corrige um problema que poderia ter permitido que o HTTP endpoint fosse chamado externamente. APIs Só HTTPS pode ser usado para ligar APIs fora do endereço de loopback local agora.

  • ListAssetsAPIagora mostra as hierarquias de ativos para ativos armazenados na borda.

  • Corrige um problema em que o Pacote de Processamento de Dados falhou ao reiniciar, atualizar ou fazer o downgrade no Windows.

  • Corrige um bug no Pacote de Processamento de Dados para o sistema operacional Windows que impedia que os clientes usassem credenciais para se conectar a um MQTT Broker.

3.1.3

Correções de erros e melhorias
  • Corrige o problema em que o Data Processing Pack relatou incorretamente uma sincronização bem-sucedida quando alguns dos recursos realmente falharam.

  • Permita que vários ativos tenham o mesmo nome, desde que não tenham o mesmo pai.

3.1.1

Correções de erros e melhorias
  • Corrige o problema em que a solicitação SigV4 falha devido a uma incompatibilidade de fuso horário.

  • Corrige o problema em que as propriedades de transformação e métrica param de ser calculadas quando dependem de atributos após a reinicialização.

  • Ative o suporte à configuração personalizada da porta do Stream Manager.

  • Corrija um problema em que as propriedades sincronizadas com a borda podem parar de ser atualizadas.

3.1.0

Correções de erros e melhorias
  • Corrige o problema em que ListAssetModels API falha ao gerar o próximo token.

3.0.0

Novos atributos
  • Permite o suporte à ingestão de dados de um MQTT corretor.

2.2.1

Correções de erros e melhorias
  • Ajuste o processo de sincronização para tornar o armazenamento de dados do plano de controle mais consistente com a forma como a nuvem opera. Isso afeta um pouco a atualização.

    nota

    Os dados do plano de controle sincronizados na versão 2.2.1 ou superior não serão compatíveis com as versões anteriores. Para fazer o downgrade para versões anteriores, você precisará concluir uma nova instalação. Isso não afeta as atualizações. Os dados sincronizados nas versões anteriores funcionarão com a versão 2.2.1.

  • Modificações adicionais na cadeia de AWS credenciais para AWS IoT Greengrass V2 priorizar as credenciais.

2.1.37

Correções de erros e melhorias
  • Desative o dependency-routing-service processo e transfira sua funcionalidade para o property-state-service processo para reduzir o uso de recursos dos processos de comunicação.

  • Aumente o limite máximo de resultados get-asset-property-value-history API para 20.000 para corresponder ao limite usado por AWS IoT SiteWise.

  • Corrija um problema em que o próximo token não estava sendo fornecido nos resultados paginados get-asset-property-value-history API quando nenhum limite máximo de resultados foi especificado.

2.1.35

Correções de erros e melhorias
  • Modifica a cadeia de AWS credenciais para AWS IoT Greengrass priorizar as credenciais.

  • Corrige um problema com a detecção de contas ao implantar como parte de um grupo AWS IoT Thing.

2.1.34

Correções de erros e melhorias
  • Ajusta os cálculos de métrica/transformação para usar multithreading no Linux. O Windows continua executando cálculos de thread único para fins de compatibilidade.

  • Corrige um problema em que os cálculos métricos estariam ausentes em algumas janelas de computação.

2.1.3

Correções de erros e melhorias
  • Corrige um problema com o relatório do estado de erro para o console do Greengrass.

2.1.32

Correções de erros e melhorias
  • Adiciona suporte para grupos e nomes de usuário personalizados.

2.1.31

Correções de erros e melhorias
  • Adiciona suporte para calcular a média ponderada pelo tempo e o desvio padrão ponderado pelo tempo para dados modelados. AWS IoT SiteWise

2.1.29

Correções de erros e melhorias
  • Adiciona suporte para filtrar ativos na funcionalidade de borda.

2.1.28

Correções de erros e melhorias
  • Otimiza a sincronização de recursos para permitir que um grande número de ativos seja sincronizado da borda Nuvem AWS até a borda.

2.1.24

Correções de erros e melhorias
  • Corrige um problema que fazia com que o painel desaparecesse ao sincronizar um recurso pela segunda vez.

2.1.23

Correções de erros e melhorias
  • Foi adicionado um tempo limite para o processo de aws.iot.SiteWiseEdgeProcessor instalação para evitar falhas na instalação se a conectividade com a Internet estiver lenta.

  • Sincronização otimizada de recursos para melhorar a eficiência da sincronização entre a nuvem e a borda.

2.1.21

Atenção

A atualização da versão 2.0.x para a 2.1.x resultará na perda de dados locais.

Novos atributos
  • Adiciona suporte para Windows Server 2019 ou superior.

  • Remove o docker para sistemas operacionais baseados em Linux.

2.0.16

Esta versão contém correções de erros e melhorias.

2.0.15

Correções de erros e melhorias
  • Altera a porta que esse componente usa para API operações de sincronização de recursos de 8085 para 8087. Como resultado, esse componente agora exige que a porta 8087 esteja disponível. Esse componente ainda exige que a porta 8085 esteja disponível.

  • Atualiza a AWS OpsHub autenticação para negar usuários não autorizados durante o login, em vez de quando um usuário tenta ligar para API as operações.

2.0.14

Esta versão contém correções de erros e melhorias.

2.0.13

Correções de erros e melhorias
  • Corrige um problema para que, quando esse componente relata dados para CloudWatch as métricas da Amazon, agora indique corretamente quais dados não foram modelados.

2.0.9

Correções de erros e melhorias
  • Melhora a confiabilidade para criar e atualizar AWS IoT SiteWise recursos no dispositivo principal.

  • Adiciona API operações locais adicionais que você pode usar para monitorar quais componentes estão instalados no dispositivo principal, a versão de cada componente e o status de cada componente. Você pode ver essas informações na guia Configurações do AWS IoT SiteWise aplicativo AWS OpsHub for no dispositivo principal.

  • Adiciona um status de integridade para os contêineres do Docker que esse componente executa. Você pode executar o docker ps comando para ver o status de saúde dos contêineres.

2.0.7

Correções de erros e melhorias
  • Corrige o suporte para visualização de AWS IoT SiteWise Monitor portais no dispositivo principal.

2.0.6

Correções de erros e melhorias
  • Corrige as latest() funções AWS IoT SiteWise statetime()earliest(), e que esse componente computa no dispositivo principal.

2.0.5

Correções de erros e melhorias
  • Adiciona suporte para a AWS IoT SiteWise pretrigger() função nas transformações que esse componente computa no dispositivo principal.

  • Altera o caminho em que esse componente armazena a configuração do Lightweight Directory Access Protocol (LDAP) para autenticação.

2.0.2

Versão inicial.

Consulte também