Ver los rastros de X-Ray en Step Functions

Para crear un rol (consola)

1. Inicie sesión en la consola de IAM AWS Management Console y ábrala en. https://console.aws.amazon.com/iam/

2. En el panel de navegación de la consola de IAM, elija Roles. A continuación, elija Crear rol.

3. Elija el tipo de rol Servicio de AWS y, a continuación, elija Lambda.

4. Elija el caso de uso Lambda. Los casos de uso son definidos por el servicio de modo tal que ya incluyen la política de confianza exigida por el servicio mismo. A continuación, elija Siguiente: permisos.

5. Elija una o varias políticas de permisos para asociarlas al rol (por ejemplo, AWSLambdaBasicExecutionRole). Consulte Modelo de permisos de AWS Lambda.

   Seleccione la casilla situada junto a la política que asigna los permisos que desea que tenga el rol y, a continuación, elija Next: Review.

6. Escriba un Role name.

7. (Opcional) En Descripción del rol, edite la descripción del nuevo rol vinculado al servicio.

8. Revise el rol y, a continuación, seleccione Crear rol.

1. Abra la consola de Lambda; y elija Crear función.

2. En la sección Crear función, elija Crear desde cero.

3. En la sección Información básica, configure la función de Lambda:

   1. En Nombre de la función, introduzca TestFunction1.

   2. En Tiempo de ejecución, elija Node.js 18.x.

   3. En Rol, seleccione Elegir un rol existente.

   4. En Rol existente, seleccione el rol de Lambda que creó anteriormente.

      nota

      Si el rol de IAM que creó no aparece en la lista, es posible que necesite unos minutos para que se propague a Lambda.

   5. Seleccione Crear función.

      Una vez creada la función de Lambda, anote su nombre de recurso de Amazon (ARN) en la esquina superior derecha de la página. Por ejemplo:

      arn:aws:lambda:us-east-1:123456789012:function:TestFunction1

4. Copie el siguiente código de la función Lambda en la sección Código de función de la TestFunction1página.

   function getRandomSeconds(max) {
       return Math.floor(Math.random() * Math.floor(max)) * 1000;
   }
   function sleep(ms) {
       return new Promise(resolve => setTimeout(resolve, ms));
   }
   export const handler = async (event) => {
       if(getRandomSeconds(4) === 0) {
           throw new Error("Something went wrong!");
       }   
       let wait_time = getRandomSeconds(5);
       await sleep(wait_time);
       return { 'response': true }
   };

   Este código crea errores cronometrados aleatoriamente, que se utilizarán para generar errores de ejemplo en su máquina de estados que se pueden ver y analizar mediante trazas de rayos X.

5. Seleccione Guardar.

1. Repita el Paso 2 para crear dos funciones de Lambda más. Para la siguiente función, en Nombre de función, introduzca TestFunction2. Para la última función, en Nombre de función, introduzca TestFunction3.

2. En la consola de Lambda, compruebe que ahora tiene tres funciones de Lambda, TestFunction1, TestFunction2 y TestFunction3.

1. Abra la consola de Step Functions y seleccione Crear máquina de estado.

   importante

   Asegúrese de que su máquina de estado esté en la misma AWS cuenta y región que las funciones Lambda que creó anteriormente en los pasos 2 y 3.

2. En el cuadro de diálogo Elegir una plantilla, seleccione En blanco.

3. Elija Seleccionar para abrir Workflow Studio en Modo Diseño.

4. Para este tutorial, escribirá la definición de Amazon States Language (ASL) de su máquina de estado en el Editor de código. Para ello, elija Código.

5. Elimine el código reutilizable existente y pegue el siguiente código. En la definición del estado de la tarea, recuerde reemplazar el ejemplo por ARNs ARNs las funciones Lambda que creó.

   {
     "StartAt": "CallTestFunction1",
     "States": {
       "CallTestFunction1": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function1",
         "Catch": [
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "CallTestFunction2"
       },
       "CallTestFunction2": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function2",
         "Catch": [
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "CallTestFunction3"
       },
       "CallTestFunction3": {
         "Type": "Task",
         "Resource": "arn:aws:lambda:us-east-1:123456789012:function:test-function3",
         "TimeoutSeconds": 5,
         "Catch": [
           {
             "ErrorEquals": [
               "States.Timeout"
             ],
             "Next": "AfterTimeout"
           },
           {
             "ErrorEquals": [
               "States.TaskFailed"
             ],
             "Next": "AfterTaskFailed"
           }
         ],
         "Next": "Succeed"
       },
       "Succeed": {
         "Type": "Succeed"
       },
       "AfterTimeout": {
         "Type": "Fail"
       },
       "AfterTaskFailed": {
         "Type": "Fail"
       }
     }
   }
   

   Esta es una descripción de la máquina de estado realizada que utiliza el Amazon States Language. Define tres estados Task denominados CallTestFunction1, CallTestFunction2 y CallTestFunction3. Cada una de ellas llama a una de las tres funciones de Lambda. Para obtener más información, consulte Estructura de las máquinas de estado.

