Reducir el tiempo que transcurre entre la detección, la investigación y la solución de los incidentes es una prioridad fundamental para las organizaciones que ejecutan cargas de trabajo de producción en AWS. Cuando surge un problema, los ingenieros de guardia suelen necesitar diagnosticar rápidamente el problema en todos los componentes de la aplicación, identificar la causa raíz y aplicar la solución, a menudo en mitad de la noche

.

AWS DevOps Agent, un agente con tecnología de inteligencia artificial que clasifica los incidentes de forma autónoma durante todo el día en función de métricas, registros y topología de aplicaciones correlacionados, aborda la primera parte de esta prioridad proporcionando un análisis de la causa raíz (RCA) y las acciones recomendadas para su resolución. Sin embargo, para mantener el control y ayudar a evitar cambios no deseados, las organizaciones suelen mantener sus agentes de observabilidad, incluido AWS DevOps Agent, en un modo de observación e informe, en el que el agente diagnostica los problemas pero no modifica los recursos de producción directamente. En esta publicación, mostramos cómo usar AWS Lambda Durable Functions, una capacidad de AWS Lambda, Amazon EventBridge y Amazon Bedrock para crear un flujo de trabajo de corrección automatizado que complemente a AWS DevOps Agent para completar el paso de resolución de problemas. Este flujo de trabajo transforma los resúmenes de las investigaciones en correcciones validadas previamente listas para una única acción de aprobación, lo que le ayuda a reducir el tiempo medio de resolución (MTTR) y a liberar a

sus ingenieros de guardia de tareas de diagnóstico repetitivas.

Descripción general de la solución

Con AWS Lambda Durable Functions, puede crear aplicaciones de varios pasos y flujos de trabajo de IA resilientes que puedan ejecutarse durante un máximo de un año sin necesidad de administrar infraestructura adicional o escribir un código personalizado de gestión de errores y administración de estados. Estas funciones comprueban automáticamente el progreso, suspenden la ejecución durante las tareas de larga duración y se recuperan de los errores, a la vez que mantienen un progreso fiable a pesar de

las interrupciones.

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

Figura 1: Flujo de trabajo de remediación automatizado a partir de una investigación de AWS DevOps Agent a través de Amazon EventBridge, AWS Lambda y Amazon Bedrock, con aprobación humana opcional antes de que los cambios lleguen a la infraestructura

El flujo de trabajo consta de los siguientes pasos:

  1. El agente DevOps de AWS completa la investigación de un incidente y emite un evento que contiene los síntomas, los hallazgos y el análisis de la causa raíz.
  2. Amazon EventBridge recibe el evento de finalización de la investigación y activa la función devops-agent-trigger con el contenido de la investigación.
  3. La función Lambda empaqueta el resumen de la investigación e invoca la función duradera devops-agent-remediation-durable.
  4. La función durable envía el contexto de la investigación a Amazon Bedrock, que analiza los hallazgos y busca las soluciones aplicables.
  5. Amazon Bedrock identifica y enumera las herramientas de corrección disponibles a partir de una lista seleccionada de funciones de Lambda aprobadas: devops-agent-lambda-tool.
  6. Amazon Bedrock propone acciones correctivas específicas en función de los resultados de la investigación y de las herramientas disponibles.
  7. En
  8. el caso de las acciones de solo lectura, la función duradera ejecuta las herramientas de corrección de forma autónoma.
  9. En el caso de los cambios en la infraestructura, el flujo de trabajo se suspende y espera la aprobación humana antes de continuar.
  10. Tras la aprobación, la función duradera aplica las acciones correctivas a la infraestructura mediante las herramientas seleccionadas.

