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à. # Pianifica la registrazione e l'archiviazione di video con Amazon Kinesis Video Streams Edge Agent Amazon Kinesis Video Streams offre un modo efficiente ed economico per connettersi alle telecamere IP nelle sedi dei clienti. Con Amazon Kinesis Video Streams Edge Agent, puoi registrare e archiviare localmente video dalle telecamere e trasmettere video al cloud secondo una pianificazione definita dal cliente per l'archiviazione, la riproduzione e l'elaborazione analitica a lungo termine. **Nota** Per accedere ad Amazon Kinesis Video Streams Edge Agent, [compila](https://pages.awscloud.com/GLOBAL-launch-DL-KVS-Edge-2023-learn.html) questo breve modulo. Puoi scaricare Amazon Kinesis Video Streams Edge Agent e distribuirlo sui tuoi dispositivi di edge computing locali. Puoi anche distribuirli facilmente in contenitori Docker in esecuzione su istanze Amazon EC2. Dopo la distribuzione, puoi utilizzare l'API Amazon Kinesis Video Streams per aggiornare le configurazioni di registrazione video e caricamento su cloud. La funzionalità funziona con qualsiasi telecamera IP in grado di eseguire lo streaming tramite il protocollo RTSP. Non richiede alcuna implementazione di firmware aggiuntivo per le telecamere. Offriamo le seguenti installazioni per Amazon Kinesis Video Streams Edge Agent: + **Come AWS IoT Greengrass V2 componente:** puoi installare Amazon Kinesis Video Streams Edge Agent AWS IoT Greengrass come componente AWS IoT Greengrass su qualsiasi dispositivo certificato. Per ulteriori informazioni AWS IoT Greengrass, consulta la [AWS IoT Greengrass Version 2 Developer](https://docs.aws.amazon.com/greengrass/v2/developerguide/) Guide. + **Sì AWS Snowball Edge:** puoi eseguire Amazon Kinesis Video Streams Edge Agent su dispositivi Snowball Edge. Per ulteriori informazioni, consulta la [AWS Snowball Edge Edge](https://docs.aws.amazon.com/snowball/latest/developer-guide/) Developer Guide. + **In una AWS IoT distribuzione nativa:** puoi installare Amazon Kinesis Video Streams Edge Agent in modo nativo su qualsiasi istanza di calcolo. Edge SDK lo utilizza [AWS IoT Core](https://docs.aws.amazon.com//iot/latest/developerguide/iot-gs.html)per gestire l'edge tramite. [Amazon Kinesis Video Streams](API_Operations_Amazon_Kinesis_Video_Streams.md) Per iniziare a usare Amazon Kinesis Video Streams Edge Agent, continua con le procedure appropriate riportate di seguito. **Topics** + [ ## Operazioni dell'API Amazon Kinesis Video Streams Edge Agent ](#edge-apis) + [ ## Monitoraggio dell'agente Amazon Kinesis Video Streams Edge ](#edge-monitoring) + [ # Implementazione in modalità diversa AWS IoT Greengrass ](gs-edge-outside.md) + [ # Implementa l'agente Amazon Kinesis Video Streams Edge su AWS IoT Greengrass ](gs-edge-gg.md) + [ # Domande frequenti su Amazon Kinesis Video Streams Edge Agent ](edge-faq.md) ## Operazioni dell'API Amazon Kinesis Video Streams Edge Agent Utilizza le seguenti operazioni API per configurare l'agente Amazon Kinesis Video Streams Edge: + [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) + [DescribeEdgeConfiguration](API_DescribeEdgeConfiguration.md) + [DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md) + [ListEdgeAgentConfigurations](API_ListEdgeAgentConfigurations.md) ## Monitoraggio dell'agente Amazon Kinesis Video Streams Edge Per monitorare il tuo Amazon Kinesis Video Streams Edge Agent, consulta. [Monitora l'agente Amazon Kinesis Video Streams Edge con CloudWatch](monitoring-edge-cloudwatch.md) # Implementazione in modalità diversa AWS IoT Greengrass Questa sezione fornisce una guida completa per usare Amazon Kinesis Video Streams al di fuori dell' AWS IoT Greengrass ambiente. Sia che lavori con dispositivi periferici o altre piattaforme, queste informazioni ti aiuteranno a configurare e utilizzare Kinesis Video Streams in modo efficace. Troverai informazioni dettagliate su: + Configurazione dell'ambiente di sviluppo + Creazione di un flusso video Kinesis + Scaricamento e compilazione dell'SDK di Kinesis Video Streams Producer + Scrittura ed esame di un'applicazione di esempio + Esecuzione dell'applicazione di esempio Continua con i passaggi seguenti per eseguire Amazon Kinesis Video Streams Edge AWS IoT Agent con MQTT come distribuzione autonoma. **Topics** + [ # Installare le dipendenze ](gs-install-dependencies.md) + [ # Crea risorse per la tua telecamera IP RTSP URLs ](gs-create-resources-standalone.md) + [ # Crea una politica di autorizzazioni IAM ](gs-iam-role.md) + [ # Creazione di un ruolo IAM ](gs-create-role.md) + [ # Crea l'alias del AWS IoT ruolo ](gs-create-role-alias.md) + [ # Crea la AWS IoT politica ](gs-create-policy.md) + [ # Crea qualsiasi AWS IoT cosa e ottieni le AWS IoT Core credenziali ](gs-create-thing.md) + [ # Crea l'agente Amazon Kinesis Video Streams Edge ](gs-build-agent.md) + [ # Installa l' CloudWatch agente sul dispositivo ](gs-install-cloudwatch.md) + [ # Esegui Amazon Kinesis Video Streams Edge Agent come processo nativo ](gs-run.md) # Installare le dipendenze Prima di iniziare a utilizzare l'SDK per produttori di Amazon Kinesis Video Streams, devi configurare l'ambiente di sviluppo con le dipendenze necessarie. Questa pagina ti guida attraverso il processo di installazione dei componenti software e delle librerie richiesti sul tuo sistema. **Nota** Per un elenco dei sistemi operativi supportati, vedere[Quali sistemi operativi supporta Amazon Kinesis Video Streams Edge Agent?](edge-faq.md#edge-faq-os). **Installa le dipendenze sul dispositivo** 1. Per eseguire Amazon Kinesis Video Streams Edge Agent, installa le seguenti librerie appropriate sul tuo dispositivo: ------ #### [ Ubuntu ] Type: ``` 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 ``` ------ #### [ Amazon Linux 2 ] Type: ``` sudo yum update -y && sudo yum upgrade -y && sudo yum clean all -y sudo yum install -y gcc-c++ openssl-devel libcurl-devel gstreamer1* wget \ java-11-amazon-corretto tar ``` Installa `log4cplus-2.1.0` dal codice sorgente. ``` wget https://github.com/log4cplus/log4cplus/releases/download/REL_2_1_0/log4cplus-2.1.0.tar.gz tar -xzvf log4cplus-2.1.0.tar.gz cd log4cplus-2.1.0 && \ mkdir build && \ cd build && \ cmake .. && \ sudo make && \ sudo make install ``` Installa `apache-maven-3.9.2` dal codice sorgente. ``` wget https://dlcdn.apache.org/maven/maven-3/3.9.2/binaries/apache-maven-3.9.2-bin.tar.gz RUN tar -xzvf apache-maven-3.9.2-bin.tar.gz -C /opt ``` ------ **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). 1. Installa il AWS Command Line Interface. Consulta la sezione [Installazione o aggiornamento della versione più recente delle AWS CLI](https://docs.aws.amazon.com//cli/latest/userguide/getting-started-install.html) procedure nella *Guida AWS Command Line Interface per l'utente*. # Crea risorse per la tua telecamera IP RTSP URLs 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 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 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://:/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. # Crea una politica di autorizzazioni IAM Segui queste procedure per creare una policy IAM. Questa politica di autorizzazioni consente il controllo selettivo dell'accesso (un sottoinsieme di operazioni supportate) per una risorsa. AWS In questo caso, le AWS risorse sono i flussi video verso i quali desideri che Amazon Kinesis Video Streams Edge Agent esegua lo streaming. Le risorse includono anche i Gestione dei segreti AWS segreti che Amazon Kinesis Video Streams Edge Agent può recuperare. [Per ulteriori informazioni, consulta le politiche IAM.](https://docs.aws.amazon.com//IAM/latest/UserGuide/access_policies.html) **Crea una policy utilizzando l'editor di policy JSON** 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. Nel riquadro di navigazione sinistro, scegli **Policy**. Se è la prima volta che selezioni **Policy**, verrà visualizzata la pagina **Benvenuto nelle policy gestite**. Seleziona **Inizia**. 1. Nella parte superiore della pagina, scegli **Crea policy**. 1. Nella sezione **Editor di policy**, scegli l'opzione **JSON**. 1. Inserisci il documento di policy JSON seguente: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "cloudwatch:PutMetricData", "kinesisvideo:ListStreams", "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "kinesisvideo:DescribeStream", "kinesisvideo:PutMedia", "kinesisvideo:TagStream", "kinesisvideo:GetDataEndpoint" ], "Resource": [ "arn:aws:kinesisvideo:*:*:stream/streamName1/*", "arn:aws:kinesisvideo:*:*:stream/streamName2/*" ] }, { "Effect": "Allow", "Action": "secretsmanager:GetSecretValue", "Resource": [ "arn:aws:secretsmanager:*:*:secret:*", "arn:aws:secretsmanager:*:*:secret:*" ] } ] } ``` ------ **Nota** Sostituisci `arn:aws:kinesisvideo:*:*:stream/streamName1/*` e `arn:aws:kinesisvideo:*:*:stream/streamName2/*` con il ARNs per i flussi video e sostituiscilo `arn:aws:secretsmanager:*:*:secret:*` con ARNs quello che contiene i segreti MediaURI in cui hai creato. [Crea risorse per la tua telecamera IP RTSP URLs](gs-create-resources-standalone.md) Usa ARNs per i segreti a cui desideri che l'agente Amazon Kinesis Video Streams Edge acceda. 1. Scegli **Next (Successivo)**. **Nota** È possibile alternare le opzioni dell'editor **Visivo** e **JSON** in qualsiasi momento. Se tuttavia si apportano modifiche o si seleziona **Successivo** nell'editor **Visivo**, IAM potrebbe ristrutturare la policy in modo da ottimizzarla per l'editor visivo. Per ulteriori informazioni, consulta la sezione [Ristrutturazione delle politiche](https://docs.aws.amazon.com//IAM/latest/UserGuide/troubleshoot_policies.html#troubleshoot_viseditor-restructure) nella Guida per l'utente IAM. 1. Nella pagina **Rivedi e crea**, inserisci **il nome della politica** e una **descrizione** opzionale per la politica che stai creando. Rivedi **Autorizzazioni definite in questa policy** per visualizzare le autorizzazioni concesse dalla policy. 1. Seleziona **Crea policy** per salvare la nuova policy. # Creazione di un ruolo IAM Il ruolo creato in questo passaggio può essere assunto da AWS IoT () per ottenere credenziali temporanee da (). AWS Security Token Service AWS STS Questa operazione viene eseguita quando si eseguono richieste di autorizzazione delle credenziali da Amazon Kinesis Video Streams Edge Agent. **Crea il ruolo di servizio per Amazon Kinesis Video Streams (console IAM)** 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. Nel pannello di navigazione della console IAM, scegliere **Ruoli** e quindi **Crea ruolo**. 1. Scegli il tipo di ruolo **Custom Trust Policy** e incolla la seguente policy: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "credentials.iot.amazonaws.com" }, "Action": "sts:AssumeRole" } } ``` ------ 1. Seleziona la casella accanto alla policy IAM in cui hai creato[Crea una politica di autorizzazioni IAM](gs-iam-role.md). 1. Scegli **Next (Successivo)**. 1. Inserisci il nome del ruolo o il suffisso del nome del ruolo per aiutarti a identificare lo scopo di questo ruolo. **Example** **Esempio**: `KvsEdgeAgentRole` 1. (Facoltativo) In **Descrizione**, inserisci una descrizione per il nuovo ruolo. 1. (Facoltativo) Aggiungi metadati al ruolo allegando tag come coppie chiave/valore. Per ulteriori informazioni sull'utilizzo dei tag in IAM, consulta [Tagging IAM resources nella IAM](https://docs.aws.amazon.com//IAM/latest/UserGuide/id_tags.html) User Guide. 1. Rivedere il ruolo e scegliere **Crea ruolo**. # Crea l'alias del AWS IoT ruolo Segui queste procedure per creare un alias di AWS IoT ruolo per il ruolo IAM in cui hai creato. [Creazione di un ruolo IAM](gs-create-role.md) Un alias di ruolo è un modello di dati alternativo che rimanda al ruolo IAM. Una richiesta del fornitore di AWS IoT credenziali deve includere un alias di ruolo per indicare quale ruolo IAM assumere per ottenere credenziali temporanee da (). AWS Security Token Service AWS STS Per ulteriori informazioni, consulta [Come usare un certificato per ottenere un](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html#authorizing-direct-aws.walkthrough) token di sicurezza. **Crea l'alias del AWS IoT ruolo** 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/). 1. Verifica che sia selezionata la regione appropriata. 1. Nella barra di navigazione a sinistra, seleziona **Sicurezza**, quindi scegli **Alias di ruolo**. 1. Scegli **Crea alias di ruolo**. 1. Inserisci un nome per l'alias del tuo ruolo. **Example** **Esempio**: `KvsEdgeAgentRoleAlias` 1. Nel menu a discesa **Ruolo**, seleziona il ruolo IAM in cui hai creato. [Creazione di un ruolo IAM](gs-create-role.md) 1. Scegli **Create** (Crea). Nella pagina successiva, vedrai una nota che indica che l'alias del tuo ruolo è stato creato con successo. 1. Cerca e seleziona l'alias di ruolo appena creato. Prendi nota dell'**alias Role ARN.** Ne hai bisogno per la AWS IoT politica nella fase successiva. # Crea la AWS IoT politica Segui queste procedure per creare una AWS IoT policy da allegare al certificato del dispositivo. Ciò fornisce le autorizzazioni necessarie alle AWS IoT funzionalità e consente l'assunzione dell'alias di ruolo utilizzando il certificato. Con AWS IoT Core le policy, puoi controllare l'accesso al piano dati. AWS IoT Core Il piano AWS IoT Core dati è costituito da operazioni che è possibile utilizzare per eseguire le seguenti operazioni: + Connect al broker di AWS IoT Core messaggi + Inviare e ricevere messaggi MQTT + Ottieni o aggiorna l'ombra del dispositivo di un oggetto Per ulteriori informazioni, consulta [policy AWS IoT Core](https://docs.aws.amazon.com//iot/latest/developerguide/iot-policies.html). **Usa l'editor di AWS IoT policy per creare una AWS IoT policy** 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/). 1. Nella barra di navigazione a sinistra, seleziona **Sicurezza**, quindi scegli **Politiche**. 1. Scegli **Crea policy**. 1. Immetti un nome da assegnare alla policy. **Example** Un esempio di nome di policy è **KvsEdgeAccessIoTPolicy**. 1. (Facoltativo) Aggiungere metadati alla policy collegando i tag come coppie chiave-valore. Per ulteriori informazioni sull'utilizzo dei tag in IAM, consulta [Tagging your AWS IoT resources](https://docs.aws.amazon.com//iot/latest/developerguide/tagging-iot.html) nella *AWS IoT Core Developer Guide*. 1. Scegli la scheda **JSON**. 1. Incolla il seguente documento di policy JSON: ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iot:Connect", "iot:Publish", "iot:Subscribe", "iot:Receive" ], "Resource": [ "*" ] }, { "Effect": "Allow", "Action": [ "sts:AssumeRoleWithWebIdentity" ], "Resource": "arn:aws:iot:us-west-2:123456789012:rolealias/your-role-alias" } ] } ``` ------ **Nota** Sostituisci `your-role-alias-arn` con l'ARN dell'alias del ruolo in cui hai creato. [Crea l'alias del AWS IoT ruolo](gs-create-role-alias.md) 1. Scegliete **Crea** per salvare il lavoro. # Crea qualsiasi AWS IoT cosa e ottieni le AWS IoT Core credenziali A questo punto hai creato: + Una politica di autorizzazioni IAM. Per informazioni, consulta [Crea una politica di autorizzazioni IAM](gs-iam-role.md). + Un ruolo IAM, con la politica delle autorizzazioni allegata. Per informazioni, consulta [Creazione di un ruolo IAM](gs-create-role.md). + Un alias di AWS IoT ruolo per il ruolo IAM. Per informazioni, consulta [Crea l'alias del AWS IoT ruolo](gs-create-role-alias.md). + Una AWS IoT politica, attualmente non associata a nessuna AWS risorsa. Per informazioni, consulta [Crea la AWS IoT politica](gs-create-policy.md). **Per creare e registrare qualsiasi AWS IoT cosa e ottenere credenziali di AWS IoT Core accesso** 1. Registra il dispositivo come AWS IoT oggetto e genera il certificato X.509 per il dispositivo. 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/) 1. Seleziona la regione appropriata. 1. Nella barra di navigazione a sinistra, seleziona **Tutti i dispositivi**, quindi scegli **Cose**. 1. Scegli **Crea cose**. 1. Seleziona **Crea un singolo oggetto**, quindi scegli **Avanti**. 1. **Fase 1: Specificate le proprietà dell'oggetto** Digita un nome per l'oggetto, quindi scegli **Avanti**. 1. **Fase 2. Configura il certificato del dispositivo** Seleziona **Genera automaticamente un nuovo certificato (consigliato)**, quindi scegli **Avanti**. 1. **Fase 3. Allega le politiche al certificato** Cerca la politica di autorizzazioni in [Crea la AWS IoT politica](gs-create-policy.md) cui hai creato. Seleziona la casella di controllo accanto alla tua politica e scegli **Crea oggetto**. 1. Nella finestra che appare, scarica i seguenti file: + Certificato del dispositivo. Questo è il certificato X.509. + File con chiave pubblica + File con chiave privata + Endpoint Amazon Trust Services (chiave RSA a 2048 bit: Amazon Root CA 1) Prendi nota della posizione di ciascuno di questi file per un passaggio successivo. 1. Seleziona **Fatto**. Nella pagina successiva, vedrai una nota che indica che il file è stato creato con successo. 1. Trasferisci i file scaricati sopra sul tuo AWS IoT dispositivo, se non è già presente. 1. Ottieni l'endpoint del fornitore di credenziali per il tuo AWS account. ------ #### [ AWS CLI ] Esegui il comando seguente: ``` aws iot describe-endpoint --endpoint-type iot:CredentialProvider ``` ------ #### [ Console di gestione AWS ] In [AWS CloudShell](https://docs.aws.amazon.com//cloudshell/latest/userguide/getting-started.html), esegui il seguente comando: ``` aws iot describe-endpoint --endpoint-type iot:CredentialProvider ``` ------ Prendi nota di queste informazioni per un passaggio successivo. 1. Ottieni l'endpoint dei dati del dispositivo per il tuo AWS account. ------ #### [ AWS CLI ] Esegui il comando seguente: ``` aws iot describe-endpoint --endpoint-type iot:Data-ATS ``` ------ #### [ Console di gestione AWS ] Esegui questa operazione: 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/). 1. Nella barra di navigazione a sinistra, seleziona **Impostazioni**. 1. Individua l'**endpoint dei dati del dispositivo**. ------ Prendi nota di queste informazioni per un passaggio successivo. 1. (Facoltativo) Verifica che i certificati siano stati generati correttamente. Esegui il comando seguente per verificare che i tuoi articoli siano stati generati correttamente. ``` curl --header "x-amzn-iot-thingname:your-thing-name" \ --cert /path/to/certificateID-certificate.pem.crt \ --key /path/to/certificateID-private.pem.key \ --cacert /path/to/AmazonRootCA1.pem \ https://your-credential-provider-endpoint/role-aliases/your-role-alias-name/credentials ``` Per ulteriori informazioni, consulta [Come usare un certificato per ottenere un token di sicurezza](https://docs.aws.amazon.com//iot/latest/developerguide/authorizing-direct-aws.html#authorizing-direct-aws.walkthrough). # Crea l'agente Amazon Kinesis Video Streams Edge **Crea l'agente Amazon Kinesis Video Streams Edge** 1. Scarica il `tar` file utilizzando il link che ti è stato 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 barattolo incluso con `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 genera un file jar contenente le dipendenze richieste da Amazon Kinesis Video Streams Edge Agent. `kvs-edge-agent/target/libs.jar` 1. Inseriscilo `libs.jar` nella cartella che contiene gli artefatti del componente. Tipo `mv ./target/libs.jar ./KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/`. 1. Imposta le variabili di ambiente utilizzando i valori dei passaggi precedenti. La tabella seguente fornisce le descrizioni delle variabili. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-build-agent.html) 1. Svuota la cache. GStreamer Type: ``` rm ~/.cache/gstreamer-1.0/registry.your-os-architecture.bin ``` Per ulteriori informazioni, consulta la [documentazione GStreamer del registro](https://gstreamer.freedesktop.org/documentation/gstreamer/gstregistry.html?gi-language=c). 1. Preparare ed eseguire il comando java. L'agente Amazon Kinesis Video Streams Edge accetta i seguenti argomenti: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/kinesisvideostreams/latest/dg/gs-build-agent.html) Per impostarli, aggiungili `-Djava-property-name=value` al comando java usato per eseguire il jar. Esempio: ``` java -Djava.library.path=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion \ --add-opens java.base/jdk.internal.misc=ALL-UNNAMED \ -Dio.netty.tryReflectionSetAccessible=true \ -cp kvs-edge-agent.jar:libs.jar \ com.amazonaws.kinesisvideo.edge.controller.ControllerApp ``` **Importante** Esegui il comando java precedente dalla stessa directory di`/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion`. 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. Per inviare il file ad Amazon Kinesis Video Streams Edge Agent, digita quanto segue nel: AWS CLI ``` 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 l' CloudWatch agente sul dispositivo **Nota** [Sii consapevole delle quote. CloudWatch](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/cloudwatch_limits_cwl.html) Segui queste procedure per installare e configurare l' CloudWatch agente su cui caricare automaticamente i log generati da Amazon Kinesis Video Streams Edge Agent. CloudWatch Questa fase è opzionale. Per [le procedure](https://docs.aws.amazon.com//AmazonCloudWatch/latest/monitoring/Install-CloudWatch-Agent.html) di installazione dell' CloudWatch agente sul tuo dispositivo, consulta la Amazon CloudWatch User Guide. Quando viene richiesta la configurazione, seleziona **una delle** seguenti configurazioni. **Importante** `file_path`Nelle configurazioni seguenti si presuppone che venga utilizzata la posizione di output di registrazione predefinita. Il percorso del file utilizzato presuppone che tu stia eseguendo Amazon Kinesis Video Streams Edge Agent dalla posizione:. `download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version` + Per configurare l' CloudWatch agente per caricare i log e pubblicare i parametri di RAM e CPU del dispositivo, incolla quanto segue nel file di configurazione. ``` { "agent": { "run_as_user": "ubuntu", "metrics_collection_interval": 60 }, "metrics": { "metrics_collected": { "mem": { "measurement": [ "mem_used_percent" ], "append_dimensions": { "IotThing": "YourIotThingName" } }, "cpu": { "resources": [ "*" ], "measurement": [ "usage_active" ], "totalcpu": true, "append_dimensions": { "IotThing": "YourIotThingName" } } } }, "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/java_kvs.log", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-java_kvs.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_edge.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_edge.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_streams.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_streams.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvssink.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvssink.log" } ] } } } } ``` + Per caricare solo i log e non raccogliere la RAM e la CPU del dispositivo, utilizza la seguente configurazione: ``` { "logs": { "logs_collected": { "files": { "collect_list": [ { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/java_kvs.log", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-java_kvs.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_edge.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_edge.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvs_streams.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvs_streams.log" }, { "file_path": "download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/version/log/cpp_kvssink.log*", "log_group_name": "/aws/kinesisvideo/EdgeRuntimeAgent", "log_stream_name": "YourIotThingName-cpp_kvssink.log" } ] } } } } ``` # Esegui Amazon Kinesis Video Streams Edge Agent come processo nativo Configura Amazon Kinesis Video Streams Edge Agent come servizio systemd. Questa fase è opzionale. `systemd`è un gestore di sistemi e servizi su dispositivi Linux. `systemd`è il modo consigliato per gestire il processo, in quanto riavvierà Amazon Kinesis Video Streams Edge Agent nel caso in cui l'applicazione riscontri un errore o il dispositivo che esegue l'applicazione perda alimentazione. Esegui questa operazione: **Esegui Amazon Kinesis Video Streams Edge Agent come processo nativo** 1. Crea un nuovo file `/etc/systemd/system` e assegnagli un nome. `aws.kinesisvideo.edge-runtime-agent.service` Incolla quanto segue: ``` [Unit] Description=AWS Kinesis Video Streams edge agent After=network.target StartLimitBurst=3 StartLimitInterval=30 [Service] Type=simple Restart=on-failure RestartSec=10 WorkingDirectory=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion Environment="GST_PLUGIN_PATH=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion" Environment="LD_LIBRARY_PATH=/download-location/kvs-edge-agent/KvsEdgeComponent/artifacts/aws.kinesisvideo.KvsEdgeComponent/EdgeAgentVersion/lib" ... Environment="AWS_IOT_CORE_DATA_ATS_ENDPOINT=data-account-specific-prefix.iot.aws-region.amazonaws.com" ExecStart=/usr/lib/jvm/java-11-amazon-corretto/bin/java --add-opens java.base/jdk.internal.misc=ALL-UNNAMED -Dio.netty.tryReflectionSetAccessible=true -cp kvs-edge-agent.jar:libs.jar com.amazonaws.kinesisvideo.edge.controller.ControllerApp [Install] WantedBy=multi-user.target ``` Per ulteriori informazioni sui parametri accettati dal file di configurazione del `systemd` servizio, consultate la [documentazione](https://www.freedesktop.org/software/systemd/man/systemd.unit.html#%5BUnit%5D%20Section%20Options). **Nota** Aggiungere le variabili di ambiente obbligatorie nella `...` posizione, come specificato in[Crea l'agente Amazon Kinesis Video Streams Edge](gs-build-agent.md). 1. Ricarica i file di servizio per includere il nuovo servizio. Tipo `sudo systemctl daemon-reload`. 1. Avviare il servizio. Tipo `sudo systemctl start aws.kinesisvideo.edge-runtime-agent.service`. 1. Controlla lo stato del servizio Amazon Kinesis Video Streams Edge Agent per verificare che sia in esecuzione. Tipo `sudo systemctl status aws.kinesisvideo.edge-runtime-agent.service`. Di seguito è riportato un esempio dell'output che vedrai. ``` aws.kinesisvideo.edge-runtime-agent.service - AWS Kinesis Video Streams edge agent Loaded: loaded (/etc/systemd/system/aws.kinesisvideo.edge-runtime-agent.service; disabled; vendor preset: enabled) Active: active (running) since Thu 2023-06-08 19:15:02 UTC; 6s ago Main PID: 506483 (java) Tasks: 23 (limit: 9518) Memory: 77.5M CPU: 4.214s CGroup: /system.slice/aws.kinesisvideo.edge-runtime-agent.service └─506483 /usr/lib/jvm/java-11-amazon-corretto/bin/java -cp kvs-edge-agent.jar:libs.jar com.amazonaws.kinesisvideo.edge.controller.ControllerApp ``` 1. Ispeziona i registri per eventuali errori. Tipo `journalctl -e -u aws.kinesisvideo.edge-runtime-agent.service`. 1. Digita `systemctl --help` per visualizzare l'elenco completo delle opzioni con cui gestire il processo. `systemctl` Di seguito sono riportati alcuni comandi comuni per gestire Amazon Kinesis Video Streams Edge Agent: + Per riavviare, digita. `sudo systemctl restart aws.kinesisvideo.edge-runtime-agent.service` + Per interrompere, digita`sudo systemctl stop aws.kinesisvideo.edge-runtime-agent.service`. + Per avviare automaticamente a ogni riavvio del dispositivo, digitare`sudo systemctl enable aws.kinesisvideo.edge-runtime-agent.service`. # Implementa l'agente Amazon Kinesis Video Streams Edge su AWS IoT Greengrass 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 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 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 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 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 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://:/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) 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 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 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 /kvs-edge-agent/KvsEdgeComponent/recipes/ \ --artifactDir /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 **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. # Domande frequenti su Amazon Kinesis Video Streams Edge Agent Di seguito sono riportate alcune domande comuni per il servizio Amazon Kinesis Video Streams Edge Agent. ## Quali sistemi operativi supporta Amazon Kinesis Video Streams Edge Agent? Amazon Kinesis Video Streams Edge Agent attualmente supporta i seguenti sistemi operativi: **Ubuntu** + 2.x + AMD64 + 18.x + ARM **AL2** + amzn2 + AMD64 amazonlinux:2.0.20210219.0-amd64 (Snowball) ## L'agente Amazon Kinesis Video Streams Edge supporta i file multimediali H.265? Amazon Kinesis Video Streams Edge Agent supporta solo flussi elementari H.264. ## L'agente Amazon Kinesis Video Streams Edge funziona in? AL2 Sì. ## Come posso eseguire più stream all'interno dell' AWS IoT oggetto o del dispositivo? Inviane un altro [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) allo stesso `HubDeviceArn` ma diverso Amazon Kinesis Video Gestione dei segreti AWS ARNs Streams/. ## Come posso modificare un messaggio `StartEdgeConfigurationUpdate` dopo che è stato inviato? Invia un aggiornamento [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) allo stesso `HubDeviceArn` con lo stesso Amazon Kinesis Video Streams ARN. Quando l'applicazione riceve il messaggio da Amazon Kinesis Video Streams, sostituisce la configurazione precedente per quel flusso. Le modifiche verranno quindi apportate. ## Hai qualche esempio comune`ScheduleConfigs`? L'agente Amazon Kinesis Video Streams Edge utilizza l'ora di sistema del dispositivo su cui è in esecuzione. | Description | ScheduleExpression | DurationInSeconds | | --- |--- |--- | | Registrazione 24 ore su 24, 7 giorni su 7, caricamento ogni ora | (null ScheduleConfig) | | Tutti i giorni dalle 9:00 alle 16:59:59 | 0 0 9-16 \$1 \$1 ? \$1 | 3599 | | 9:00:00 - 16:59:59 nei giorni feriali | 0 0 9-16 ? \$1 2-6 \$1 | 3599 | | `0 0 9-16 ? * 2,3,4,5,6 *` | 3599 | | `0 0 9-16 ? * MON-FRI *` | 3599 | | `0 0 9-16 ? * MON,TUE,WED,THU,FRI *` | 3599 | | Dalle 9:00 alle 16:59:59 nei fine settimana | `0 0 9-16 ? * SAT,SUN *` | 3599 | | 10:00:00 PM - 23:59:59 PM nei giorni feriali | `0 0 22,23 ? * MON-FRI *` | 3599 | | Dalle 9:00 alle 10:00 tutti i giorni | `0 0 9 * * ? *` | 3600 | | Tutti i giorni dalle 16:00 alle 17:59:59 | `0 0 16-17 * * ? *` | 3599 | Per altri esempi, consulta la documentazione di [Quartz](https://www.quartz-scheduler.org/documentation/quartz-2.3.0/tutorials/crontrigger.html). ## Esiste un limite massimo di streaming? Amazon Kinesis Video Streams Edge Agent ha attualmente un limite rigido di 16 stream per dispositivo. Usa l'[DeleteEdgeConfiguration](API_DeleteEdgeConfiguration.md)API per eliminare gli stream da un dispositivo. L'aggiornamento di una configurazione per lo stesso stream utilizzando il [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) non aumenta il numero di stream del dispositivo. ## Come posso riavviare un processo che ha avuto un errore? Se si verifica un errore, Amazon Kinesis Video Streams Edge Agent tenterà di riavviare il processo. Tuttavia, con alcuni errori (come errori di configurazione), è necessario riavviare manualmente il processo. Per determinare quali processi devono essere riavviati manualmente, consulta la **FatalError**metrica in. [Monitora l'agente Amazon Kinesis Video Streams Edge con CloudWatch](monitoring-edge-cloudwatch.md) Invia nuovamente il file [StartEdgeConfigurationUpdate](API_StartEdgeConfigurationUpdate.md) per riavviare il job per lo stream. ## Come posso monitorare lo stato del mio agente Amazon Kinesis Video Streams Edge? Per ulteriori informazioni, consulta [Monitora l'agente Amazon Kinesis Video Streams Edge con CloudWatch](monitoring-edge-cloudwatch.md).