Cómo desbloquear las barreras del idioma: traduzca los registros de aplicaciones con Amazon Translate para obtener un soporte perfecto

Los registros de aplicaciones son una pieza de información esencial que proporciona información crucial sobre el funcionamiento interno de una aplicación. Esto incluye información valiosa, como eventos, errores e interacciones del usuario, que ayudarían a un desarrollador de aplicaciones o a un ingeniero de soporte de operaciones a depurar y brindar soporte. Sin embargo, cuando estos registros se presentan en idiomas distintos del inglés, crea un obstáculo importante para los desarrolladores que no pueden leer el contenido y dificulta la capacidad del equipo de soporte para identificar y abordar los problemas con prontitud.

En esta publicación, exploramos una solución sobre cómo desbloquear las barreras del idioma usando Traductor de Amazonun servicio de traducción automática neuronal totalmente administrado para traducir texto hacia y desde el inglés en un amplia gama de idiomas soportados. La solución complementará sus flujos de trabajo de registro existentes al traducir automáticamente todos los registros de sus aplicaciones. Amazon CloudWatch en tiempo real, lo que puede aliviar los desafíos que plantean los registros de aplicaciones que no están en inglés.

Descripción general de la solución

Esta solución le muestra cómo puede utilizar tres servicios clave para automatizar la traducción de los registros de su aplicación de forma basada en eventos:

• CloudWatch Logs se utiliza para monitorear, almacenar y acceder a sus archivos de registro generados a partir de diversas fuentes, como los servicios de AWS y sus aplicaciones.
• Amazon Translate se utiliza para realizar la traducción de texto hacia y desde el inglés.
• AWS Lambda es un servicio informático que le permite ejecutar códigos para recuperar registros de aplicaciones y traducirlos mediante el uso de SDK de traducción de Amazon

El siguiente diagrama ilustra la arquitectura de la solución.

El flujo de trabajo consta de los siguientes pasos:

1. Una aplicación personalizada o de terceros está alojada en un Nube informática elástica de Amazon (Amazon EC2) y los registros de aplicaciones generados se cargan en CloudWatch Logs a través de Agente de registros de CloudWatch.
2. Cada entrada de registro escrita en CloudWatch Logs activa la función Lambda suscrita al grupo de registros de CloudWatch.
3. La función procesa el contenido de la entrada del registro y utiliza el SDK de Amazon Translate. traducir texto para traducir el contenido del registro.
4. El contenido del registro traducido se devuelve a la función.
5. La función vuelve a escribir el contenido del registro traducido en CloudWatch Logs en un grupo de registros diferente.

Todo el proceso ocurre automáticamente en tiempo real y sus desarrolladores podrán acceder a los registros de aplicaciones traducidos desde los grupos de registros de CloudWatch sin cambiar la forma en que su aplicación existente escribe registros en CloudWatch.

Requisitos previos

Para seguir las instrucciones de esta solución, necesita un cuenta de AWS con un Gestión de acceso e identidad de AWS (IAM) usuario que tiene permiso para Formación en la nube de AWSAmazon Translate, CloudWatch, Lambda e IAM.

Implementar la solución

Para comenzar, inicie lo siguiente Plantilla de formación de nube para crear una función Lambda, dos grupos de registros de CloudWatch y una función de IAM. Proceda a implementar con la configuración predeterminada. Esta plantilla tarda aproximadamente 1 minuto en completarse.

Una vez que la pila se haya creado correctamente, puede revisar la función Lambda navegando a la consola Lambda y localizando la función. translate-application-logs.

Puede observar que hay un activador de CloudWatch Logs agregado a la función.

Puede ver los detalles de la configuración del disparador navegando a la página Configuración pestaña y eligiendo Desencadenantes en el panel de navegación.

Puede confirmar que el activador se ha configurado para suscribirse a eventos de registro del grupo de registro. /applicationlogs. Aquí es donde se escribirán los registros de su aplicación que no estén en inglés.

A continuación, elija Variables de entorno en el panel de navegación.

Aquí se proporcionan dos variables de entorno:

• lenguaje fuente – El idioma original en el que se encuentra el registro de la aplicación (por ejemplo, ja para japonés)
• lengua de llegada – El idioma de destino al que traducir el registro de la aplicación (por ejemplo, es para inglés)

Para obtener una lista de idiomas admitidos, consulte Idiomas admitidos y códigos de idioma.

A continuación, vaya al Código pestaña y revise la lógica de la función:

import json, boto3, gzip, base64, os

translate = boto3.client(service_name="translate", region_name=os.environ['AWS_REGION'], use_ssl=True)
logs = boto3.client('logs')
    
def lambda_handler(event, context):
    # retrieve log messages
    encoded_zipped_data = event['awslogs']['data']
    zipped_data = base64.b64decode(encoded_zipped_data)
    data = gzip.decompress(zipped_data)
    json_log = json.loads(data)
    logGroup = json_log['logGroup']+'-'+os.environ['target_language']
    logStream = json_log['logStream']
    
    # check  if log group exists, create if not    
    dlg = logs.describe_log_groups(logGroupNamePrefix=logGroup)
    if len(dlg['logGroups']) == 0:
        logs.create_log_group(logGroupName=logGroup)

    # check if log stream exists, create if not    
    dls = logs.describe_log_streams(logGroupName=logGroup, logStreamNamePrefix=logStream)
    if len(dls['logStreams']) == 0:
        logs.create_log_stream(logGroupName=logGroup, logStreamName=logStream)

    # translate log event messages from source language to target language
    for logevent in json_log['logEvents']:
        logevent['message'] = translate.translate_text(Text=logevent['message'], SourceLanguageCode=os.environ['source_language'], TargetLanguageCode=os.environ['target_language']).get('TranslatedText')
        del logevent['id']

    # write translated log events back to a different log group in CloudWatch
    logs.put_log_events(
        logGroupName = logGroup,
        logStreamName = logStream,
        logEvents = json_log['logEvents']
    )
    
    # return success
    return {
        'statusCode': 200,
        'body': 'Translation success!'
    }

Prueba la solución

Finalmente, para probar la solución, puede crear un mensaje de registro a través de la consola de CloudWatch y elegir el grupo de registro y la secuencia de registro creados.

Después de crear sus mensajes de registro, podrá verlos traducidos inmediatamente.

Limpiar

Para limpiar los recursos creados en esta publicación, elimine la pila de CloudFormation a través de la consola de CloudFormation.

Conclusión

Esta publicación abordó el desafío que enfrentan los desarrolladores y los equipos de soporte cuando los registros de aplicaciones se presentan en idiomas distintos del inglés, lo que les dificulta la depuración y la prestación de soporte. La solución propuesta utiliza Amazon Translate para traducir automáticamente registros que no están en inglés en CloudWatch y proporciona orientación paso a paso sobre cómo implementar la solución en su entorno. A través de esta implementación, los desarrolladores ahora pueden superar sin problemas la barrera del idioma, permitiéndoles abordar los problemas de manera rápida y efectiva.

Pruebe esta implementación y háganos saber su opinión en los comentarios.

Sobre el Autor

Xan Huang es arquitecto senior de soluciones en AWS y tiene su sede en Singapur. Trabaja con las principales instituciones financieras para diseñar y crear soluciones seguras, escalables y de alta disponibilidad en la nube. Fuera del trabajo, Xan pasa la mayor parte de su tiempo libre con su familia y documentando el proceso de crecimiento de su hija.