Conector Edge para Kinesis Video Streams - AWS IoT Greengrass
VersõesTipoSistema operacionalRequisitosDependênciasConfiguraçãoLicençasUsoArquivo de log localChangelogConsulte 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á.

Conector Edge para Kinesis Video Streams

O conector de borda para o aws.iot.EdgeConnectorForKVS componente Kinesis Video Streams () lê os feeds de vídeo das câmeras locais e publica os streams no Kinesis Video Streams. Você pode configurar esse componente para ler feeds de vídeo de câmeras IP (Internet Protocol) usando o Real Time Streaming Protocol (RTSP). Em seguida, você pode configurar painéis no Amazon Managed Grafana ou nos servidores locais do Grafana para monitorar e interagir com os streams de vídeo.

Você pode integrar esse componente AWS IoT TwinMaker para exibir e controlar fluxos de vídeo nos painéis da Grafana. AWS IoT TwinMaker é um AWS serviço que permite criar gêmeos digitais operacionais de sistemas físicos. Você pode usar AWS IoT TwinMaker para visualizar dados de sensores, câmeras e aplicativos corporativos para rastrear suas fábricas físicas, edifícios ou plantas industriais. Você também pode usar esses dados para monitorar operações, diagnosticar erros e reparar erros. Para obter mais informações, consulte O que é AWS IoT TwinMaker? no Guia do AWS IoT TwinMaker usuário.

Esse componente armazena sua configuração em AWS IoT SiteWise, que é um AWS serviço que modela e armazena dados industriais. Em AWS IoT SiteWise, os ativos representam objetos como dispositivos, equipamentos ou grupos de outros objetos. Para configurar e usar esse componente, você cria um AWS IoT SiteWise ativo para cada dispositivo principal do Greengrass e para cada câmera IP conectada a cada dispositivo principal. Cada ativo tem propriedades que você configura para controlar recursos, como transmissão ao vivo, upload sob demanda e armazenamento em cache local. Para especificar o URL de cada câmera, você cria um segredo AWS Secrets Manager que contém o URL da câmera. Se a câmera exigir autenticação, você também especifica um nome de usuário e uma senha na URL. Em seguida, você especifica esse segredo em uma propriedade de ativo para a câmera IP.

Esse componente carrega o stream de vídeo de cada câmera em um stream de vídeo do Kinesis. Você especifica o nome do stream de vídeo do Kinesis de destino na configuração do AWS IoT SiteWise ativo para cada câmera. Se o stream de vídeo do Kinesis não existir, esse componente o cria para você.

AWS IoT TwinMaker fornece um script que você pode executar para criar esses AWS IoT SiteWise ativos e segredos do Secrets Manager. Para obter mais informações sobre como criar esses recursos e como instalar, configurar e usar esse componente, consulte a integração de AWS IoT TwinMaker vídeo no Guia do AWS IoT TwinMaker usuário.

nota

O conector edge para o componente Kinesis Video Streams está disponível somente no seguinte: Regiões da AWS

  • Leste dos EUA (Norte da Virgínia)

  • Oeste dos EUA (Oregon)

  • Europa (Frankfurt)

  • Europa (Irlanda)

  • Ásia-Pacífico (Singapura)

Versões

Esse componente tem as seguintes versões:

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

Sistema operacional

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

Requisitos

Esse componente tem os seguintes requisitos:

  • Você pode implantar esse componente somente em dispositivos de núcleo único, porque a configuração do componente deve ser exclusiva para cada dispositivo principal. Você não pode implantar esse componente em grupos de dispositivos principais.

  • GStreamer 1.18.4 ou posterior instalado no dispositivo principal. Para obter mais informações, consulte Instalando o GStreamer.

    Em um dispositivo comapt, você pode executar os seguintes comandos para instalar o GStreamer.

    sudo apt install -y libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev gstreamer1.0-plugins-base-apps
