Aviso de fim do suporte: em 31 de maio de 2026, AWS encerrará o suporte para AWS Panorama. Depois de 31 de maio de 2026, você não poderá mais acessar o AWS Panorama console ou os AWS Panorama recursos. Para obter mais informações, consulte [AWS Panorama Fim do suporte](https://docs.aws.amazon.com/panorama/latest/dev/panorama-end-of-support.html).
As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Visualização dos logs do AWS Panorama
O AWS Panorama relata eventos de aplicativos e sistemas para o Amazon CloudWatch Logs. Ao encontrar problemas, você pode usar os logs de eventos para ajudar a depurar sua aplicação do AWS Panorama ou solucionar problemas de configuração da aplicação.
**Para ver registros em CloudWatch Registros**
1. Abra a [página Grupos de CloudWatch registros do console de registros](https://console.aws.amazon.com/cloudwatch/home#logsV2:log-groups).
1. Encontre logs de aplicações e dispositivos do AWS Panorama nos seguintes grupos:
****
+ **Logs do dispositivo**: `/aws/panorama/devices/device-id`
+ **Logs da aplicação**: `/aws/panorama/devices/device-id/applications/instance-id`
Ao reprovisionar um dispositivo após atualizar o software do sistema, você também pode [visualizar os logs na unidade USB de provisionamento](#monitoring-logging-provisioning).
**Topics**
+ [Visualizar logs do dispositivo](#monitoring-logging-device)
+ [Visualizar logs da aplicação](#monitoring-logging-application)
+ [Configuração de logs da aplicação](#monitoring-logging-configuration)
+ [Visualização de logs de provisionamento](#monitoring-logging-provisioning)
+ [Saída de logs de um dispositivo](#monitoring-logging-egress)
## Visualizar logs do dispositivo
O AWS Panorama Appliance cria um grupo de logs para o dispositivo e um grupo para cada instância da aplicação que você implantar. Os logs do dispositivo contêm informações sobre o status da aplicação, atualizações de software e configuração do sistema.
**Logs do dispositivo: `/aws/panorama/devices/device-id`**
+ `occ_log`: saída do processo do controlador. Esse processo coordena as implantações de aplicações e relata o status dos nós de cada instância da aplicação.
+ `ota_log`— Saída do processo que coordena as atualizações de software over-the-air (OTA).
+ `syslog`: saída do processo syslog do dispositivo, que captura as mensagens enviadas entre os processos.
+ `kern_log`: eventos do kernel Linux do dispositivo.
+ `logging_setup_logs`— Saída do processo que configura o agente CloudWatch Logs.
+ `cloudwatch_agent_logs`— Saída do agente CloudWatch Logs.
+ `shadow_log`: saída da [sombra do dispositivo AWS IoT](https://docs.aws.amazon.com/iot/latest/developerguide/iot-device-shadows.html).
## Visualizar logs da aplicação
O grupo de logs de uma instância de aplicação contém um fluxo de logs para cada nó, com o nome do nó.
**Logs da aplicação: `/aws/panorama/devices/device-id/applications/instance-id`**
+ **Código**: saída do código da sua aplicação e do SDK para aplicações do AWS Panorama. Agrega os logs da aplicação de `/opt/aws/panorama/logs`.
+ **Modelo**: saída do processo que coordena as solicitações de inferência com um modelo.
+ **Stream**: saída do processo que decodifica o vídeo de um stream de câmera.
+ **Monitor**: saída do processo que renderiza a saída de vídeo para a porta HDMI.
+ `mds`: logs do servidor de metadados do dispositivo.
+ `console_output`: captura streams de saída padrão e de erros dos contêineres de código.
Se você não vê registros em CloudWatch Logs, confirme se você está na região correta da AWS. Se você estiver, pode haver um problema com a conexão do dispositivo com a AWS ou com as permissões na função [do dispositivo AWS Identity and Access Management (IAM)](permissions-services.md).
## Configuração de logs da aplicação
Configure um logger em Python para gravar arquivos de log em `/opt/aws/panorama/logs`. O equipamento transmite registros desse local para CloudWatch Logs. Para evitar usar muito espaço em disco, use um tamanho máximo de arquivo de 10 MiB e uma contagem de backup de 1. O exemplo a seguir mostra um método que cria um logger.
**Example [application.py](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L181): configuração do 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
```
Inicialize o logger no escopo global e use-o em todo o código da aplicação.
**Example [application.py](https://github.com/awsdocs/aws-panorama-developer-guide/blob/main/sample-apps/aws-panorama-sample/packages/123456789012-SAMPLE_CODE-1.0/application.py#L205): inicializa o 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()
```
## Visualização de logs de provisionamento
Durante o provisionamento, o AWS Panorama Appliance copia os logs para a unidade USB que você usa para transferir o arquivo de configuração para o dispositivo. Use esses logs para solucionar problemas de provisionamento em dispositivos com a versão mais recente do software.
**Importante**
Os logs de provisionamento estão disponíveis para dispositivos atualizados para a versão de software 4.3.23 ou mais recente.
**Logs de aplicações**
+ `/panorama/occ.log`: logs do software controlador do AWS Panorama.
+ `/panorama/ota_agent.log`— Registros do agente de over-the-air atualização do AWS Panorama.
+ `/panorama/syslog.log`: logs do sistema Linux.
+ `/panorama/kern.log`: logs de kernel do Linux.
## Saída de logs de um dispositivo
Se os registros do dispositivo e do aplicativo não aparecerem nos CloudWatch Registros, você poderá usar uma unidade USB para obter uma imagem de registro criptografada do dispositivo. A equipe de serviço do AWS Panorama pode descriptografar os logs em seu nome e ajudar na depuração.
### Pré-requisitos
Para seguir o procedimento, você precisará do seguinte hardware:
+ **Unidade USB — Uma unidade** FAT32 de memória flash USB formatada com pelo menos 1 GB de armazenamento, para transferir os arquivos de log do AWS Panorama Appliance.
**Para extrair logs do dispositivo**
1. Prepare uma unidade USB com uma pasta `managed_logs` dentro de uma pasta `panorama`.
```
/
└── panorama
└── managed_logs
```
1. Conecte a unidade USB ao dispositivo.
1. [Desligue](appliance-buttons.md#appliance-buttons-reset) o AWS Panorama Appliance.
1. Ligue o AWS Panorama Appliance.
1. O dispositivo copia os logs para o dispositivo. O LED de status [pisca em azul](appliance-buttons.md) enquanto isso está em andamento.
1. Os arquivos de log podem então ser encontrados dentro do diretório `managed_logs` com o formato `panorama_device_log_v1_dd_hh_mm.img`
Não é possível decifrar a imagem do log por conta própria. Entre em contato com o suporte ao cliente, com um gerente técnico de contas do AWS Panorama ou com um arquiteto de soluções para coordenar com a equipe de serviço.