6. Especifique un nombre para la máquina de estado. Para ello, seleccione el icono de edición situado junto al nombre predeterminado de la máquina de MyStateMachineestados. A continuación, en Configuración de máquina de estado, especifique un nombre en el cuadro Nombre de la máquina de estado.

   En este tutorial, ingrese el nombre TraceFunctions.

7. (Opcional) En Configuración de máquina de estado, especifique otros ajustes del flujo de trabajo, como el tipo de máquina de estado y su función de ejecución.

   Para este tutorial, en Configuración adicional, elija Activar el rastreo de X-Ray. Mantenga el resto de selecciones predeterminadas en la Configuración de máquina de estado.

   Si ya ha creado un rol de IAM con los permisos correctos para su máquina de estado y desea utilizarlo, en Permisos, seleccione Elegir un rol existente y, a continuación, seleccione un rol de la lista. O seleccione Escribir un ARN de rol y, a continuación, proporcione un ARN para ese rol de IAM.

8. En el cuadro de diálogo Confirmar creación de rol, elija Confirmar para continuar.

   También puede seleccionar Ver configuración de rol para volver a Configuración de máquina de estado.

   nota

   Si se elimina el rol de IAM que crea Step Functions, no se podrá volver a crear más adelante. Asimismo, si se modifica el rol (por ejemplo, eliminando Step Functions de las entidades principales de la política de IAM), Step Functions no podrá restablecer la configuración original más adelante.

1. En la TraceFunctionspágina, elija Iniciar ejecución.

   Aparece la página Nueva ejecución.

2. En el cuadro de diálogo Iniciar ejecución, haga lo siguiente:

   1. (Opcional) Introduzca un nombre de ejecución personalizado para anular el valor predeterminado generado.

      Nombres y registros con caracteres no ASCII

      Step Functions acepta nombres para máquinas de estado, ejecuciones, actividades y etiquetas que contengan caracteres no ASCII. Como estos caracteres no funcionan con Amazon CloudWatch, te recomendamos que utilices únicamente caracteres ASCII para poder realizar un seguimiento de las CloudWatch métricas.

   2. Seleccione Iniciar ejecución.

   3. La consola de Step Functions le dirige a una página cuyo título es su ID de ejecución. Esta página se conoce como Detalles de la ejecución. En esta página, puede revisar los resultados de la ejecución a medida que avanza la ejecución o una vez finalizada.

      Para revisar los resultados de la ejecución, elija los estados individuales en la Vista de gráfico y, a continuación, elija las pestañas individuales del panel Detalles del paso para ver los detalles de cada estado, incluidas la entrada, la salida y la definición, respectivamente. Para obtener más información sobre la ejecución que puede ver en la página Detalles de la ejecución, consulte Información general sobre los detalles de ejecución.

      Realice varias ejecuciones (al menos tres).

3. Una vez finalizadas las ejecuciones, siga el enlace del mapa de rastreo de X-Ray. Puede ver el rastreo mientras se está ejecutando una ejecución, pero es posible que desee ver los resultados de la ejecución antes de ver el mapa de rastreo de X-Ray.

4. Utilice el mapa de servicio para identificar los servicios donde ocurran errores, donde haya conexiones con alta latencia o rastros de solicitudes que dieron error. En este ejemplo, puede ver cuánto tráfico recibe cada función. Se llamó TestFunction2 con más frecuencia que TestFunction3 y se llamó TestFunction1 con más del doble de frecuencia que TestFunction2.

   El mapa de servicio indica el estado de cada nodo mediante el uso de colores en función de la proporción de llamadas correctas y errores o fallos:

   • El verde se utiliza para las llamadas realizadas con éxito

   • El rojo se usa para fallos de servidor (errores de la serie 500)

   • El amarillo se usa para los errores del cliente (errores de la serie 400)

   • El morado indica los errores de limitación de solicitudes (429: demasiadas solicitudes)

   

   También puede elegir un nodo de servicio para ver sus solicitudes o un límite entre dos nodos para ver las solicitudes que pasaron por esa conexión.

5. Vea el mapa de rastros de X-Ray para ver qué ha sucedido en cada ejecución. La vista Escala de tiempo muestra una jerarquía de segmentos y subsegmentos. La primera entrada de la lista es el segmento, que representa todos los datos registrados por el servicio para una misma solicitud. Debajo del segmento aparecen los subsegmentos. En este ejemplo, se muestran los subsegmentos registrados por las funciones de Lambda.

   

   Para obtener más información sobre cómo entender los rastros de X-Ray y cómo utilizar X-Ray con Step Functions, consulte la Trace Step Functions solicita datos en AWS X-Ray