Requisitos Parâmetros Dados de entrada Dados de saída Limites Licenças Changelog Consulte também

AWS IoT Greengrass Version 1 entrou na fase de vida útil prolongada em 30 de junho de 2023. Para obter mais informações, consulte política de manutenção do AWS IoT Greengrass V1. Após essa data, AWS IoT Greengrass V1 não lançaremos atualizações que forneçam recursos, aprimoramentos, correções de erros ou patches de segurança. Os dispositivos que funcionam AWS IoT Greengrass V1 não serão interrompidos e continuarão operando e se conectando à nuvem. É altamente recomendável que você migre para AWS IoT Greengrass Version 2, o que adiciona novos recursos significativos e suporte para plataformas adicionais.

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

Conector IoT SiteWise

O SiteWise conector IoT envia dados locais de dispositivos e equipamentos para as propriedades dos ativos em. AWS IoT SiteWise Você pode usar esse conector para coletar dados de vários servidores OPC-UA e publicá-los na IoT. SiteWise O conector envia os dados para as propriedades do ativo na Conta da AWS e na Região atuais.

nota

A IoT SiteWise é um serviço totalmente gerenciado que coleta, processa e visualiza dados de dispositivos e equipamentos industriais. Você pode configurar propriedades de ativos que processam os dados brutos enviados deste conector para as propriedades de medição dos seus ativos. Por exemplo, você pode definir uma propriedade de transformação que converta os pontos de dados de temperatura Celsius de um dispositivo em Fahrenheit ou pode definir uma propriedade métrica que calcule a temperatura média por hora. Para obter mais informações, consulte O que é o AWS IoT SiteWise? no Guia do usuário do AWS IoT SiteWise.

O conector envia dados para a IoT SiteWise com os caminhos de fluxo de dados OPC-UA enviados dos servidores OPC-UA. Por exemplo, o caminho do fluxo de dados /company/windfarm/3/turbine/7/temperature pode representar o sensor de temperatura da turbina #7 na fazenda de energia eólica #3. Se o núcleo AWS IoT Greengrass perder conexão com a internet, o conector armazenará os dados em cache até que ele possa se conectar com êxito à Nuvem AWS. Você pode configurar o tamanho máximo do buffer de disco usado para armazenar dados em cache. Se o tamanho do cache exceder o tamanho máximo do buffer de disco, o conector descartará os dados mais antigos da fila.

Depois de configurar e implantar o SiteWise conector de IoT, você pode adicionar um gateway e fontes OPC-UA no console de IoT. SiteWise Ao configurar uma fonte no console, você pode filtrar ou prefixar os caminhos do fluxo de dados OPC-UA enviados pelo conector IoT. SiteWise Para obter instruções sobre como concluir a configuração do gateway e das origens, consulte Adicionar o gateway no Guia do Usuário AWS IoT SiteWise.

A IoT SiteWise recebe dados somente de fluxos de dados que você mapeou para as propriedades de medição dos ativos de IoT. SiteWise Para mapear o fluxo de dados para propriedades de ativos, você pode definir o alias de uma propriedade como equivalente a um caminho de fluxo de dados OPC-UA. Para saber mais sobre como definir modelos de ativos e criar ativos, consulte Modelagem de ativos industriais no Guia do usuário do AWS IoT SiteWise.

Observações

Você pode usar o gerenciador de fluxo para fazer upload de dados para a IoT SiteWise de fontes que não sejam servidores OPC-UA. O gerenciador de fluxo também fornece suporte personalizável para gerenciamento de persistência e largura de banda. Para ter mais informações, consulte Gerenciar streams de dados no núcleo do AWS IoT Greengrass.

Esse conector é executado no modo de isolamento Sem contêiner para que você possa implantá-lo em um grupo do Greengrass que é executado em um contêiner do Docker.

Esse conector tem as seguintes versões.

