View a markdown version of this page

Connettore Edge per Kinesis Video Streams - AWS IoT Greengrass
VersioniTipoSistema operativoRequisitiDipendenzeConfigurazioneLicenzeUtilizzoFile di registro localeChangelogConsulta anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connettore Edge per Kinesis Video Streams

Il componente edge connector for Kinesis Video Streams (aws.iot.EdgeConnectorForKVS) legge i feed video dalle telecamere locali e pubblica gli stream su Kinesis Video Streams. È possibile configurare questo componente per leggere i feed video dalle telecamere IP (Internet Protocol) utilizzando il Real Time Streaming Protocol (RTSP). Quindi, puoi configurare dashboard nei server Grafana gestiti da Amazon o nei server Grafana locali per monitorare e interagire con i flussi video.

Puoi integrare questo componente AWS IoT TwinMaker per visualizzare e controllare i flussi video nelle dashboard di Grafana. AWS IoT TwinMaker è un AWS servizio che consente di creare gemelli digitali operativi di sistemi fisici. Puoi utilizzarlo AWS IoT TwinMaker per visualizzare i dati provenienti da sensori, telecamere e applicazioni aziendali per tracciare le tue fabbriche fisiche, gli edifici o gli impianti industriali. È inoltre possibile utilizzare questi dati per monitorare le operazioni, diagnosticare errori e correggere gli errori. Per ulteriori informazioni, vedi Che cos'è AWS IoT TwinMaker? nella Guida AWS IoT TwinMaker per l'utente.

Questo componente memorizza la sua configurazione in AWS IoT SiteWise, che è un AWS servizio che modella e archivia dati industriali. In AWS IoT SiteWise, le risorse rappresentano oggetti come dispositivi, apparecchiature o gruppi di altri oggetti. Per configurare e utilizzare questo componente, crei una AWS IoT SiteWise risorsa per ogni dispositivo principale Greengrass e per ogni telecamera IP connessa a ciascun dispositivo principale. Ogni risorsa ha proprietà che puoi configurare per controllare le funzionalità, come lo streaming live, il caricamento su richiesta e la memorizzazione nella cache locale. Per specificare l'URL di ogni telecamera, crei un indirizzo segreto AWS Secrets Manager che contiene l'URL della videocamera. Se la videocamera richiede l'autenticazione, specificate anche un nome utente e una password nell'URL. Quindi, si specifica quel segreto in una proprietà di risorsa per la telecamera IP.

Questo componente carica il flusso video di ciascuna telecamera in un flusso video Kinesis. Specificate il nome del flusso video Kinesis di destinazione nella configurazione delle AWS IoT SiteWise risorse per ciascuna telecamera. Se il flusso video Kinesis non esiste, questo componente lo crea per te.

AWS IoT TwinMaker fornisce uno script che potete eseguire per creare queste AWS IoT SiteWise risorse e i segreti di Secrets Manager. Per ulteriori informazioni su come creare queste risorse e su come installare, configurare e utilizzare questo componente, guarda il AWS IoT TwinMaker video di integrazione nella Guida per l'AWS IoT TwinMaker utente.

Nota

Il componente edge connector for Kinesis Video Streams è disponibile solo nei seguenti: Regioni AWS

  • Stati Uniti orientali (Virginia settentrionale)

  • Stati Uniti occidentali (Oregon)

  • Europa (Francoforte)

  • Europa (Irlanda)

  • Asia Pacifico (Singapore)

  • Asia Pacifico (Tokyo)

  • Asia Pacifico (Seul)

  • Asia Pacifico (Sydney)

  • Asia Pacifico (Mumbai)

  • Cina (Pechino)

Versioni

Questo componente ha le seguenti versioni:

  • 1.0.x

Tipo

Questo componente è un componente generico ()aws.greengrass.generic. Il nucleo di Greengrass esegue gli script del ciclo di vita del componente.

Per ulteriori informazioni, consulta Tipi di componenti.

Sistema operativo

Questo componente può essere installato solo su dispositivi Linux core.

Requisiti

