Lookout for Vision Edge Agent - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoArquivo de log localChangelog

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

Lookout for Vision Edge Agent

O componente Lookout for Vision Edge Agent (aws.iot.lookoutvision.EdgeAgent) instala um servidor de runtime local do Amazon Lookout for Vision, que usa visão computacional para encontrar defeitos visuais em produtos industriais.

Para usar esse componente, crie e implante componentes do modelo de machine learning do Lookout for Vision. Esses modelos de machine learning preveem a presença de anomalias em imagens, encontrando padrões em imagens que você usa para treinar o modelo. Em seguida, você pode desenvolver e implantar componentes personalizados do Greengrass, chamados de componentes da aplicação cliente, que fornecem imagens e fluxos de vídeo a esse componente de runtime para detectar anomalias usando os modelos de machine learning.

Você pode usar a API do Lookout for Vision Edge Agent para interagir com esse componente a partir de outros componentes do Greengrass. Essa API é implementada usando o gRPC, que é um protocolo para fazer chamadas de procedimento remoto. Para obter mais informações, consulte Writing a client application component e a referência da API do Lookout for Vision Edge Agent no Guia do desenvolvedor do Amazon Lookout for Vision.

Para obter mais informações sobre como usar essa componente, consulte o seguinte:

nota

O componente Lookout for Vision Edge Agent está disponível somente nas seguintes Regiões da AWS:

  • Leste dos EUA (Ohio)

  • Leste dos EUA (N. da Virgínia)

  • Oeste dos EUA (Oregon)

  • Europa (Frankfurt)

  • Europa (Irlanda)

  • Ásia-Pacífico (Tóquio)

  • Ásia-Pacífico (Seul)

Versões

Esse componente tem as seguintes versões:

  • 1.2.x

  • 1.1.x

  • 1.0.x

  • 0.1.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 ter mais informações, consulte Tipos de componente.

Sistema operacional

Esse componente pode ser instalado somente nos dispositivos principais do Linux.

Requisitos

Esse componente tem os seguintes requisitos:

  • O dispositivo principal do Greengrass deve usar uma arquitetura Armv8 (AArch64) ou x86_64.

  • Se você usa a versão 1.0.0 ou posterior desse componente, o Python 3.8 ou o Python 3.9, incluindo pip, instalado no dispositivo principal do Greengrass.

    Se você usa a versão 0.1.x ou posterior desse componente, o Python 3.7, incluindo pip, instalado no dispositivo principal do Greengrass.

    Importante

    O dispositivo deve ter uma dessas versões exatas do Python. Esse componente não é compatível com versões posteriores do Python.

  • Para usar a inferência de unidade de processamento gráfico (GPU), o dispositivo principal deve atender aos seguintes requisitos. A inferência de GPU é opcional na versão 1.1.0 e posterior desse componente.

    • Uma unidade de processamento gráfico (GPU) compatível com CUDA. Para obter mais informações, consulte Verify You Have a CUDA-Capable GPU na Documentação do kit de ferramentas CUDA.

    • cuDNN, CUDA e TensorRT instalados no dispositivo principal do Greengrass.

      • Nos dispositivos NVIDIA Jetson, como o Jetson Nano ou o Jetson Xavier, o cuDNN, o CUDA e o TensorRT vêm instalados com o NVIDIA JetPack. Não é necessário fazer quaisquer alterações. Esse componente é compatível com o JetPack 4.4, o JetPack 4.5, o JetPack 4.5.1 e o JetPack 4.6.1.

        Importante

        Você deve instalar uma dessas versões do JetPack e não outra versão. O serviço Lookout for Vision compila modelos de visão computacional para essas plataformas JetPack.

      • Em dispositivos x86 com uma GPU que tenha a microarquitetura NVIDIA Ampere (ou a capacidade de computação da GPU seja 8.0), faça o seguinte:

      • Em dispositivos x86 com uma GPU que tenha uma arquitetura NVIDIA anterior ao Ampere (ou a capacidade de computação da GPU seja menor que 8,0), faça o seguinte:

    • O usuário do sistema que executa esse componente deve ser um membro do grupo de sistemas que tenha acesso à GPU no dispositivo. O nome desse grupo difere de acordo com o sistema operacional. Consulte a documentação do sistema operacional e da GPU para determinar o nome desse grupo de sistemas.

      Por exemplo, em dispositivos NVIDIA Jetson, o nome desse grupo é video, e você pode executar o comando a seguir para adicionar um usuário do sistema a esse grupo. Substitua ggc_user pelo nome do usuário a ser adicionado.

      sudo usermod -aG video ggc_user

Dependências

Esse componente não tem nenhuma dependência.

Configuração

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

Socket

(Opcional) O soquete de arquivo em que o Edge Agent opera. Os componentes do modelo Lookout for Vision usam esse soquete de arquivo para se comunicar com o Edge Agent. Se você alterar esse parâmetro, deverá especificar o mesmo valor ao implantar os componentes do modelo Lookout for Vision.

Padrão: unix:///tmp/aws.iot.lookoutvision.EdgeAgent.sock

Arquivo de log local

Esse componente usa o arquivo de log abaixo.

/greengrass/v2/logs/aws.iot.lookoutvision.EdgeAgent.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 pelo caminho para a pasta raiz do AWS IoT Greengrass.

    sudo tail -f /greengrass/v2/logs/aws.iot.lookoutvision.EdgeAgent.log

Changelog

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

Version (Versão)

Alterações

1.2.0

Melhorias e correções de erros gerais.

1.1.9

Melhorias e correções de erros gerais.

1.1.8

Melhorias e correções de erros gerais.

1.1.7
Novos atributos

  • Instala o pacote opencv-python-headless no ambiente virtual Lookout for Vision Edge Agent.

Correções de bugs e melhorias

  • Melhora o cálculo da pontuação de confiança.

  • Redimensiona a máscara do modelo de mapa de calor para o tamanho original do arquivo.

  • Melhorias e correções de erros gerais.

1.1.6
Novos atributos

Novos valores adicionados ao resultado DetectAnomalies.

  • anomaly_score: o número entre 0,0 e 1,0 que indica o quão anômala é uma imagem.

  • anomaly_threshold: limite definido durante o treinamento do modelo que determina o limite entre uma imagem anômala e uma imagem normal.

Melhorias e correções de erros gerais.

1.1.4
Novos atributos

Foi adicionado suporte ao OpenCV para redimensionamento de imagens quando disponível. O agente Edge usa o Pillow quando o OpenCV não está disponível.

Correções de bugs e melhorias

Melhorias e correções de erros gerais.

1.1.3

Melhorias e correções de erros gerais.

1.1.1

Melhorias e correções de erros gerais.

1.1.0
Novos atributos

  • Adiciona suporte para modelos de segmentação de imagens, que identificam anomalias nas imagens.

  • Adiciona suporte para inferência de CPU, para que você possa usar os modelos Lookout for Vision em dispositivos principais sem uma GPU.

Correções de bugs e melhorias

  • Melhorias e correções de erros gerais.

1.0.0

Essa versão do componente Lookout for Vision Edge Agent requer uma versão do Python diferente da versão 0.1.x. Se você quiser atualizar da v0.1.x para a v1.x, você deve atualizar a instalação do Python no dispositivo principal.

Correções de bugs e melhorias

  • Melhorias e correções de erros gerais.

0.1.37

Melhorias e correções de erros gerais.

0.1.36

Versão inicial.