La función duradera se ejecuta como un bucle de agencia, que llama de forma iterativa a Amazon Bedrock, ejecuta las herramientas aprobadas y devuelve los resultados a la conversación hasta que se complete la corrección. Para que las acciones automatizadas sean seguras y auditables, el orquestador aplica una lista seleccionada de herramientas de remediación permitidas. Cada herramienta es una función de Lambda diseñada específicamente que lleva a cabo una acción específica y bien definida, como leer la configuración de una función de Lambda o actualizar una declaración de política de AWS Identity and Access Management (IAM). Amazon Bedrock solo puede seleccionar e invocar herramientas de este conjunto aprobado, lo que mantiene controlado el alcance de las acciones automatizadas. El flujo de trabajo distingue además entre las operaciones de solo lectura y las operaciones de mutación. Las herramientas de solo lectura se ejecutan de forma autónoma sin intervención humana. Las acciones mutantes que modificarían el estado de la infraestructura hacen que la función duradera suspenda la ejecución y espere la aprobación humana. Aquí es donde las funciones duraderas de AWS Lambda ofrecen una ventaja clave. La función comprueba su progreso y se detiene durante minutos, horas o incluso días sin consumir recursos informáticos. Después, se reanuda exactamente donde se quedó después de recibir la señal de aprobación. Cuando el ingeniero de guardia se pone en marcha, el sistema ya ha recopilado las configuraciones pertinentes, ha correlacionado la causa principal con las medidas correctivas disponibles y ha preparado un conjunto de cambios validados previamente para su aprobación con un solo clic. La implementación actual utiliza una señal de aprobación o rechazo. Como la devolución de llamada acepta una carga JSON arbitraria, puedes extender la aprobación para incluir las anulaciones de parámetros o las observaciones de los revisores. Estas se pueden incorporar a la conversación de Bedrock para refinar la solución propuesta antes de la ejecución

.

En las siguientes secciones, analizamos los detalles de la implementación, incluida la configuración de las reglas de Amazon EventBridge y la lógica duradera de orquestación de funciones. A continuación, implementamos la solución mediante el kit de desarrollo en la nube de AWS (AWS CDK)

.

Prerrequisitos

Antes de implementar esta solución, compruebe que tiene los siguientes requisitos previos:

Simule el incidente

Para demostrar el flujo de trabajo de principio a fin, simulamos un escenario común: una función de Lambda que supera el tiempo de espera configurado. Esto permite al agente DevOps de AWS investigar un incidente real y pone en marcha el flujo de trabajo de remediación

.

Para centrarse en la solución de corrección propiamente dicha, los pasos para crear e invocar esta función de prueba se guardan en el repositorio. Incluye una función devops-agent-timeout lista para usar e instrucciones paso a paso para implementarla, invocarla y confirmar el error de tiempo de espera en Amazon CloudWatch Logs.

Para ver el tutorial completo, consulte la sección «Simular el incidente» del archivo README.

Una vez que la función esté implementada y se haya producido al menos un error de tiempo de espera, estará listo para iniciar una investigación con AWS DevOps Agent.

Implemente la solución con el AWS CDK

Complete los siguientes pasos para implementar los recursos restantes de la solución:

Kiro: Si tiene Kiro con el kit de herramientas de agentes para AWS configurado (consulte los requisitos previos), abra el repositorio clonado en Kiro y pregunte: «Configure el entorno de Python e implemente la pila de CDK. Muéstrame qué recursos se crearán antes de la implementación. » Kiro lee las reglas del proyecto desde el repositorio, configura el entorno virtual, instala las dependencias y muestra los recursos planificados antes de la implementación. Confirma cada cambio de infraestructura antes de ejecutarlo, siguiendo el mismo patrón continuo que utiliza la propia solución de corrección. Para realizar la implementación de forma manual, siga estos pasos

.
  1. Clone el código del AWS CDK alojado en GitHub:
    $ git clone https://github.com/aws-samples/sample-automate-remediation-post-devops-agent-investigation.git
  2. Navegue hasta el directorio sample-automate-remediation-post-devops-agent-investigation:
  3. $ cd sample-automatizar-remediar-pos-investigación-agente de DevOps
  4. Arranque el AWS CDK. Esto es obligatorio la primera vez que utilice el AWS CDK en un entorno de AWS específico (una combinación de una cuenta de AWS y una región de AWS).
    $ cdk bootstrap
  5. Despliegue la pila:
    $ cdk deploy

El AWS CDK aprovisiona y configura automáticamente los siguientes recursos:

  • Tres funciones de Lambda:
    • activador de agente de DevOps.
    • devops-agent-remediation-durable.
    • herramienta devops-agent-lambda.
  • Regla de Amazon EventBridge.