sudo apt install -y gstreamer1.0-libav
sudo apt install -y gstreamer1.0-plugins-bad gstreamer1.0-plugins-good gstreamer1.0-plugins-ugly gstreamer1.0-tools

  • Um AWS IoT SiteWise ativo para cada dispositivo principal. Esse AWS IoT SiteWise ativo representa o dispositivo principal. Para obter mais informações sobre como criar esse ativo, consulte a integração de AWS IoT TwinMaker vídeo no Guia AWS IoT TwinMaker do usuário.

  • Um AWS IoT SiteWise ativo para cada câmera IP que você conecta a cada dispositivo principal. Esses AWS IoT SiteWise ativos representam as câmeras que transmitem vídeo para cada dispositivo principal. Cada ativo da câmera deve estar associado ao ativo do dispositivo principal que se conecta à câmera. Os ativos da câmera têm propriedades que você pode configurar para especificar um stream de vídeo do Kinesis, um segredo de autenticação e parâmetros de streaming de vídeo. Para obter mais informações sobre como criar e configurar ativos de câmera, consulte a integração de AWS IoT TwinMaker vídeo no Guia AWS IoT TwinMaker do usuário.

  • Um AWS Secrets Manager segredo para cada câmera IP. Esse segredo deve definir um par de valores-chave, onde está RTSPStreamUrl a chave e o valor é a URL da câmera. Se a câmera exigir autenticação, inclua o nome de usuário e a senha nesse URL. Você pode usar um script para criar um segredo ao criar os recursos necessários para esse componente. Para obter mais informações, consulte a integração de AWS IoT TwinMaker vídeo no Guia AWS IoT TwinMaker do usuário.

    Você também pode usar o console e a API do Secrets Manager para criar segredos adicionais. Para obter mais informações, consulte Criar um segredo no Guia AWS Secrets Manager do usuário.

  • A função de troca de tokens do Greengrass deve permitir as seguintes ações AWS Secrets Manager, AWS IoT SiteWise, e do Kinesis Video Streams, conforme mostrado no exemplo de política do IAM a seguir.

    nota

    Este exemplo de política permite que o dispositivo obtenha o valor dos segredos chamados IPCamera1Url IPCamera2Url e. Ao configurar cada câmera IP, você especifica um segredo que contém a URL dessa câmera. Se a câmera exigir autenticação, você também especifica um nome de usuário e uma senha na URL. A função de troca de tokens do dispositivo principal deve permitir o acesso ao segredo para que cada câmera IP se conecte.

    {
  "Version": "2012-10-17",
  "Statement": [
    {
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Effect": "Allow",
      "Resource": [
        "arn:aws:secretsmanager:region:account-id:secret:IPCamera1Url",
        "arn:aws:secretsmanager:region:account-id:secret:IPCamera2Url"
      ]
    },
    {
      "Action": [
        "iotsitewise:BatchPutAssetPropertyValue",
        "iotsitewise:DescribeAsset",
        "iotsitewise:DescribeAssetModel",
        "iotsitewise:DescribeAssetProperty",
        "iotsitewise:GetAssetPropertyValue",
        "iotsitewise:ListAssetRelationships",
        "iotsitewise:ListAssets",
        "iotsitewise:ListAssociatedAssets",
        "kinesisvideo:CreateStream",
        "kinesisvideo:DescribeStream",
        "kinesisvideo:GetDataEndpoint",
        "kinesisvideo:PutMedia",
        "kinesisvideo:TagStream"
      ],
      "Effect": "Allow",
      "Resource": [
        "*"
      ]
    }
  ]
}
    nota

    Se você usar uma AWS Key Management Service chave gerenciada pelo cliente para criptografar segredos, a função do dispositivo também deverá permitir a kms:Decrypt ação.

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 ter mais informações, consulte Permitir o tráfego de dispositivos por meio de um proxy ou firewall.

Endpoint Porta Obrigatório Descrição

kinesisvideo.region.amazonaws.com

 443 Sim

Faça upload de dados para o Kinesis Video Streams.

data.iotsitewise.region.amazonaws.com

 443 Sim

Publique metadados do stream de vídeo em AWS IoT SiteWise.

secretsmanager.region.amazonaws.com

 443 Sim

Baixe os segredos do URL da câmera para o 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 do componente 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 1.0.0 a 1.0.5 desse componente.

Dependência Versões compatíveis Tipo de dependência
Serviço de troca de tokens >=2.0.3 Rígido
Gerenciador de streams >=2.0.9 Rígido

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

Configuração

Esse componente fornece os seguintes parâmetros de configuração que você pode personalizar ao implantar o componente.

SiteWiseAssetIdForHub

O ID do AWS IoT SiteWise ativo que representa esse dispositivo principal. Para obter mais informações sobre como criar esse ativo e usá-lo para interagir com esse componente, consulte a integração de AWS IoT TwinMaker vídeo no Guia do AWS IoT TwinMaker usuário.

exemplo Exemplo: atualização da mesclagem de configurações
{
  "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Licenças

Esse componente inclui o seguinte software/licenciamento de terceiros:

Uso

Para configurar e interagir com esse componente, você pode definir propriedades nos AWS IoT SiteWise ativos que representam o dispositivo principal e as câmeras IP às quais ele se conecta. Você também pode visualizar e interagir com streams de vídeo nos painéis da Grafana por meio de. AWS IoT TwinMaker Para obter mais informações, consulte a integração de AWS IoT TwinMaker vídeo no Guia AWS IoT TwinMaker do usuário.

Arquivo de log local

Esse componente usa o seguinte arquivo de log.

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

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

Changelog

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

Version (Versão)

Alterações

1.0.5

Melhorias e correções de erros gerais.

1.0.4
Correções de erros e melhorias

  • Corrige um problema que fazia com que o upload ao vivo parasse.

1.0.3

Melhorias e correções de erros gerais.

1.0.1

Melhorias e correções de erros gerais.

1.0.0

Versão inicial.

Consulte também