Editora de IoT SiteWise - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoDados de entradaArquivo de log localDepuração e solução de problemasLicençasChangelogConsulte também

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

Editora de IoT SiteWise

O componente SiteWise editor de IoT (aws.iot.SiteWiseEdgePublisher) permite que os AWS IoT SiteWise gateways exportem dados da borda para o. Nuvem AWS

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

  • 3.1.x

  • 3.0.x

  • 2.4.x

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

Tipo

Esse é 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 componente.

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 18.04 ou posterior

      arquitetura: x86_64 (AMD64) ou ARMv8 (Aarch64)

    • sistema operacional: Red Hat Enterprise Linux (RHEL) 8

      arquitetura: x86_64 (AMD64) ou ARMv8 (Aarch64)

    • sistema operacional: Amazon Linux 2

      arquitetura: x86_64 (AMD64) ou ARMv8 (Aarch64)

    • sistema operacional: Debian 11

      arquitetura: x86_64 (AMD64) ou ARMv8 (Aarch64)

    • sistema operacional: Windows Server 2019 ou posterior

      arquitetura: x86_64 () AMD64

  • O dispositivo principal do Greengrass deve se conectar à Internet.

  • O dispositivo principal do Greengrass deve estar autorizado a realizar a açãoiotsitewise:BatchPutAssetPropertyValue. Para obter mais informações, consulte Autorizar dispositivos principais a interagir com os AWS serviços.

    exemplo política de permissões
    {
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "iotsitewise:BatchPutAssetPropertyValue",
            "Resource": "*"
        }
    ]
}

Endpoints e portas

Esse componente precisa ser capaz de realizar solicitações de saída para os endpoints e portas a seguir, 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

data.iotsitewise.region.amazonaws.com

 443 Sim

Publique dados em AWS IoT SiteWise.

Dependências

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas 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. Também é possível visualizar as dependências de cada versão do componente no console do AWS IoT Greengrass. 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.2.x desse componente.

Dependência Versões compatíveis Tipo de dependência
Núcleo do Greengrass >=2.3.0<3.0.0 Rígido
Gerenciador de fluxos >=2.0.10<3.0.0 Rígido

Para obter mais informações sobre as dependências dos componentes, consulte referência de fórmula do componente.

Configuração

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

Você pode usar o AWS IoT SiteWise console ou a API para configurar o componente SiteWise Editor de IoT. Para obter mais informações, consulte Etapa 3: Configurar o editor - opcional no Guia AWS IoT SiteWise do usuário.

Dados de entrada

Esse componente lê PutAssetPropertyValueEntry mensagens do gerenciador de AWS IoT Greengrass fluxo. Para obter mais informações, consulte PutAssetPropertyValueEntry na Referência de APIs do AWS IoT SiteWise .

Arquivo de log local

Esse componente usa o arquivo de log abaixo.

Linux
/greengrass/v2/logs/aws.iot.SiteWiseEdgePublisher.log
Windows
C:\greengrass\v2\logs\aws.iot.SiteWiseEdgePublisher.log
Para exibir os logs desse componente

  • Execute o comando a seguir no dispositivo principal para visualizar o arquivo de log desse componente em tempo real. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

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

Depuração e solução de problemas

Esse componente inclui um novo log de eventos para ajudar os clientes a identificar e corrigir problemas. O arquivo de log é separado do arquivo de log local e é encontrado no local a seguir. Substitua /greengrass/v2 ou C:\greengrass\v2 pelo caminho para a pasta AWS IoT Greengrass raiz.

Linux
/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IotSiteWisePublisherEvents.log
Windows
C:\greengrass\v2\work\aws.iot.SiteWiseEdgePublisher\logs\IotSiteWisePublisherEvents.log

Esse log inclui informações detalhadas e instruções para solução de problemas. As informações da solução de problemas são fornecidas com o diagnóstico, com uma descrição de como solucionar o problema e, às vezes, com links para mais informações. Entre as informações de diagnóstico estão as seguintes:

  • Nível de gravidade

  • Timestamp

  • Informações específicas do evento adicionais