El AWS CDK gestiona automáticamente los permisos de IAM utilizando los principios de privilegios mínimos y las prácticas recomendadas de seguridad de AWS. Por ejemplo, Amazon EventBridge recibe los permisos lambda:invokeFunction para la función devops-agent-trigger. La pila otorga el permiso aidevops:listjournalRecords a la función devops-agent-trigger para que pueda obtener los resúmenes de las investigaciones del diario del agente DevOps de AWS.

También concede el permiso Bedrock:invokeModel a la función devops-agent-remediation-durable para que pueda invocar Amazon Bedrock.

Valide la solución

Con la pila de soluciones implementada y la función devops-agent-timeout que produce errores de tiempo de espera, ahora podemos analizar el flujo de trabajo de principio a fin.

Inicie una investigación con AWS DevOps Agent

Abra la consola de AWS DevOps Agent, navegue hasta su espacio de agente y pregunte: «¿Qué ocurre con la función devops-agent-timeout? »

AWS DevOps Agent console with a prompt asking what is happening with the devops-agent-timeout function

Figura 2: Inicio de una investigación desde la consola de AWS DevOps Agent

La investigación comienza y tarda unos minutos en completarse. Durante este tiempo, AWS DevOps Agent correlaciona de forma autónoma las métricas, los registros y la configuración de la función de CloudWatch para determinar

la causa principal.
AWS DevOps Agent investigation in progress, correlating Amazon CloudWatch metrics, logs, and the function configuration

Figura 3: Correlación de las señales del agente DevOps de AWS durante la investigación

Una vez finalizada la investigación, el agente de DevOps de AWS presenta el análisis de la causa raíz e identifica que el tiempo de espera de la función no es suficiente para la carga de trabajo.

AWS DevOps Agent root cause analysis identifying that the function timeout is insufficient for the workload

Figura 4: El análisis de la causa raíz que identifica el tiempo de espera insuficiente de la función

Verifique la ejecución del disparador de Lambda

Al finalizar la investigación, se emite un evento de investigación completada a Amazon EventBridge.

La regla activa la función Lambda devops-agent-trigger, que obtiene el resumen de la investigación del diario del agente DevOps de AWS.

En el grupo de registros de CloudWatch /aws/lambda/devops-agent-trigger, puede ver el resumen analizado que se envía a la función duradera devops-agent-remediation-durable, que incluye los síntomas, las causas principales, las causas contribuyentes y las brechas en la investigación.
CloudWatch log group showing the parsed investigation summary with symptoms, root causes, contributing causes, and investigation gaps

Figura 5: El resumen de la investigación analizada en el grupo de registros de CloudWatch con la función activadora

Supervise la ejecución duradera de la función

Navegue hasta la consola de Lambda, abra la función devops-agent-remediation-durable y seleccione la pestaña Ejecuciones duraderas. Elija la nueva ejecución para inspeccionar sus pasos puntuales

.
Lambda console Durable executions tab showing the remediation durable function execution and its checkpointed steps

Figura 6: La ejecución duradera de la función y sus pasos puntuales en la consola Lambda

El orquestador duradero comienza su ciclo de agencia enviando el contexto de la investigación a Amazon Bedrock. En la primera llamada de Bedrock, el modelo analiza el resumen de la investigación y determina que necesita inspeccionar la configuración actual de la función antes de proponer una solución. Selecciona la herramienta lambda_get_function_configuration de la lista de permitidos. Como se trata de una operación de solo lectura, se ejecuta de forma autónoma sin necesidad de aprobación humana. El resultado del paso muestra la configuración actual de la función devops-agent-timeout

y confirma un valor de tiempo de espera de 3 segundos.
Durable execution step result showing the devops-agent-timeout function configuration with a 3-second timeout

Figura 7: La llamada a la herramienta de solo lectura que devuelve la configuración actual de tiempo de espera de 3 segundos

Amazon Bedrock propone la solución

Una vez confirmada la configuración actual, Amazon Bedrock pasa a la siguiente iteración. Considera que el tiempo de espera de 3 segundos es la causa principal de los errores y propone aumentarlo a 30 segundos. La respuesta de Amazon Bedrock contiene tanto el razonamiento como la llamada a la herramienta