Questo componente ha i seguenti requisiti:

  • È possibile distribuire questo componente solo su dispositivi single-core, poiché la configurazione del componente deve essere univoca per ogni dispositivo principale. Non è possibile distribuire questo componente su gruppi di dispositivi principali.

  • GStreamer 1.18.4 o successivo installato sul dispositivo principale. Per maggiori informazioni, consulta Installazione di GStreamer. https://gstreamer.freedesktop.org/documentation/installing/index.html?gi-language=c

    Su un dispositivo conapt, puoi eseguire i seguenti comandi per installare 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

  • Una AWS IoT SiteWise risorsa per ogni dispositivo principale. Questa AWS IoT SiteWise risorsa rappresenta il dispositivo principale. Per ulteriori informazioni su come creare questa risorsa, consultate il AWS IoT TwinMaker video sull'integrazione nella Guida per l'AWS IoT TwinMaker utente.

  • Una AWS IoT SiteWise risorsa per ogni telecamera IP connessa a ciascun dispositivo principale. Queste AWS IoT SiteWise risorse rappresentano le telecamere che trasmettono video in streaming a ciascun dispositivo principale. Ogni risorsa della videocamera deve essere associata alla risorsa del dispositivo principale che si connette alla videocamera. Le risorse della telecamera hanno proprietà che è possibile configurare per specificare uno streaming video Kinesis, un segreto di autenticazione e parametri di streaming video. Per ulteriori informazioni su come creare e configurare le risorse della telecamera, consultate l'integrazione AWS IoT TwinMaker video nella Guida per l'AWS IoT TwinMaker utente.

  • Un AWS Secrets Manager segreto per ogni telecamera IP. Questo segreto deve definire una coppia chiave-valore, dove si trova la chiave e il valore è l'URL della telecamera. RTSPStreamUrl Se la videocamera richiede l'autenticazione, includi il nome utente e la password in questo URL. È possibile utilizzare uno script per creare un segreto quando si creano le risorse richieste da questo componente. Per ulteriori informazioni, consulta l'integrazione AWS IoT TwinMaker video nella Guida AWS IoT TwinMaker per l'utente.

    Puoi anche utilizzare la console e l'API di Secrets Manager per creare ulteriori segreti. Per ulteriori informazioni, consulta Creare un segreto nella Guida AWS Secrets Manager per l'utente.

  • Il ruolo di scambio di token Greengrass deve consentire le seguenti AWS Secrets Manager azioni e Kinesis Video Streams, come mostrato nel seguente esempio di policy IAM. AWS IoT SiteWise

    Nota

    Questa policy di esempio consente al dispositivo di ottenere il valore dei segreti denominati e. IPCamera1Url IPCamera2Url Quando si configura ciascuna telecamera IP, si specifica un segreto che contiene l'URL di quella telecamera. Se la telecamera richiede l'autenticazione, specificate anche un nome utente e una password nell'URL. Il ruolo di scambio di token del dispositivo principale deve consentire l'accesso al segreto di ciascuna telecamera IP da connettere.

    JSON
    {
  "Version":"2012-10-17",
  "Statement": [
    {
      "Action": [
        "secretsmanager:GetSecretValue"
      ],
      "Effect": "Allow",
      "Resource": [
      "arn:aws:secretsmanager:us-east-1:123456789012:secret:IPCamera1Url",
  "arn:aws:secretsmanager:us-east-1:123456789012: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 utilizzi una AWS Key Management Service chiave gestita dal cliente per crittografare i segreti, anche il ruolo del dispositivo deve consentire l'kms:Decryptazione.

Endpoint e porte

Questo componente deve essere in grado di eseguire richieste in uscita ai seguenti endpoint e porte, oltre agli endpoint e alle porte necessari per il funzionamento di base. Per ulteriori informazioni, consulta Consenti il traffico dei dispositivi tramite un proxy o un firewall.

Endpoint Porta Richiesto Description

kinesisvideo.region.amazonaws.com

 443 Sì

Carica i dati su Kinesis Video Streams.

data.iotsitewise.region.amazonaws.com

 443 Sì

Pubblica i metadati dello streaming video su. AWS IoT SiteWise

secretsmanager.region.amazonaws.com

 443 Sì

Scarica i segreti degli URL della videocamera sul dispositivo principale.

Dipendenze

Quando si distribuisce un componente, vengono distribuite AWS IoT Greengrass anche versioni compatibili delle relative dipendenze. Ciò significa che è necessario soddisfare i requisiti del componente e tutte le sue dipendenze per distribuire correttamente il componente. Questa sezione elenca le dipendenze per le versioni rilasciate di questo componente e i vincoli semantici della versione che definiscono le versioni dei componenti per ciascuna dipendenza. È inoltre possibile visualizzare le dipendenze per ciascuna versione del componente nella console. AWS IoT Greengrass Nella pagina dei dettagli del componente, cerca l'elenco delle dipendenze.

La tabella seguente elenca le dipendenze per le versioni da 1.0.0 a 1.0.5 di questo componente.

Dipendenza Versioni compatibili Tipo di dipendenza
Servizio di scambio di token > = 2.0.3 Rigidi
Gestore di stream > = 2.0.9 Rigidi

Per ulteriori informazioni sulle dipendenze dei componenti, consultate il riferimento alla composizione dei componenti.

Configurazione

Questo componente fornisce i seguenti parametri di configurazione che è possibile personalizzare durante la distribuzione del componente.

SiteWiseAssetIdForHub

L'ID della AWS IoT SiteWise risorsa che rappresenta questo dispositivo principale. Per ulteriori informazioni su come creare questa risorsa e utilizzarla per interagire con questo componente, guarda il AWS IoT TwinMaker video sull'integrazione nella Guida per l'AWS IoT TwinMaker utente.

Esempio Esempio: aggiornamento dell'unione delle configurazioni
{
  "SiteWiseAssetIdForHub": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Licenze

Questo componente include le seguenti terze parti software/licensing:

Utilizzo

Per configurare e interagire con questo componente, puoi impostare le proprietà sugli AWS IoT SiteWise asset che rappresentano il dispositivo principale e le telecamere IP a cui si connette. Puoi anche visualizzare e interagire con i flussi video nelle dashboard di Grafana tramite. AWS IoT TwinMaker Per ulteriori informazioni, consulta l'integrazione AWS IoT TwinMaker video nella Guida per l'utente. AWS IoT TwinMaker

File di registro locale

Questo componente utilizza il seguente file di registro.

/greengrass/v2/logs/aws.iot.EdgeConnectorForKVS.log
Per visualizzare i log di questo componente

  • Esegui il seguente comando sul dispositivo principale per visualizzare il file di registro di questo componente in tempo reale. Sostituiscilo /greengrass/v2 con il percorso della cartella AWS IoT Greengrass principale.

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

Changelog

La tabella seguente descrive le modifiche in ciascuna versione del componente.

Versione

Modifiche

1.0.5

Correzioni di bug generali e miglioramenti.

1.0.4
Correzioni di bug e miglioramenti

  • Risolve un problema che causava l'interruzione del caricamento in tempo reale.

1.0.3

Correzioni di bug generali e miglioramenti.

1.0.1

Correzioni di bug generali e miglioramenti.

1.0.0

Versione iniziale.

Consulta anche