Version (Versão)	ARN
12 (recomendado)	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/12`
11	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11`
10	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/10`
9	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/9`
8	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/8`
7	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/7`
6	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/6`
5	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/5`
4	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/4`
3	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/3`
2	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/2`
1	`arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/1`

Para obter informações sobre alterações de versão, consulte o Changelog.

Requisitos

Esse conector tem os seguintes requisitos:

Version 9, 10, 11, and 12

Importante

Esta versão apresenta novos requisitos: software do AWS IoT Greengrass Core v1.10.2 e gerenciador de fluxo.

Versão v1.10.2 do software Core AWS IoT Greengrass
Gerenciador de fluxo ativado no grupo do Greengrass.
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.

Uma política do IAM adicionada à função do grupo do Greengrass. Essa função permite que o grupo do AWS IoT Greengrass acesse a ação iotsitewise:BatchPutAssetPropertyValue no ativo raiz de destino e seus filhos, conforme mostrado no exemplo a seguir. Você pode remover o Condition da política para permitir que o conector acesse todos os seus ativos de IoT SiteWise .


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Para obter mais informações, consulte Adicionando e removendo políticas do IAM no Guia do usuário do IAM.

Versions 6, 7, and 8

Importante

Esta versão apresenta novos requisitos: software do AWS IoT Greengrass Core v1.10.0 e gerenciador de fluxo.

Versão v1.10.0 do software Core AWS IoT Greengrass
Gerenciador de fluxo ativado no grupo do Greengrass.
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Para obter mais informações, consulte Adicionando e removendo políticas do IAM no Guia do usuário do IAM.

Version 5

Versão v1.9.4 do software Core AWS IoT Greengrass
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Para obter mais informações, consulte Adicionando e removendo políticas do IAM no Guia do usuário do IAM.

Version 4

Versão v1.10.0 do software Core AWS IoT Greengrass
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Para obter mais informações, consulte Adicionando e removendo políticas do IAM no Guia do usuário do IAM.

Version 3

Versão v1.9.4 do software Core AWS IoT Greengrass
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        }
    ]
}

Para obter mais informações, consulte Adicionando e removendo políticas do IAM no Guia do usuário do IAM.

Versions 1 and 2

Versão v1.9.4 do software Core AWS IoT Greengrass
Java 8 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH.
Esse conector pode ser usado somente nas regiões da Amazon Web Services em que ambos AWS IoT Greengrasse IoT SiteWise são compatíveis.

Uma política do IAM adicionada à função do grupo do Greengrass que permite o acesso ao AWS IoT Core e à ação iotsitewise:BatchPutAssetPropertyValue no ativo raiz de destino e seus filhos, conforme mostrado no exemplo a seguir. Você pode remover o Condition da política para permitir que o conector acesse todos os seus ativos de IoT SiteWise .


{
    "Version": "2012-10-17",
    "Statement": [
        {
             "Effect": "Allow",
             "Action": "iotsitewise:BatchPutAssetPropertyValue",
             "Resource": "*",
             "Condition": {
                 "StringLike": {
                     "iotsitewise:assetHierarchyPath": [
                         "/root node asset ID",
                         "/root node asset ID/*"
                     ]
                 }
             }
        },
        {
            "Effect": "Allow",
            "Action": [
                 "iot:Connect",
                 "iot:DescribeEndpoint",
                 "iot:Publish",
                 "iot:Receive",
                 "iot:Subscribe"
            ],
            "Resource": "*"
        }
    ]
}

Para obter mais informações, consulte Adicionar e remover permissões de identidade do IAM no Guia do usuário do IAM.

Parâmetros

Versions 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, and 12

SiteWiseLocalStoragePath

O diretório no AWS IoT Greengrass host no qual o SiteWise conector de IoT pode gravar dados persistentes. Padronizado como /var/sitewise.

Nome de exibição no console AWS IoT: Caminho de armazenamento local

Obrigatório: false

Digite: string

Padrão válido: ^\s*$|\/.

AWSSecretsArnList

Uma lista de segredos no AWS Secrets Manager, cada um com um par de nome de usuário OPC-UA e par de chave-valor de senha. Esse segredo deve ser um segredo do tipo par de chave-valor.

Nome de exibição no console AWS IoT: List of ARNs for OPC-UA username/password secrets (Lista de ARNs dos segredos de nome de usuário/senha do OPC-UA

Obrigatório: false

Digite: JsonArrayOfStrings

Padrão válido: \[( ?,? ?\"(arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+\/)*[a-zA-Z0-9\/_+=,.@\\-]+-[a-zA-Z0-9]+)*\")*\]

MaximumBufferSize

O tamanho máximo em GB para uso do SiteWise disco de IoT. O padrão é 10 GB.

Nome de exibição no console do AWS IoT: Tamanho máximo do buffer de disco

Obrigatório: false

Digite: string

Padrão válido: ^\s*$|[0-9]+

Version 1

SiteWiseLocalStoragePath

O diretório no AWS IoT Greengrass host no qual o SiteWise conector de IoT pode gravar dados persistentes. Padronizado como /var/sitewise.

Nome de exibição no console AWS IoT: Caminho de armazenamento local

Obrigatório: false

Digite: string

Padrão válido: ^\s*$|\/.

SiteWiseOpcuaUserIdentityTokenSecretArn

O segredo em AWS Secrets Manager que contém o par de chave/valor de senha e o nome de usuário OPC-UA. Esse segredo deve ser um segredo do tipo par de chave/valor.

Nome de exibição no console AWS IoT: ARN do segredo de nome de usuário/senha do OPC-UA

Obrigatório: false

Digite: string

Padrão válido: ^$|arn:(aws(-[a-z]+)*):secretsmanager:[a-z0-9\\-]+:[0-9]{12}:secret:([a-zA-Z0-9\\\\]+/)*[a-zA-Z0-9/_+=,.@\\-]+-[a-zA-Z0-9]+

SiteWiseOpcuaUserIdentityTokenSecretArn-ResourceId

O recurso de segredo no grupo do AWS IoT Greengrass que faz referência a um nome de usuário e senha secreta OPC-UA.

Nome de exibição no console AWS IoT: Recurso de segredo de nome de usuário/senha do OPC-UA

Obrigatório: false

Digite: string

Padrão válido: ^$|.+

MaximumBufferSize

O tamanho máximo em GB para uso do SiteWise disco de IoT. O padrão é 10 GB.

Nome de exibição no console do AWS IoT: Tamanho máximo do buffer de disco

Obrigatório: false

Digite: string

Padrão válido: ^\s*$|[0-9]+

Exemplo de criação de conector (AWS CLI)

O AWS CLI comando a seguir cria um ConnectorDefinition com uma versão inicial que contém o conector de IoT SiteWise .


aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{
    "Connectors": [
        {
            "Id": "MyIoTSiteWiseConnector",
            "ConnectorArn": "arn:aws:greengrass:region::/connectors/IoTSiteWise/versions/11"
        }
    ]
}'

nota

As funções do Lambda nesse conector têm um ciclo de vida longo.

No console do AWS IoT Greengrass, você pode adicionar um conector na página Conectores do grupo. Para obter mais informações, consulte Conceitos básicos de conectores do Greengrass (console).

Dados de entrada

Esse conector não aceita mensagens MQTT como dados de entrada.

Dados de saída

Esse conector não publica mensagens MQTT como dados de saída.

Limites

Esse conector está sujeito aos seguintes limites impostos pela IoT SiteWise, incluindo os seguintes. Para obter mais informações, consulte Endpoints e cotas do AWS IoT SiteWise na Referência geral da AWS.

Número máximo de gateways por Conta da AWS.
Número máximo de origens OPC-UA por gateway.
Taxa máxima de pontos de dados timestamp-quality-value (TQV) armazenados por. Conta da AWS
Taxa máxima de pontos de dados TQV armazenados por propriedade de ativo.

Licenças

Changelog

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

Version (Versão)	Alterações	Data
12	Esta versão contém correções de erros.	22 de dezembro de 2021
11	Suporte para strings que contêm caracteres ocultos ou não imprimíveis. Caracteres ocultos e não imprimíveis são removidos automaticamente antes que os strings sejam enviados para o Nuvem AWS. Correção de um problema que fazia com que o SiteWise gateway de IoT repetisse infinitamente solicitações inválidas. Correção de um problema que causava um ponto de verificação corrompido quando o gateway de SiteWise IoT estava conectado a uma fonte de dados de alta frequência. Mensagens de erro aprimoradas para ajudar a solucionar problemas na configuração do gateway.	24 de março de 2021
10	Configuração do `StreamManager` para melhorar o tratamento quando a conexão de origem é perdida e restabelecida. Essa versão também aceita valores OPC-UA com um `ServerTimestamp` quando nenhum `SourceTimestamp` está disponível.	22 de janeiro de 2021
9	Suporte para destinos de fluxo personalizados do Greengrass `StreamManager`, deadbands OPC-UA, modo de varredura personalizado e taxa de varredura personalizada. Também inclui desempenho aprimorado durante atualizações de configuração feitas a partir do gateway de IoT SiteWise .	15 de dezembro de 2020
8	Estabilidade aprimorada quando o conector experimenta conectividade de rede intermitente.	19 de novembro de 2020
7	Correção de um problema com as métricas do gateway.	14 de agosto de 2020
6	Foi adicionado suporte para CloudWatch métricas e descoberta automática de novas tags OPC-UA. Esta versão requer o gerenciador de fluxo e o software do AWS IoT Greengrass Core v1.10.0 ou posterior.	29 de abril de 2020
5	Correção de um problema de compatibilidade com o software do AWS IoT Greengrass Core v1.9.4.	12 de fevereiro de 2020
4	Correção de um problema com a reconexão do servidor OPC-UA.	7 de fevereiro de 2020
3	Requisito de permissões `iot:*` removido.	17 de dezembro de 2019
2	Adição de suporte a vários recursos secretos OPC-UA.	10 de dezembro de 2019
1	Versão inicial.	2 de dezembro de 2019

Um grupo do Greengrass só pode conter uma versão do conector por vez. Para obter informações sobre como fazer upgrade de uma versão do conector, consulte Atualizar a versões do conector.

Consulte também

Integrar a serviços e protocolos usando conectores do Greengrass
Conceitos básicos de conectores do Greengrass (console)
Conceitos básicos de conectores do Greengrass (CLI)
Consulte os tópicos a seguir no Guia do usuário do AWS IoT SiteWise:

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

Adaptador do protocolo IP Ethernet IoT

Kinesis Firehose