:
{
 ...
 },
 «salida»: {
 «mensaje»: {
 «rol»: «asistente»,
 «contenido»: [
 {
 «text»: «Ahora puedo ver que la configuración actual confirma el problema: la función tiene un tiempo de espera de 3 segundos. Dado que parece ser una función de prueba para situaciones en las que se agota el tiempo de espera (según el nombre\ "devops-agent-timeout\» y su asociación con\ "DevOps Agent Test Infrastructure\»), aumentaré el tiempo de espera a un valor razonable que permita que la función se complete correctamente. Lo estableceré en 30 segundos, que es un tiempo de espera habitual en las funciones de Lambda que necesitan más tiempo de ejecución».
 },
 {
 «Uso de herramientas»: {
 «toolUseID»: «toolUse_lcghbwdxng5HiLpMhwagds»,
 «nombre»: «lambda_update_function_configuration»,
 «entrada»: {
 «functionName»: «tiempo de espera de devops-agent-timeout»,
 «Tiempo de espera»: 30
 },
 «type»: «tool_use»
 }
 }
 ...
 
}

Como lambda_update_function_configuration es una acción mutante, la función duradera suspende la ejecución y espera la aprobación humana.

cloudwatch logs output of lambda durable function for approval requestFigura 8: cloudwatch registra la salida de la función duradera de lambda para la solicitud de aprobación

Importante: El resumen de la investigación enviado a Amazon Bedrock y la solución que propone se generan mediante inteligencia artificial y siempre deben revisarse antes de su aprobación.

La puerta de aprobación humana es el control de seguridad: el aprobador debe inspeccionar todos los parámetros de la herramienta (por ejemplo, el nombre de la función y el tiempo de espera exactos en una llamada lambda_update_function_configuration) y confirmar que el cambio es correcto.

Uso de la CLI de AWS:

$ aws lambda send-durable-execution-callback-success\
 --id de devolución de llamada\
 --cli-formato binario raw-in-base64-out\
 --result '{"aprobado»: verdadero}'

Uso de la consola de AWS:

Navegue hasta la ejecución permanente, seleccione la devolución de llamada pendiente y elija Enviar correctamente para confirmar:

Lambda console durable execution with the pending callback selected and the Send success option highlighted

Figura 9: Aprobación de la corrección seleccionando Enviar correctamente en la consola de Lambda

En el campo de entrada, introduzca {'approved': true} y confirme.

Send success dialog with the input field containing the approved true payload

Figura 10: Ingresar la carga útil de aprobación para confirmar la devolución de llamada

Verifique la corrección

Tras la aprobación, la función duradera se reanuda, invoca la herramienta Lambda para actualizar la configuración y Amazon Bedrock confirma que se ha completado la corrección. La función devops-agent-timeout actualizada ahora muestra

el nuevo valor de tiempo de espera:
Lambda console showing the devops-agent-timeout function updated to a 30-second timeout

Figura 11: La configuración de la función devops-agent-timeout se actualizó a un tiempo de espera de 30 segundos

El resultado del último paso (bedrock-call-4) confirma que la corrección se ha realizado correctamente:

{
 «EventType»: «Paso realizado correctamente»,
 «Nombre»: «bedrock-call-4",
 ...
 },
 «salida»: {
 «mensaje»: {
 «rol»: «asistente»,
 «contenido»: [
 {
 «text»: «## Remediación completada
 **Problema identificado: ** La función Lambda `devops-agent-timeout` de eu-west-1 se configuró con un tiempo de espera de 3 segundos que no era suficiente para su tiempo de ejecución, lo que provocaba errores de tiempo de espera de exactamente 3000 ms.
 **Acción tomada: ** Se actualizó correctamente la configuración de la función Lambda para aumentar el tiempo de espera de 3 a 30 segundos.
 **Verificación: ** Se confirmó que el cambio de configuración se aplicó correctamente. La función ahora tiene:
 - **Tiempo de espera: ** 30 segundos (en vez de 3 segundos)
 - **Estado: ** La actualización se ha completado correctamente
 - **Última modificación: ** 2026-05-22T 11:11:28.000 +0000
 Esta corrección debería resolver los errores de tiempo de espera proporcionando a la función el tiempo suficiente para completar su ejecución. El tiempo de espera de 30 segundos multiplica por 10 el límite original de 3 segundos, lo que debería ser suficiente para la mayoría de las operaciones y, al mismo tiempo, mantener unos límites de ejecución razonables para una función de Lambda».
 }
 ]
 }
 },
 «StopReason»: «end_turn»,
 ...
}

Todo este ciclo, desde la detección de incidentes hasta la reparación automática, solo requirió una única acción de aprobación por parte del ingeniero. El sistema gestionó el diagnóstico, la recuperación de la configuración, la propuesta de corrección y la ejecución

de forma autónoma.

Limpiar

Limpia los recursos que creaste realizando los siguientes pasos:

Kiro: Si usa Kiro con el kit de herramientas de agentes para AWS, pregúntese: «Elimine todos los recursos de la demostración de corrección de DevOps Agent: destruya la pila de CDK, elimine la función de prueba devops-agent-timeout, su función de IAM y su grupo de registros de CloudWatch». Kiro elimina los recursos en el orden correcto y confirma cada acción destructiva antes de continuar. Para limpiar manualmente, sigue estos pasos

.
  1. Elimine los recursos de AWS CDK:
    $ cdk destruir
  2. Elimine manualmente la función devops-agent-timeout que simula el incidente:
  3. $ aws lambda delete-function --function-name devops-agent-timeout
  4. Elimine manualmente la función de IAM y el grupo de registros de CloudWatch de la función devops-agent-timeout:
    Política de
    separación de roles de $ aws iam\
     --nombre del rol devops-agent-timeout-role\
     --policy-arn arn:aws:iam: :aws:policy/service-role/awslambda rol de ejecución básico
    $ aws iam delete-role --role-name devops-agent-timeout-role
    $ aws registra delete-log-group --log-group-name /aws/lambda/devops-agent-timeout

Conclusión

En esta publicación se demostró cómo puede automatizar la solución de problemas mediante el uso de Lambda Durable Functions, Amazon EventBridge y Bedrock junto con el agente de DevOps. La solución continúa donde termina AWS DevOps Agent, transformando los resúmenes de las investigaciones en pasos de solución prácticos que se ejecutan con la aprobación de una persona. Este enfoque reduce el tiempo medio de resolución porque, cuando el ingeniero de guardia se pone en contacto con él, el sistema ya ha diagnosticado el problema, recopilado las configuraciones actuales y preparado una solución lista para su aprobación. La seguridad sigue siendo un aspecto fundamental del diseño: la lista de permisos restringe a Amazon Bedrock a invocar únicamente las herramientas previamente aprobadas, y el sistema de aprobación humana ayuda a evitar que los cambios no deseados lleguen a la producción sin autorización expresa. La arquitectura también es intrínsecamente ampliable. La adición de nuevas capacidades de corrección solo requiere actualizaciones de configuración en el registro de herramientas, no cambios de código en el orquestador. Además, dado que AWS Lambda Durable Functions se suspende sin consumir recursos informáticos durante la espera de aprobación, la solución sigue siendo rentable incluso cuando los ciclos de aprobación duran horas o días.

Para empezar a usar esta solución, descargue la plantilla completa del CDK de AWS del repositorio de GitHub y siga los pasos de esta publicación para implementar la solución en su entorno.

Nos encantaría escuchar su opinión. Comparta su experiencia en la implementación de esta solución, haga preguntas o sugiera mejoras en los comentarios. También puede unirse al programa AWS Community Builders para conectarse con otros desarrolladores y compartir sus patrones de arquitectura sin servidor

.

Acerca del autor

Michele Scarimbolo

Michele Scarimbolo

Michele es gerente de cuentas técnicas en AWS. Comenzó su carrera en el desarrollo web y móvil y ahora ayuda a los clientes a crear soluciones sin servidor. Fuera del trabajo, le gusta nadar con su equipo y viajar para probar nuevos alimentos

.

¿Tiene un proyecto de software o plataforma SaaS en mente?

Hable directamente con nuestros arquitectos de software en SoftAndino. Le brindamos asesoría técnica y cotización inmediata sin compromiso.