Visualização dos logs do AWS Panorama

O AWS Panorama relata eventos de aplicações 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 visualizar logs no CloudWatch Logs

1. Abra a página Grupos de log do console do CloudWatch.

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

Visualizando 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 sem fios.

• 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 do CloudWatch Logs.

• cloudwatch_agent_logs: saída do agente do CloudWatch Logs.

• shadow_log: saída da sombra do dispositivo AWS IoT.

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 vir os logs no CloudWatch Logs, verifique se você está na região da AWS correta. Se você estiver na região correta, pode haver um problema com a conexão do dispositivo com a AWS ou com as permissões no perfil do IAM AWS Identity and Access Management do dispositivo.

Configuração de logs da aplicação

Configure um logger em Python para gravar arquivos de log em /opt/aws/panorama/logs. O dispositivo transmite logs desse local para o 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.

exemplo application.py: 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.

exemplo application.py: 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: logs do agente de atualização sem fios 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 logs do seu dispositivo e da aplicação não aparecerem no CloudWatch Logs, você pode usar uma unidade USB para obter uma imagem de log 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 de memória flash USB formatada em FAT32 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

2. Conecte a unidade USB ao dispositivo.

3. Desligue o AWS Panorama Appliance.

4. Ligue o AWS Panorama Appliance.

5. O dispositivo copia os logs para o dispositivo. O LED de status pisca em azul enquanto isso está em andamento.

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