

Avviso di fine del supporto: il 31 maggio 2026, AWS terminerà il supporto per AWS Panorama. Dopo il 31 maggio 2026, non potrai più accedere alla AWS Panorama console o AWS Panorama alle risorse. Per ulteriori informazioni, consulta [AWS Panorama Fine del supporto](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html). 

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

# Visualizzazione dei log di AWS Panorama
<a name="monitoring-logging"></a>

AWS Panorama riporta gli eventi delle applicazioni e dei sistemi su Amazon CloudWatch Logs. In caso di problemi, puoi utilizzare i registri degli eventi per eseguire il debug dell'applicazione AWS Panorama o risolvere i problemi di configurazione dell'applicazione. 

**Per visualizzare i log nei log CloudWatch**

1. Apri la [pagina dei gruppi di log della console CloudWatch Logs](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups).

1. Trova i log delle applicazioni e delle appliance AWS Panorama nei seguenti gruppi:

****
   + Registri dei **dispositivi**: `/aws/panorama/devices/device-id`
   + **Registri delle applicazioni**: `/aws/panorama/devices/device-id/applications/instance-id`

Quando si esegue nuovamente il provisioning di un dispositivo dopo l'aggiornamento del software di sistema, è inoltre possibile [visualizzare i registri sull'](#monitoring-logging-provisioning)unità USB di provisioning.

**Topics**
+ [Visualizzazione dei registri dei dispositivi](#monitoring-logging-device)
+ [Visualizzazione dei log delle applicazioni](#monitoring-logging-application)
+ [Configurazione dei log delle applicazioni](#monitoring-logging-configuration)
+ [Visualizzazione dei registri di approvvigionamento](#monitoring-logging-provisioning)
+ [Registrazione dei log in uscita da un dispositivo](#monitoring-logging-egress)

## Visualizzazione dei registri dei dispositivi
<a name="monitoring-logging-device"></a>

AWS Panorama Appliance crea un gruppo di log per il dispositivo e un gruppo per ogni istanza di applicazione che distribuisci. I log del dispositivo contengono informazioni sullo stato dell'applicazione, sugli aggiornamenti del software e sulla configurazione del sistema.

**Registri dei dispositivi: `/aws/panorama/devices/device-id`**
+ `occ_log`— Uscita dal processo del controller. Questo processo coordina le distribuzioni delle applicazioni e genera report sullo stato dei nodi di ciascuna istanza dell'applicazione.
+ `ota_log`— Output del processo che coordina gli aggiornamenti del software over-the-air (OTA).
+ `syslog`— Output dal processo syslog del dispositivo, che acquisisce i messaggi inviati tra i processi.
+ `kern_log`— Eventi dal kernel Linux del dispositivo.
+ `logging_setup_logs`— Output del processo che configura l'agente CloudWatch Logs.
+ `cloudwatch_agent_logs`— Output dall'agente CloudWatch Logs.
+ `shadow_log`— Uscita dall'[ombra del AWS IoT dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html).

## Visualizzazione dei log delle applicazioni
<a name="monitoring-logging-application"></a>

Il gruppo di log di un'istanza dell'applicazione contiene un flusso di log per ogni nodo, che prende il nome dal nodo.

**Registri delle applicazioni: `/aws/panorama/devices/device-id/applications/instance-id`**
+ **Codice**: output dal codice dell'applicazione e dall'SDK per applicazioni AWS Panorama. Aggrega i log delle applicazioni da. `/opt/aws/panorama/logs`
+ **Modello**: output del processo che coordina le richieste di inferenza con un modello.
+ **Stream**: output del processo di decodifica del video proveniente dallo stream di una videocamera.
+ **Display**: output del processo di renderizzazione dell'uscita video per la porta HDMI.
+ `mds`— Registri dal server di metadati dell'appliance.
+ `console_output`— Acquisisce output standard e flussi di errore dai contenitori di codice.

Se non vedi i log in CloudWatch Logs, conferma di trovarti nella regione AWS corretta. In tal caso, potrebbe esserci un problema con la connessione dell'appliance ad AWS o con le autorizzazioni sul ruolo [dell'appliance AWS Identity and Access Management (IAM)](permissions-services.md).

## Configurazione dei log delle applicazioni
<a name="monitoring-logging-configuration"></a>

Configura un logger Python su cui scrivere i file di registro. `/opt/aws/panorama/logs` L'appliance trasmette i log da questa posizione a Logs. CloudWatch Per evitare di utilizzare troppo spazio su disco, utilizzate una dimensione massima del file di 10 MiB e un numero di backup pari a 1. L'esempio seguente mostra un metodo che crea un logger.

**Example [application.py — Configurazione](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L181) del logger**  

```
def get_logger(name=__name__,level=logging.INFO):
    logger = logging.getLogger(name)
    logger.setLevel(level)
    LOG_PATH = '/opt/aws/panorama/logs'
    handler = RotatingFileHandler("{}/app.log".format(LOG_PATH), maxBytes=10000000, backupCount=1)
    formatter = logging.Formatter(fmt='%(asctime)s %(levelname)-8s %(message)s',
                                    datefmt='%Y-%m-%d %H:%M:%S')
    handler.setFormatter(formatter)
    logger.addHandler(handler)
    return logger
```

Inizializza il logger a livello globale e usalo in tutto il codice dell'applicazione.

**Example [application.py — Inizializza](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L205) il logger**  

```
def main():
    try:
        logger.info("INITIALIZING APPLICATION")
        app = Application()
        logger.info("PROCESSING STREAMS")
        while True:
            app.process_streams()
            # turn off debug logging after 150 loops
            if logger.getEffectiveLevel() == logging.DEBUG and app.frame_num == 150:
                logger.setLevel(logging.INFO)
    except:
        logger.exception('Exception during processing loop.')

logger = get_logger(level=logging.INFO)
main()
```

## Visualizzazione dei registri di approvvigionamento
<a name="monitoring-logging-provisioning"></a>

Durante il provisioning, AWS Panorama Appliance copia i log sull'unità USB utilizzata per trasferire l'archivio di configurazione all'appliance. Usa questi log per risolvere i problemi di provisioning su appliance con la versione software più recente.

**Importante**  
I registri di provisioning sono disponibili per i dispositivi aggiornati alla versione del software 4.3.23 o successiva.

**Log di applicazioni**
+ `/panorama/occ.log`— Log del software del controller AWS Panorama.
+ `/panorama/ota_agent.log`— Log degli agenti di over-the-air aggiornamento di AWS Panorama.
+ `/panorama/syslog.log`— Log di sistema Linux.
+ `/panorama/kern.log`— Log del kernel Linux.

## Registrazione dei log in uscita da un dispositivo
<a name="monitoring-logging-egress"></a>

Se i log del dispositivo e dell'applicazione non vengono visualizzati in CloudWatch Registri, puoi utilizzare un'unità USB per estrarre un'immagine di registro crittografata dal dispositivo. Il team di assistenza AWS Panorama può decrittografare i log per tuo conto e aiutarti nel debug.

### Prerequisiti
<a name="monitoring-logging-egress-prerequisites"></a>

Per seguire la procedura è necessario il seguente hardware:
+ **Unità USB: un'unità** di memoria flash FAT32 USB formattata con almeno 1 GB di spazio di archiviazione, per il trasferimento dei file di registro da AWS Panorama Appliance. 

**Per registrare i log in uscita dal dispositivo**

1. Preparare un'unità USB con una `managed_logs` cartella all'interno di una `panorama` cartella.

   ```
   /
    └── panorama
        └── managed_logs
   ```

1. Connect l'unità USB al dispositivo.

1. [Spegni](appliance-buttons.md#appliance-buttons-reset) l'AWS Panorama Appliance.

1. Accendi AWS Panorama Appliance.

1. Il dispositivo copia i log sul dispositivo. Il LED di stato [lampeggia in blu](appliance-buttons.md) durante l'operazione.

1. I file di registro possono quindi essere trovati all'interno della `managed_logs` directory con il formato `panorama_device_log_v1_dd_hh_mm.img`

Non puoi decifrare l'immagine di registro da solo. Collabora con l'assistenza clienti, un account manager tecnico per AWS Panorama o un architetto di soluzioni per coordinarti con il team di assistenza.