Visualización de los registros de AWS Panorama

AWS Panorama reporta los eventos de aplicaciones y sistemas a Registros de Amazon CloudWatch. Cuando tenga problemas, puede utilizar los registros de eventos para depurar su aplicación de AWS Panorama o solucionar problemas de configuración de la aplicación.

Para ver los registros en Registros de CloudWatch

1. Abra la página de grupos de registro de la consola de Registros de CloudWatch.

2. Encuentre los registros de aplicaciones y dispositivos de AWS Panorama en los siguientes grupos:

   • Registros de dispositivos: /aws/panorama/devices/device-id

   • Registros de aplicaciones: /aws/panorama/devices/device-id/applications/instance-id

Al volver a aprovisionar un dispositivo después de actualizar el software del sistema, también puede ver los registros en la unidad USB de aprovisionamiento.

Visualización de los registros del dispositivo

El dispositivo de AWS Panorama crea un grupo de registros para el dispositivo y un grupo para cada instancia de aplicación que implemente. Los registros del dispositivo contienen información sobre el estado de la aplicación, las actualizaciones del software y la configuración del sistema.

Registros de dispositivos: /aws/panorama/devices/device-id

• occ_log: salida del proceso del controlador. Este proceso coordina las implementaciones de las aplicaciones e informa sobre el estado de los nodos de cada instancia de la aplicación.

• ota_log: salida del proceso que coordina las actualizaciones de software por vía inalámbrica (OTA).

• syslog: salida del proceso syslog del dispositivo, que captura los mensajes enviados entre procesos.

• kern_log: eventos del núcleo de Linux del dispositivo.

• logging_setup_logs: salida del proceso que configura el agente de Registros de CloudWatch.

• cloudwatch_agent_logs: salida del agente de Registros de CloudWatch.

• shadow_log: salida de la AWS IoTsombra de dispositivo.

Visualización de registros de aplicaciones

El grupo de registros de una instancia de aplicación contiene un flujo de registro para cada nodo, que lleva el nombre del nodo.

Registros de aplicaciones: /aws/panorama/devices/device-id/applications/instance-id

• Código: salida del código de su aplicación y del SDK de aplicaciones de AWS Panorama. Agrega los registros de las aplicaciones de /opt/aws/panorama/logs.

• Modelo: salida del proceso que coordina las solicitudes de inferencia con un modelo.

• Transmisión: salida del proceso que decodifica el vídeo de una secuencia de cámara.

• Pantalla: salida del proceso que renderiza la salida de vídeo para el puerto HDMI.

• mds: registros del servidor de metadatos del dispositivo.

• console_output: captura flujos de error y salida estándar de los contenedores de código.

Si no ve registros en Registros de CloudWatch, confirme que se encuentra en la Región de AWS correcta. Si es así, es posible que haya un problema con la conexión del dispositivo a AWS o con los permisos en la AWS Identity and Access Management del dispositivo (rol de IAM).

Configuración de registros de aplicaciones

Configure un registrador de Python para escribir archivos de registro en /opt/aws/panorama/logs. El dispositivo transmite los registros desde esta ubicación a Registros de CloudWatch. Para evitar ocupar demasiado espacio en disco, utilice un tamaño de archivo máximo de 10 MiB y un número de copias de seguridad de 1. En el siguiente ejemplo, se muestra un método que crea un registrador.

ejemplo application.py: configuración del registrador

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

Inicialice el registrador en el ámbito global y utilícelo en todo el código de la aplicación.

ejemplo application.py: inicializar el registrador

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()

Visualización de registros de aprovisionamiento

Durante el aprovisionamiento, el dispositivo de AWS Panorama copia los registros en la unidad USB que utilice para transferir el archivo de configuración al dispositivo. Utilice estos registros para solucionar problemas de aprovisionamiento en los dispositivos con la versión de software más reciente.

importante

Los registros de aprovisionamiento están disponibles para los dispositivos actualizados a la versión de software 4.3.23 o posterior.

Registros de aplicaciones

• /panorama/occ.log: registros del software del controlador de AWS Panorama.

• /panorama/ota_agent.log: registros de agentes de actualización inalámbrica de AWS Panorama.

• /panorama/syslog.log: registros del sistema Linux.

• /panorama/kern.log: registros de kernel de Linux.

Registros de salida de un dispositivo

Si los registros de su dispositivo y aplicación no aparecen en los Registros de CloudWatch, puede utilizar una unidad USB para extraer una imagen de registro cifrada del dispositivo. El equipo de servicio de AWS Panorama puede descifrar los registros en su nombre y ayudarle a depurarlos.

Requisitos previos

Para seguir el procedimiento, necesitará el siguiente hardware:

• Unidad USB: unidad de memoria flash USB con formato FAT32 con al menos 1 GB de almacenamiento, para transferir los archivos de registro desde el dispositivo de AWS Panorama.

Para extraer los registros del dispositivo

1. Prepare una unidad USB con una carpeta managed_logs dentro de otra carpeta panorama.

   /
    └── panorama
        └── managed_logs

2. Conecte la unidad USB al dispositivo.

3. Apague el dispositivo de AWS Panorama.

4. Encienda el dispositivo de AWS Panorama.

5. El dispositivo copia los registros en el dispositivo. El LED de estado parpadea en azul durante el proceso.

6. Los archivos de registro se pueden encontrar entonces dentro del directorio managed_logs con el formato panorama_device_log_v1_dd_hh_mm.img

No puede descifrar la imagen de registro usted mismo. Trabaje con el servicio de atención al cliente, un gerente de cuentas técnicas de AWS Panorama o un arquitecto de soluciones para coordinar con el equipo de servicio.