Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Utilice un lenguaje natural para generar y actualizar las consultas de CloudWatch Logs Insights
CloudWatch Logs admite una función de consulta en lenguaje natural que le ayuda a generar y actualizar consultas para CloudWatch Logs Insights, OpenSearch Service PPL, OpenSearch Service SQL y CloudWatch Metrics Insights.
Con esta función, puede hacer preguntas sobre los datos de CloudWatch Logs que busca o describirlos en un lenguaje sencillo. La función de lenguaje natural genera una consulta basada en un mensaje que usted introduce y proporciona una line-by-line explicación de cómo funciona la consulta. También puede actualizar la consulta para investigar más a fondo los datos.
Según el entorno, puede introducir peticiones como “¿Cuáles son las 100 direcciones IP principales de origen por bytes transferidos?” y “Busque las 10 solicitudes de función de Lambda más lentas”.
nota
Por lo general, la característica de consulta en lenguaje natural está disponible en 10 regiones. En algunas regiones, esta característica realiza llamadas interregionales a regiones de Estados Unidos para procesar las solicitudes de consulta.
Para generar una consulta de CloudWatch Logs Insights con esta capacidad, abra el editor de consultas de CloudWatch Logs Insights, seleccione el grupo de registros que desee consultar y elija Generar consulta.
importante
Para utilizar la función de consulta en lenguaje natural, debe iniciar sesión con las políticas CloudWatchLogsFullAccess, CloudWatchLogsReadOnlyAccessAdministratorAccess, o de ReadOnlyAccessIAM, o tener el cloudwatch:GenerateQuery permiso correspondiente.
Consultas de ejemplo
Los ejemplos en esta sección describen cómo generar y actualizar consultas mediante la función de lenguaje natural.
nota
Para obtener más información sobre el editor de consultas y la sintaxis de CloudWatch Logs Insights, consulte Sintaxis de consultas de CloudWatch Logs Insights.
Ejemplos: generar una consulta en lenguaje natural
Para generar una consulta en lenguaje natural, introduzca una petición y seleccione Generar nueva consulta. En este ejemplo se muestran las consultas que realizan una búsqueda básica.
Petición
A continuación, se muestra un ejemplo de una petición que indica la función de buscar las 10 invocaciones más lentas de la función de Lambda.
Find the 10 slowest requests
Consultar
La siguiente es la consulta que utiliza el lenguaje de consultas CloudWatch Logs Insights que la capacidad de lenguaje natural generó en función de la solicitud. Observe cómo se muestra la petición en un comentario antes de la consulta. Tras la consulta, puede leer una explicación que describe cómo funciona la consulta.
# Find the 10 slowest requests fields @timestamp, @message, @duration | sort @duration desc | limit 10 # This query retrieves the timestamp, message and duration fields from the logs and sorts them in descending order by duration to find the 10 slowest requests.
nota
Para desactivar el aspecto de la petición y la explicación de cómo funciona la consulta, use el icono de engranaje del editor.
Petición
Para generar una consulta OpenSearch SQL, seleccione la pestaña OpenSearch SQL y, a continuación, abra el cuadro de diálogo del generador de consultas para introducir la solicitud en lenguaje natural. A continuación, se muestra un ejemplo de un mensaje que utiliza la función de lenguaje natural para generar una consulta OpenSearch SQL.
Give me the number of errors and exceptions per hour
Consultar
La siguiente es la consulta SQL generada por esa solicitud que puede utilizar para encontrar el número de errores y excepciones agregados por hora:
SELECT DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH') AS hour, COUNT(*) AS error_count FROM `/aws/lambda/CloudWatchOdysseyQueryGen` WHERE `@message` LIKE '%error%' OR `@message` LIKE '%exception%' GROUP BY DATE_FORMAT(`@timestamp`, 'yyyy-MM-dd HH') ORDER BY hour
Petición
Para generar una consulta de OpenSearch PPL, seleccione la pestaña OpenSearch PPL y, a continuación, abra el cuadro de diálogo del generador de consultas para introducir su solicitud en lenguaje natural. A continuación, se muestra un ejemplo de un mensaje que utiliza la función de lenguaje natural para generar una consulta OpenSearch PPL.
Give me all unique exception messages
Consultar
La siguiente es la consulta PPL generada por esa solicitud que puede usar para buscar los mensajes de excepción únicos en sus registros:
dedup @message | fields @message
Ejemplo: actualizar una consulta en lenguaje natural
Puede actualizar una consulta al editar la petición inicial y, a continuación, seleccionar Actualizar consulta.
Petición actualizada
El siguiente ejemplo muestra una versión actualizada de la petición anterior. En lugar de una petición que busca las 10 invocaciones de funciones de Lambda más lentas, esta petición ahora indica la capacidad de buscar las 20 invocaciones de funciones de Lambda más lentas e incluye otra columna para eventos de registro adicionales.
Show top 20 slowest requests instead and display requestId as a column
Consulta actualizada
A continuación, se muestra un ejemplo de la consulta actualizada que utiliza el lenguaje de consultas de CloudWatch Logs Insights. Observe cómo se muestra la petición actualizada en un comentario antes de la consulta actualizada. Tras la consulta, puede leer una explicación que describe cómo se actualizó la consulta original.
# Show top 20 slowest requests instead and display requestId as a column fields @timestamp, @message, @requestId, @duration | sort @duration desc | limit 20 # This query modifies the original query by replacing the @message field with the @requestId field and changing the limit from 10 to 20 to return the top 20 log events by duration instead of the top 10.
Desactivación del uso de los datos para mejorar el servicio
Los datos de la petición en lenguaje natural que proporciona para entrenar el modelo de IA y generar consultas relevantes se utilizan únicamente para proporcionar y mantener su servicio. Estos datos pueden usarse para mejorar la calidad de CloudWatch Logs Insights. La confianza y privacidad, como así también la seguridad de su contenido, son nuestra máxima prioridad. Para obtener más información, consulte Condiciones del servicio de AWS
Puede optar por que su contenido no se utilice para desarrollar o mejorar la calidad de las consultas en lenguaje natural mediante la creación de una política de exclusión de los servicios de IA. Para excluirse de la recopilación de datos para todas las funciones de CloudWatch Logs AI, incluida la capacidad de generación de consultas, debe crear una política de exclusión para CloudWatch Logs. Para obtener más información, consulte Políticas de exclusión de servicios de IA en la Guía del usuario de AWS Organizations .