exemplo Log de exemplo
accountBeingThrottled:
  Summary: Data upload speed slowed due to quota limits
  Level: WARN
  Timestamp: '2023-06-09T21:30:24.654Z'
  Description: The IoT SiteWise Publisher is limited to the "Rate of data points ingested"
    quota for a customers account. See the associated documentation and associated
    metric for the number of requests that were limited for more information. Note
    that this may be temporary and not require any change, although if the issue continues
    you may need to request an increase for the mentioned quota.
  FurtherInformation:
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
  - https://docs.aws.amazon.com/iot-sitewise/latest/userguide/troubleshooting-gateway.html#gateway-issue-data-streams
  AssociatedMetrics:
  - Name: TotalErrorCount
    Description: The total number of errors of this type that occurred.
    Value: 327724.0
  AssociatedData:
  - Name: AggregatePropertyAliases
    Description: The aggregated property aliases of the throttled data.
    FileLocation: /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/./logs/data/AggregatePropertyAliases_1686346224654.log

Licenças

Esse componente é liberado de acordo com o Contrato de licença de software Greengrass Core.

Changelog

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

Versão

Alterações

3.2.0
Novos recursos

Foi adicionado suporte para ingestão de valores Null e NaN se a ingestão estiver ativada em. AWS IoT SiteWise Para visualizar ou modificar a configuração Null e NaN em AWS IoT SiteWise, consulte DescribeStorageConfiguratione. PutStorageConfiguration APIs

Correções de bugs e melhorias

  • Corrige problemas que causam arquivos de banco de dados de pontos de verificação corrompidos.

  • Corrige problemas na geração de métricas duplicadas.

3.1.4
Correções de bugs e melhorias

  • Corrige problemas que poderiam causar tempos de longer-than-expected inicialização após estar off-line.

3.1.3
Correções de bugs e melhorias

  • Corrige um problema em que o arquivo de registro de eventos localizado em /greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/logs/IoTSiteWisePublisherEvents.log foi criado, mas nenhum evento estava sendo registrado.

  • Adiciona as seguintes CloudWatch métricas para monitorar a conexão com o broker MQTT:

    • IoTSiteWisePublisher.IsConnectedToMqttBroker

    • IoTSiteWisePublisher.NumberOfSubscriptionsToMqttBroker

    • IoTSiteWisePublisher.NumberOfUniqueMqttTopicsReceived

    • IoTSiteWisePublisher.MqttMessageReceivedSuccessCount

    • IoTSiteWisePublisher.MqttReceivedSuccessBytes

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

  • Corrige um problema em que a BatchCreateJob API ainda é chamada mesmo se o upload de um arquivo de parquet para o S3 falhar.

3.1.2
Correções de bugs e melhorias

  • Corrige o problema do alto uso da CPU introduzido na versão 3.1.1.

3.1.1
Atenção

A versão 3.1.1 foi descontinuada em 12 de março de 2024. As melhorias nesta versão estão disponíveis em versões posteriores desse componente.

Correções de bugs e melhorias

  • Adiciona logs adicionais que identificam os aliases de dados afetados quando ocorre um erro.

  • Adiciona a aplicação local dos limites da AWS IoT SiteWise API à idade dos dados ingeridos.

  • Corrige o problema em que o Publisher mistura os pontos de verificação dos StreamManager streams quando há vários destinos do Amazon S3.

  • Corrige o gargalo de desempenho na forma como o Publisher lê os StreamManager fluxos.

3.1.0
Novos recursos

  • Adiciona suporte para publicar dados como arquivos em parquet no Amazon S3.

  • Adiciona suporte para ingestão em AWS IoT SiteWise buffer.

3.0.0
Correções de bugs e melhorias

  • Corrige problemas relacionados ao suporte de proxy.

