

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

# Implementa l'agente Amazon Kinesis Video Streams Edge su AWS IoT Greengrass
<a name="gs-edge-gg"></a>

 

Questa sezione fornisce una guida completa per usare Amazon Kinesis Video AWS IoT Greengrass Streams con. Combinando questi servizi, puoi trasmettere in modo efficiente video dai dispositivi periferici al cloud, abilitando un'ampia gamma di applicazioni in IoT, sorveglianza e altro ancora.

Troverai informazioni dettagliate su:
+ Configurazione dell'ambiente di sviluppo 
+ Creazione di un flusso video Kinesis
+ Creazione e creazione di pacchetti di una funzione Lambda
+ Configurazione del dispositivo principale Kinesis Video Streams
+ Distribuzione sul dispositivo principale
+ Verifica del tuo stream

Segui questi passaggi per distribuire Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass per registrare e caricare contenuti multimediali da telecamere IP.

**Topics**
+ [Crea un'istanza Ubuntu Amazon EC2](gs-ubuntu.md)
+ [Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo](gs-setup-gg.md)
+ [Crea Amazon Kinesis Video Gestione dei segreti AWS Streams e risorse per la tua telecamera IP RTSP URLs](gs-create-resources.md)
+ [Aggiungi le autorizzazioni al ruolo del servizio di scambio di token (TES)](gs-add-permissions.md)
+ [Installa il componente AWS IoT Greengrass Secret Manager sul dispositivo](gs-install-secrets-manager.md)
+ [Implementa il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo](gs-deploy-edge.md)
+ [Installa il componente AWS IoT Greengrass log manager sul dispositivo](gs-publish-edge.md)

# Crea un'istanza Ubuntu Amazon EC2
<a name="gs-ubuntu"></a>

Effettua le seguenti operazioni per creare un'istanza Ubuntu Amazon EC2.

**Crea un'istanza Ubuntu Amazon EC2**

1. Accedi Console di gestione AWS e apri la console Amazon EC2 all'indirizzo. [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/)

   Verifica che sia selezionata la regione appropriata.

1. Scegliere **Launch Instance (Avvia istanza)**.

   Completare i seguenti campi:
   + **Nome**: digitate un nome per l'istanza.
   + **Immagini dell'applicazione e del sistema operativo (Amazon Machine Image)**: seleziona **Ubuntu**.
   + **Tipo di istanza**: seleziona **t2.large**.
   + **Login con coppia di chiavi**: crea la tua coppia di chiavi.
   + **Impostazioni di rete**: mantieni le impostazioni predefinite.
   + **Configurazione dello storage**: aumenta il volume a 256 GiB.
   + **Impostazioni avanzate**: mantiene le impostazioni predefinite.

1. Avvia l'istanza e inserisci SSH.

   Esegui questa operazione:

   1. Seleziona **Istanze** nella barra di navigazione a sinistra, quindi seleziona l'ID dell'istanza.

   1. Scegli **Connect** in alto a destra.

   1. Scegli il **client SSH** e segui le istruzioni sullo schermo.

   1. Apri un terminale e vai al `.pem` file scaricato (probabilmente in`~/Downloads`).

   1. La prima volta che segui queste procedure, riceverai il messaggio «L'autenticità dell'host (...) non può essere stabilita». Digita **sì**.

1. Installa le librerie di sistema per creare Amazon Kinesis Video Streams Edge Agent sull'istanza.

   ```
   wget -O- https://apt.corretto.aws/corretto.key | sudo apt-key add - 
   sudo add-apt-repository 'deb https://apt.corretto.aws stable main'
   
   sudo apt-get update
   
   sudo apt-get install -y gcc libssl-dev libcurl4-openssl-dev liblog4cplus-dev \
   libgstreamer1.0-dev libgstreamer-plugins-base1.0-dev \
   gstreamer1.0-plugins-base-apps gstreamer1.0-plugins-bad \
   gstreamer1.0-plugins-good gstreamer1.0-tools \
   unzip java-11-amazon-corretto-jdk maven
   ```
**Importante**  
**Se vedi una schermata che ti dice che alcuni servizi devono essere riavviati, premi Invio per selezionare Ok.**

   Per ulteriori informazioni, consulta la [https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html](https://docs.aws.amazon.com//corretto/latest/corretto-11-ug/generic-linux-install.html).

# Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo
<a name="gs-setup-gg"></a>

Segui queste procedure per installare il software AWS IoT Greengrass core nucleus sull'istanza Amazon EC2.

**Configura il dispositivo principale AWS IoT Greengrass**

1. Accedi a Console di gestione AWS, [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/).

   Verifica che sia selezionata la regione appropriata.

1. Nella barra di navigazione a sinistra, seleziona Dispositivi **Greengrass, Dispositivi** **Core**.

1. Scegli **Configura un dispositivo principale**.

1. Completa i passaggi visualizzati sullo schermo.
   + **Fase 1: Registrare un dispositivo Greengrass core**. Digita un nome per il dispositivo.
   + **Fase 2: Aggiungere a un gruppo di oggetti per applicare una distribuzione continua**. Seleziona **Nessun gruppo**.
   + **Fase 3: Installare il software Greengrass Core**. Seleziona **Linux**.
     + **Passaggio 3.1: Installare Java sul dispositivo**

       Java viene installato come parte di[Crea un'istanza Ubuntu Amazon EC2](gs-ubuntu.md). Tornate a questo passaggio se non avete ancora installato Java.
     + **Passaggio 3.2: Copia AWS le credenziali sul dispositivo**

       Apri l'`bash/zsh`opzione e incolla i comandi di esportazione nell'istanza Amazon EC2.
     + **Passaggio 3.3: Esegui il programma di installazione**

       1. Copia ed esegui i comandi **Scarica il programma di installazione** ed **Esegui il programma di installazione** nell'istanza Ubuntu Amazon EC2.
**Nota**  
Il comando **Esegui il programma di installazione** si aggiornerà automaticamente in base al nome scelto nel passaggio precedente.

       1. Prendi nota del ruolo TES (Token Exchange Service) che è stato creato. perché sarà necessaria in seguito.
**Nota**  
Per impostazione predefinita, il ruolo creato si chiama **TokenExchangeRoleGreenGrassV2**.

# Crea Amazon Kinesis Video Gestione dei segreti AWS Streams e risorse per la tua telecamera IP RTSP URLs
<a name="gs-create-resources"></a>

Segui queste procedure per creare gli stream e i segreti necessari in Gestione dei segreti AWS. Esegui prima questo passaggio, perché hai bisogno ARNs delle risorse create nelle politiche.

## Crea flussi video Amazon Kinesis
<a name="gs-create-kvs"></a>

Crea Amazon Kinesis Video Streams Console di gestione AWS utilizzando AWS CLI l'API, o.

Nel Console di gestione AWS, apri la console [Amazon Kinesis Video Streams](https://console.aws.amazon.com/kinesisvideo/home/). Scegli **Streams video nella barra di navigazione** a sinistra.

Per ulteriori informazioni, consulta [Crea un flusso video Amazon Kinesis](gs-createstream.md).

## Crea segreti in Gestione dei segreti AWS
<a name="gs-create-secrets"></a>

In Console di gestione AWS, apri la [Gestione dei segreti AWS console](https://console.aws.amazon.com/secretsmanager/landing). Scegli **Segreti** nella barra di navigazione a sinistra.

Verifica che sia selezionata la regione appropriata.

1. Scegli **Archivia un nuovo segreto**.

   1. **Passaggio 1: scegli il tipo segreto**
      + Selezionare **Other type of secret** (Altro tipo di segreti).
      + Nella sezione **Coppie chiave/valore, aggiungi una coppia** chiave-valore. 

        **Chiave**: `MediaURI`
**Nota**  
La chiave deve essere. `MediaURI` Fa distinzione tra maiuscole e minuscole. Se lo inserisci in modo errato, l'applicazione non funziona.

        **Valore**:`Your MediaURI`.  
**Example**  

        **Esempio:**`rtsp://<YourCameraIPAddress>:<YourCameraRTSPPort>/YourCameraMediaURI`.

   1. **Fase 2: Configurare il segreto**. Dai un nome a questo segreto. Dategli il nome che volete.

   1. **Fase 3: Configurazione della rotazione - opzionale**. Scegli **Next (Successivo)**.

   1. **Fase 4: revisione**. Scegli **Store**.

1. Se il tuo segreto non viene visualizzato immediatamente, seleziona il pulsante di aggiornamento.

   Scegli il nome del tuo segreto. Prendi nota dell'**ARN segreto**.

1. Ripeti questa procedura per ogni MediaURI da cui desideri eseguire lo streaming.

**Nota**  
La AWS rete blocca alcune fonti RTSP pubbliche. Non puoi accedervi dall'interno dell'istanza Amazon EC2 o se non sei gestito mentre sei connesso alla VPN.  
L'URL RTSP della videocamera dovrebbe trasmettere video in formato h.264. La durata del frammento non deve superare il limite indicato in. [Quote SDK di Producer](limits.md#producer-sdk-limits)  
Amazon Kinesis Video Streams Edge Agent supporta solo video.
Esegui `gst-discoverer-1.0 Your RtspUrl` per assicurarti che la videocamera sia raggiungibile dal dispositivo.

Salva il ARNs file per tutti gli stream e i segreti che hai creato. Ti servono per il passaggio successivo.

# Aggiungi le autorizzazioni al ruolo del servizio di scambio di token (TES)
<a name="gs-add-permissions"></a>

Concedi il ruolo di Token Exchange Service (TES) al dispositivo che assume le autorizzazioni per visualizzare i segreti. Ciò è necessario per il corretto funzionamento del Gestione dei segreti AWS AWS IoT Greengrass componente.

**Aggiungi autorizzazioni al ruolo TES**

1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Scegli **Ruoli** nella barra di navigazione a sinistra e cerca il ruolo TES che hai creato in precedenza nel processo.

1. Nel menu a discesa **Aggiungi autorizzazioni**, seleziona **Allega** politiche.

1. Scegli **Crea policy**.

1. **Scorri verso il basso e seleziona Modifica.**

1. Nell'editor delle policy, scegli **JSON** e modifica la policy.

   Sostituisci la politica con la seguente:
**Nota**  
Sostituisci `arn:aws:kinesisvideo:*:*:stream/streamName1/*` e `arn:aws:kinesisvideo:*:*:stream/streamName2/*` con il ARNs per gli stream che hai creato nel passaggio precedente.

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "kinesisvideo:ListStreams"
               ],
               "Resource": "*"
           },
           {
               "Effect": "Allow",
               "Action": [
                   "kinesisvideo:DescribeStream",
                   "kinesisvideo:PutMedia",
                   "kinesisvideo:TagStream",
                   "kinesisvideo:GetDataEndpoint"
               ],
               "Resource": [
                   "arn:aws:kinesisvideo:*:*:stream/streamName1/*",
                   "arn:aws:kinesisvideo:*:*:stream/streamName2/*"
               ]
           }
       ]
   }
   ```

------

1. Nella pagina **Add tags (Aggiungi tag)**, scegliere **Next: Review (Successivo: rivedi)**.

1. Assegna un nome alla tua politica, quindi scegli **Crea politica**.

   Un esempio di nome di politica è **KvsEdgeAccessPolicy**.

1. Chiudi la scheda e torna alla scheda in cui stavi allegando una politica al ruolo TES.

   Scegli il pulsante di aggiornamento, quindi cerca la politica appena creata.

   Seleziona la casella di controllo e scegli **Allega politiche**.

   Nella schermata successiva, viene visualizzata una nota che indica che **Policy è stata associata correttamente al ruolo.**

1. Crea e allega un'altra policy, questa volta per i tuoi segreti.

   Sostituisci la politica con la seguente:
**Nota**  
Sostituisci `arn:aws:secretsmanager:*:*:secret:*` con quello ARNs contenente i segreti MediaURI che hai creato in. [Crea Amazon Kinesis Video Gestione dei segreti AWS Streams e risorse per la tua telecamera IP RTSP URLs](gs-create-resources.md)

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": "secretsmanager:GetSecretValue",
               "Resource": [
                   "arn:aws:secretsmanager:*:*:secret:*",
                   "arn:aws:secretsmanager:*:*:secret:*"
               ]
           }
       ]
   }
   ```

------

1. Crea e allega un'altra policy, questa volta per Amazon CloudWatch le metriche. Sostituisci la politica con la seguente:

------
#### [ JSON ]

****  

   ```
   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Action": [
                   "cloudwatch:PutMetricData"
               ],
               "Resource": [
                   "*"
               ]
           }
       ]
   }
   ```

------

# Installa il componente AWS IoT Greengrass Secret Manager sul dispositivo
<a name="gs-install-secrets-manager"></a>

Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass richiede prima l'installazione del componente Secret Manager sul dispositivo.

**Installa il componente Secret Manager**

1. Accedi a Console di gestione AWS e apri la AWS IoT Core console all'indirizzo [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/). Verifica che sia selezionata la regione appropriata.

1. **Nella barra di navigazione a sinistra, scegli **Greengrass devices**, Deployments.**

   Scegli la distribuzione con lo stesso obiettivo dell'oggetto in cui abbiamo creato. [Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo](gs-setup-gg.md)

1. Nel menu a discesa **Azioni** nell'angolo in alto a destra, scegli **Rivedi**.

   **Nel pop-up che appare, scegli Revise deployment.**

1. Completa le seguenti sezioni:
   + **Fase 1: Specificare l'obiettivo**. Scegli **Next (Successivo)**.
   + **Fase 2: Seleziona i componenti**.
     + Verificate che il componente **AWS.GreenGrass.cli** sia selezionato. Non disinstallate questo componente.
     + **Attiva l'interruttore **Mostra solo i componenti selezionati** e cerca aws.greengrass. SecretManager**.
     + Seleziona la casella accanto a **aws.greengrass. **SecretManager**, quindi scegli Avanti.**
   + **Fase 3: Configurare i componenti**. Configura il componente AWS IoT Greengrass Secret Manager per scaricare i segreti dall' AWS IoT Greengrass ambiente.

     Seleziona **aws.greengrass. **SecretManager**componente, quindi scegli Configura componente.**

     Nella schermata che appare, aggiorna la Gestione dei segreti AWS ARNs casella **Configurazione da unire**.
**Nota**  
Sostituiscilo `arn:aws:secretsmanager:*:*:secret:*` con i ARNs segreti che hai creato in[Crea Amazon Kinesis Video Gestione dei segreti AWS Streams e risorse per la tua telecamera IP RTSP URLs](gs-create-resources.md).

     ```
     {
      "cloudSecrets": [
           {
             "arn": "arn:aws:secretsmanager:*:*:secret:*"
           },
           {
             "arn": "arn:aws:secretsmanager:*:*:secret:*"
           }
         ]
     }
     ```
**Nota**  
`cloudSecrets`è un elenco di oggetti con la chiave`arn`. Per ulteriori informazioni, [consulta la sezione Configurazione del gestore segreto](https://docs.aws.amazon.com//greengrass/v2/developerguide/secret-manager-component.html#secret-manager-component-configuration) nella Guida per gli AWS IoT Greengrass Version 2 sviluppatori. 

     Al termine, seleziona **Conferma**, quindi scegli **Avanti**.
   + **Passaggio 4: configura le impostazioni avanzate**. Seleziona **Avanti**.
   + **Passaggio 5: revisione**. Seleziona **Implementa**.

1. Verifica che il Gestione dei segreti AWS componente e le autorizzazioni siano stati installati correttamente.

   Sull'istanza Ubuntu Amazon EC2, digita `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.SecretManager` per verificare che il componente abbia ricevuto la configurazione aggiornata.

1. Ispeziona i log AWS IoT Greengrass principali.

   Tipo `sudo less /greengrass/v2/logs/greengrass.log`.

   Verifica la presenza di errori di distribuzione. 

   Se si è verificato un errore, modifica la distribuzione per rimuovere il `aws.greengrass.SecretManager` componente.

   Digitare `sudo service greengrass restart` per riavviare il servizio AWS IoT Greengrass principale.

   Se l'errore di distribuzione era correlato alla mancanza di autorizzazioni, consulta la [Aggiungi le autorizzazioni al ruolo del servizio di scambio di token (TES)](gs-add-permissions.md) sezione per assicurarti che il ruolo TES disponga delle autorizzazioni appropriate. Quindi, ripeti questa sezione.

1. **Aggiorna i segreti sul componente AWS IoT Greengrass Secret Manager**
**Importante**  
Il componente AWS IoT Greengrass Secret Manager recupera e memorizza nella cache i segreti solo quando la distribuzione viene aggiornata.

   Per aggiornare i segreti sul componente AWS IoT Greengrass Secret Manager, segui i passaggi precedenti da 1 a 6, con la seguente modifica.

   **Fase 3: Configurare** i componenti. Configura il componente AWS IoT Greengrass Secret Manager per scaricare i segreti dall' AWS IoT Greengrass ambiente.

   Seleziona **aws.greengrass. **SecretManager**componente, quindi scegli Configura componente.**

   Nella schermata che appare, incolla `[""]` la casella **Reimposta percorsi** e aggiornala Gestione dei segreti AWS ARNs nella casella **Configurazione da unire**.

   Per ulteriori informazioni, consulta [Reimpostare gli aggiornamenti](https://docs.aws.amazon.com//greengrass/v2/developerguide/update-component-configurations.html#reset-configuration-update).

# Implementa il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo
<a name="gs-deploy-edge"></a>

Effettua le seguenti operazioni per distribuire il componente Amazon Kinesis Video Streams Edge AWS IoT Greengrass Agent sul dispositivo:

**Distribuisci il componente**

1. Scarica il `tar` file utilizzando il link fornito.

   Se hai completato il modulo di interesse per Amazon Kinesis Video Streams Edge Agent, controlla la tua e-mail per il link per il download. [Se non hai completato il modulo, completalo qui.](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html)

1. Verifica il checksum.

1. Estrai i file binari e il jar dal tuo dispositivo.

   Tipo:`tar -xvf kvs-edge-agent.tar.gz`.

   Dopo l'estrazione, la struttura delle cartelle sarà simile alla seguente:

   ```
   kvs-edge-agent/LICENSE
   kvs-edge-agent/THIRD-PARTY-LICENSES
   kvs-edge-agent/pom.xml
   kvs-edge-agent/KvsEdgeComponent
   kvs-edge-agent/KvsEdgeComponent/recipes
   kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml
   kvs-edge-agent/KvsEdgeComponent/artifacts
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/edge_log_config                   
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/kvs-edge-agent.jar
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libgstkvssink.so
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/libIngestorPipelineJNI.so
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libcproducer.so
   kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib/libKinesisVideoProducer.so
   ```
**Nota**  
Il nome della cartella di rilascio deve essere impostato in modo da riflettere il numero della versione binaria più recente. Ad esempio, una versione 1.0.0 avrà il nome della cartella impostato come 1.0.0. 

1. Crea il jar delle dipendenze. 
**Nota**  
Il jar incluso in kvs-edge-agent .tar.gz non ha le dipendenze. Usa i seguenti passaggi per creare quelle librerie.

   Vai alla `kvs-edge-agent` cartella che contiene`pom.xml`. 

   Tipo `mvn clean package`.

   Questo genererà un file jar contenente le dipendenze richieste da Amazon Kinesis Video Streams Edge Agent. `kvs-edge-agent/target/libs.jar`

1. Inserisci il file libs.jar nella cartella che contiene gli artefatti del componente.

   Tipo `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/`.

1. **Facoltativo**. Configura le proprietà. Amazon Kinesis Video Streams Edge Agent accetta le seguenti variabili di ambiente AWS IoT Greengrass in modalità:    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-deploy-edge.html)

   Apri `kvs-edge-agent/KvsEdgeComponent/recipes/recipe.yaml` e modifica lo script di esecuzione per aggiungere una qualsiasi delle variabili di ambiente precedenti.
**Importante**  
Assicuratevi che lo script di esecuzione modificato non contenga caratteri di **tabulazione**. Il software AWS IoT Greengrass principale non sarà in grado di leggere la ricetta.

1. Implementa il componente Amazon Kinesis Video Streams Edge Agent. AWS IoT Greengrass 

   Type:

   ```
   sudo /greengrass/v2/bin/greengrass-cli deployment create \
     --recipeDir <download location>/kvs-edge-agent/KvsEdgeComponent/recipes/ \
     --artifactDir <download location>/kvs-edge-agent/KvsEdgeComponent/artifacts/ \
     --merge "aws.kinesisvideo.KvsEdgeComponent=EdgeAgentVersion"
   ```

   *Per ulteriori informazioni, consulta le seguenti sezioni della Guida per gli AWS IoT Greengrass Version 2 sviluppatori:*
   + [AWS IoT Greengrass Comandi CLI](https://docs.aws.amazon.com//greengrass/v2/developerguide/gg-cli-reference.html)
   + [Distribuisci AWS IoT Greengrass componenti nei dispositivi](https://docs.aws.amazon.com//greengrass/v2/developerguide/manage-deployments.html)

1. Invia le configurazioni all'applicazione utilizzando. AWS CLI

   1. Crea un nuovo file,`example-edge-configuration.json`. 

      Incolla il codice seguente nel file. Questa è una configurazione di esempio che registra ogni giorno dalle 9:00 alle 16:59:59 (in base all'ora di sistema sul dispositivo). AWS IoT Inoltre, carica i file multimediali registrati ogni giorno dalle 19:00 alle 21:59:59.

      Per ulteriori informazioni, consulta [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md).

      ```
      {
          "StreamARN": "arn:aws:kinesisvideo:your-region:your-account-id:stream/your-stream/0123456789012",
          "EdgeConfig": {
              "HubDeviceArn": "arn:aws:iot:your-region:your-account-id:thing/kvs-edge-agent-demo",
              "RecorderConfig": {
                  "MediaSourceConfig": {
                      "MediaUriSecretArn": "arn:aws:secretsmanager:your-region:your-account-id:secret:your-secret-dRbHJQ",
                      "MediaUriType": "RTSP_URI"
                  },
                  "ScheduleConfig": {
                      "ScheduleExpression": "0 0 9,10,11,12,13,14,15,16 ? * * *",
                      "DurationInSeconds": 3599
                  }
              },
              "UploaderConfig": {
                  "ScheduleConfig": {
                      "ScheduleExpression": "0 0 19,20,21 ? * * *",
                      "DurationInSeconds": 3599
                  }
              },
              "DeletionConfig": {
                  "EdgeRetentionInHours": 15,
                  "LocalSizeConfig": {
                    "MaxLocalMediaSizeInMB": 2800,
                    "StrategyOnFullSize": "DELETE_OLDEST_MEDIA"
                  },
                  "DeleteAfterUpload": true
              }
          }
      }
      ```

   1. Digita quanto segue AWS CLI per inviare il file all'agente Amazon Kinesis Video Streams Edge:

      ```
      aws kinesisvideo start-edge-configuration-update --cli-input-json "file://example-edge-configuration.json"
      ```

1. Ripeti il passaggio precedente per ogni stream per Amazon Kinesis Video Streams Edge Agent.

# Installa il componente AWS IoT Greengrass log manager sul dispositivo
<a name="gs-publish-edge"></a>

**Nota**  
Sii consapevole delle [CloudWatchquote](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html).

Segui queste procedure per configurare i log di Amazon Kinesis Video Streams Edge Agent su cui CloudWatch caricarli automaticamente AWS IoT Greengrass utilizzando il componente log manager. Questa fase è opzionale.

**Installa il componente log manager AWS IoT Greengrass**

1. Verifica che il ruolo del AWS IoT Greengrass dispositivo disponga delle [autorizzazioni appropriate](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-requirements).

   1. Accedi Console di gestione AWS e apri la console IAM all'indirizzo [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

   1. Fai clic su **Ruoli** nella barra di navigazione a sinistra.

   1. Scegli il nome del ruolo TES creato in[Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo](gs-setup-gg.md). Usa la barra di ricerca se necessario.

   1. Seleziona la `GreengrassV2TokenExchangeRoleAccess` politica.

   1. Seleziona la scheda JSON e verifica che la politica abbia il seguente aspetto:

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": [
              {
                  "Effect": "Allow",
                  "Action": [
                      "logs:CreateLogGroup",
                      "logs:CreateLogStream",
                      "logs:PutLogEvents",
                      "logs:DescribeLogStreams",
                      "s3:GetBucketLocation"
                  ],
                  "Resource": "*"
              }
          ]
      }
      ```

------

   1. Se la `GreengrassV2TokenExchangeRoleAccess` policy non esiste o se mancano alcune autorizzazioni richieste, crea una nuova policy IAM con queste autorizzazioni e collegala al ruolo TES creato in. [Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo](gs-setup-gg.md)

1. Accedi a Console di gestione AWS e apri la AWS IoT Core console all'indirizzo. [https://console.aws.amazon.com/iot/](https://console.aws.amazon.com/iot/) Verifica che sia selezionata la regione appropriata.

1. **Nella barra di navigazione a sinistra, scegli **Greengrass devices**, Deployments.**

   Scegli la distribuzione con lo stesso obiettivo dell'oggetto in cui hai creato. [Configura il dispositivo AWS IoT Greengrass V2 principale sul dispositivo](gs-setup-gg.md)

1. Nell'angolo in alto a destra, seleziona **Azioni**, quindi scegli **Rivedi.**

   Nel pop-up che appare, scegli **Revise** deployment.

1. Completa le seguenti sezioni:

   1. **Fase 1: Specificare l'obiettivo.** Scegli **Next (Successivo)**.

   1. **Fase 2: Seleziona i componenti.**

      1. **Verifica che il componente aws.GreenGrass.cli e **aws.greengrass siano presenti**. SecretManager**i componenti sono ancora selezionati.
**Importante**  
Non disinstallare questi componenti.

      1. **Attiva l'interruttore **Mostra solo i componenti selezionati** e cerca aws.greengrass. LogManager**.

      1. Seleziona la casella accanto a **aws.greengrass. **LogManager**, quindi scegli Avanti.**

   1. **Fase 3: Configurare i componenti.** Configura il componente di gestione dei AWS IoT Greengrass log per caricare i log generati da Amazon Kinesis Video Streams Edge Agent.

      **Seleziona aws.greengrass. **LogManager**componente, quindi scegli Configura componente.**

      Nella schermata che appare, incolla la seguente configurazione del log manager nella casella **Configurazione da unire**.

      ```
      {
          "logsUploaderConfiguration": {
              "componentLogsConfigurationMap": {
                  "aws.kinesisvideo.KvsEdgeComponent/java_kvs.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "java_kvs.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_edge.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_edge.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvssink.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvssink.log\\w*"
                  },
                  "aws.kinesisvideo.KvsEdgeComponent/cpp_kvs_streams.log": {
                      "diskSpaceLimit": "100",
                      "diskSpaceLimitUnit": "MB",
                      "logFileDirectoryPath": "/greengrass/v2/work/aws.kinesisvideo.KvsEdgeComponent/log",
                      "logFileRegex": "cpp_kvs_streams.log\\w*"
                  }
              }
          },
          "periodicUploadIntervalSec": "1"
      }
      ```
**Importante**  
La `logFileDirectoryPath` configurazione precedente presuppone che venga utilizzata la posizione di output di registrazione predefinita.
**Nota**  
Per ulteriori informazioni su ciascuno dei parametri per la configurazione del gestore dei registri, consultate la sezione [Log manager](https://docs.aws.amazon.com//greengrass/v2/developerguide/log-manager-component.html#log-manager-component-configuration) della Guida per gli AWS IoT Greengrass Version 2 sviluppatori.

      Al termine, seleziona **Conferma**, quindi scegli **Avanti**.

   1. **Passaggio 4: configura le impostazioni avanzate.** Seleziona **Avanti**.

   1. **Passaggio 5: revisione.** Seleziona **Implementa**.

1. Verificare che il componente e le autorizzazioni del gestore dei AWS registri siano stati installati correttamente.

1. Sull'istanza Ubuntu Amazon EC2, digita `sudo /greengrass/v2/bin/greengrass-cli component details --name aws.greengrass.LogManager` per verificare che il componente abbia ricevuto la configurazione aggiornata.

1. Ispeziona i log AWS IoT Greengrass principali.

   Tipo `sudo less /greengrass/v2/logs/greengrass.log`.

   Verifica la presenza di errori di distribuzione.

   Se si è verificato un errore, modifica la distribuzione per rimuovere il `aws.greengrass.LogManager` componente.

   Digitare `sudo service greengrass restart` per riavviare il servizio AWS IoT Greengrass principale.

   Se l'errore di distribuzione era correlato alla mancanza di autorizzazioni, verifica [Aggiungi le autorizzazioni al ruolo del servizio di scambio di token (TES)](gs-add-permissions.md) che il ruolo TES disponga delle autorizzazioni appropriate. Quindi, ripeti questa sezione.