Utilice un lenguaje natural para generar y actualizar las consultas de CloudWatch Logs Insights - Amazon CloudWatch Logs

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 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. En la siguiente tabla se enumeran las regiones compatibles y se muestra dónde procesa las solicitudes cada región.

Región admitida Región donde se procesa la solicitud

Este de EE. UU. (Norte de Virginia)

Este de EE. UU. (Norte de Virginia)

Este de EE. UU. (Ohio)

Este de EE. UU. (Norte de Virginia)

Oeste de EE. UU. (Oregón)

Oeste de EE. UU. (Oregón)

Asia-Pacífico (Hong Kong)

Oeste de EE. UU. (Oregón)

Asia-Pacífico (Singapur)

Oeste de EE. UU. (Oregón)

Asia-Pacífico (Sídney)

Oeste de EE. UU. (Oregón)

Asia-Pacífico (Tokio)

Asia-Pacífico (Tokio)

Europa (Fráncfort)

Europa (Fráncfort)

Europa (Irlanda)

Este de EE. UU. (Norte de Virginia)

Europa (Estocolmo)

Este de EE. UU. (Norte de Virginia)

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.

Ejemplo: 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 muestra una consulta que realiza 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

El siguiente es un ejemplo de una consulta que la función de lenguaje natural genera según la petición. 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.

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 una consulta actualizada. 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 y Política de IA responsable 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 .