Novos recursos

  • Permite o suporte à ingestão de dados de um agente MQTT.

2.4.1
Correções de bugs e melhorias

  • Ative o componente para funcionar com as versões 11.0.20.8.1 e posteriores do Java Corretto 11. As versões 2.4.0 e 2.3.3 do componente mostram a mensagem de "Could not find or load main class" erro quando usadas com a versão 11.0.20.8.1 do Java Corretto.

2.4.0
Novos recursos

  • Adiciona um novo log de eventos para facilitar a identificação e a correção de problemas.

Correções de bugs e melhorias

  • Melhora a recuperação do checkpoint do Publisher.

2.3.3
Correções de bugs e melhorias

  • Melhora a capacidade para comportar alto throughput.

2.3.2
Correções de bugs e melhorias

  • Corrige o suporte ao proxy HTTP ao baixar a configuração do Publisher.

2.3.1
Novos recursos

  • Adiciona suporte para instalação do Data Collection Pack na ARMv8 arquitetura Linux.

  • Requisitos mínimos para Linux ARMv8:

    • Memória: 4 GB

    • CPU: ARM Cortex-A72 ou especificação equivalente

2.2.3
Correções de bugs e melhorias

  • Remove a repetição da exceção genérica que não estava na lista de exceções recuperáveis.

2.2.2
Correções de bugs e melhorias

  • Reintroduz o suporte ao upload de dados AWS IoT SiteWise por meio de um servidor proxy HTTP.

2.2.1
nota

Esta versão não oferece suporte à configuração de proxy HTTP. A versão 2.2.2 e superior reintroduz o suporte a esse recurso.

Novos recursos

  • Adiciona suporte a esse componente para alternar a compactação ao fazer upload de dados para o. AWS IoT SiteWise

2.2.0
nota

Esta versão não oferece suporte à configuração de proxy HTTP. A versão 2.2.2 e superior reintroduz o suporte a esse recurso.

Novos recursos

  • Atualiza esse componente para compactar dados antes de enviá-los ao AWS IoT SiteWise serviço.

    • Na maioria dos casos, essa alteração reduz o uso da largura de banda em 75 por cento em comparação com as versões anteriores desse componente.

    • Na maioria dos casos, essa alteração aumenta o uso da CPU em até 5%. Em gateways que processam grandes quantidades de dados, essa alteração pode aumentar o uso da CPU em até 15%.

    • Essa alteração não afeta as taxas AWS IoT SiteWise de serviço ou o uso da cota de serviço.

    • Acrescenta suporte para Windows Server 2019 ou superior.

Correções de bugs e melhorias

  • Corrige um problema que impede que esse componente seja iniciado quando o arquivo do ponto de verificação está corrompido.

2.1.4
Correções de bugs e melhorias

  • Corrige a compatibilidade com a versão 8 do Java.

2.1.3
Atenção

Essa versão não está mais disponível, exceto nas regiões Leste dos EUA (Ohio), Canadá (Central) AWS GovCloud e (Leste dos EUA). Essa versão do componente requer a versão 11 ou superior do Java para ser executada. As melhorias nesta versão estão disponíveis em versões posteriores desse componente.

Correções de bugs e melhorias

  • Melhora as mensagens de erro quando você implanta esse componente em dispositivos não compatíveis.

  • Atualizações para registrar erros quando os carregamentos de dados falham.

2.1.2
Correções de bugs e melhorias

  • Atualizações para invocar o recurso de exportação de dados expirados assim que os dados expirarem.

2.1.1

Correções de bugs e melhorias.

2.1.0
Novos recursos

  • Adição de suporte à publicação primeiro dos dados mais recentes na nuvem.

  • Adiciona suporte para não publicar dados expirados na nuvem.

  • Adiciona suporte para armazenar dados expirados localmente.

Correções de bugs e melhorias

  • Reduz a E/S de disco e a latência correspondente.

2.0.2

Correções de bugs e melhorias.

2.0.1

Versão inicial.

Consulte também