1. Habilita todos los registros para tu Step Function. En tu consola de AWS, abre tu máquina de estados. Haz clic en Edit (Editar) y busca la sección Registro. Allí, configura Nivel de log en ALL y activa la casilla Incluir datos de ejecución.

2. Asegúrate de que has desplegado el Datadog Lambda Forwarder y que estás utilizando la v3.130.0 o una posterior. Es posible que necesites actualizar tu Forwarder. Como alternativa, también puedes utilizar Amazon Data Firehose, que puede suscribir a grupos de logs de Amazon CloudWatch en varias regiones AWS. Sin embargo, esto requiere que el nombre del grupo de logs de Step Functions comience por “/aws/vendedlogs/states/”.

3. Suscribe logs de CloudWatch al Datadog Lambda Forwarder. Si el nombre del grupo de logs de tu Step Functions empieza por “/aws/vendedlogs/states/”, también puedes utilizar el marco serverless o la CLI Datadog para configurar la suscripción.

   Instalación automática personalizada

   1. Asegúrate de que has configurado la integración Datadog-AWS.
   2. En Datadog, abre el cuadro de la integración AWS y observa la pestaña Configuración.
   3. A la izquierda, selecciona la cuenta de AWS en la que se ejecuta tu Step Function. Abre la pestaña Recopilación de logs.
   4. En la sección Autosuscripción de logs, en Autosuscribir Forwarder Lambda Functions, introduce el ARN de tu Datadog Lambda Forwarder, como se ha indicado anteriormente. Haz clic en Add (Añadir).
   5. Cambia a Logs de CloudWatch de Step Functions. Los cambios tardan 15 minutos en surtir efecto.

   Nota: Para la autosuscripción de logs, es necesario que tu Lambda Forwarder y Step Function estén en la misma región.

   Instalación manual personalizada

   1. Abre tu consola AWS y ve a tu Datadog Lambda Forwarder. En la sección Información general sobre funciones, haz clic en Añadir desencadenador.
   2. En Añadir desencadenador, en la sección Configuración de desencadenador, utiliza el desplegable Seleccionar una fuente para seleccionar CloudWatch Logs.
   3. En Grupo de logs, selecciona el grupo de logs para tu máquina de estados. Por ejemplo, /aws/vendedlogs/states/my-state-machine.
   4. Introduce un nombre para el filtro. Puedes elegir llamarlo “filtro vacío” y dejar en blanco la casilla Patrón de filtro.

4. Configura etiquetas (tags). Abre tu consola AWS y ve a tu máquina de estado de Step Functions. Abre la sección Etiquetas y añade las etiquetas env:<ENV_NAME>, service:<SERVICE_NAME> y version:<VERSION>. La etiqueta env es necesaria para ver trazas en Datadog y es dev por defecto. La etiqueta service es por defecto el nombre de la máquina de estado. La etiqueta version por defecto es 1.0.

5. Para habilitar el rastreo, tienes dos opciones:

   • Por cada Step Function: Añade la etiqueta DD_TRACE_ENABLED a cada Step Function y configura el valor como true.
   • A nivel del Forwarder: Para habilitar el rastreo para todas las Step Functions conectadas al Forwarder, tienes dos opciones:
     • Al crear el stack tecnológico de CloudFormation para el Forwarder, configura el parámetro DdStepFunctionsTraceEnabled como true.
     • Una vez creado el Forwarder, configura la variable de entorno DD_STEP_FUNCTIONS_TRACE_ENABLED como true.

1. Si aún no lo has hecho, instala la v2.18.0 o posterior de la CLI Datadog.

   npm install -g @datadog/datadog-ci
   

2. Asegúrate de que has desplegado el Datadog Lambda Forwarder y que estás utilizando la v3.130.0 o una posterior. Es posible que necesites actualizar tu Forwarder. Como alternativa, también puedes utilizar Amazon Data Firehose, que puede suscribir a grupos de logs de Amazon CloudWatch en varias regiones AWS. Tu grupo de logs de Step Functions debe utilizar el siguiente formato:

   /aws/vendedlogs/states/<STEP_FUNCTION_NAME>-Logs
   

   Opcionalmente, puedes añadir tu entorno a este nombre de grupo de logs: /aws/vendedlogs/states/<STEP_FUNCTION_NAME>-Logs-<ENV>

   Toma nota del ARN de tu Forwarder.

3. Ejecuta:

   datadog-ci stepfunctions instrument \
    --step-function <STEP_FUNCTION_ARN> \
    --forwarder <FORWARDER_ARN> \
    --env <ENVIRONMENT> \
    --propagate-upstream-trace \
    --merge-step-function-and-lambda-traces
   

   • Sustituye <STEP_FUNCTION_ARN> por el ARN de tu Step Function. Repite la marca --step-function para cada Step Function que desees instrumentar.
   • Sustituye <FORWARDER_ARN> por el ARN de tu Datadog Lambda Forwarder. Este paso configura la suscripción a flujos (streams) de logs del Forwarder.
   • Sustituye <ENVIRONMENT> por la etiqueta del entorno que desees aplicar a tu Step Functions.

   Para obtener más información sobre el comando datadog-ci stepfunctions, consulta la documentación de la CLI Datadog.

Nota: El comando datadog-ci stepfunctions instrument habilita automáticamente el rastreo.

1. Si aún no lo has hecho, instala la v5.40.0 o posterior del complemento del marco serverless de Datadog:

   serverless plugin install --name serverless-plugin-datadog
   

2. Asegúrate de que has desplegado el Datadog Lambda Forwarder y que estás utilizando la v3.130.0 o una posterior. Es posible que necesites actualizar tu Forwarder. Como alternativa, también puedes utilizar Amazon Data Firehose, que puede suscribir a grupos de logs de Amazon CloudWatch en varias regiones AWS. Tu grupo de logs de Step Functions debe utilizar el siguiente formato:

   /aws/vendedlogs/states/<STEP_FUNCTION_NAME>-Logs-<STAGE>
   

3. Añade lo siguiente a tu serverless.yml:

   custom:
     datadog:
       site: <DATADOG_SITE>
       apiKeySecretArn: <DATADOG_API_KEY_SECRET_ARN>
       forwarderArn: <FORWARDER_ARN>
       enableStepFunctionsTracing: true
       propagateUpstreamTrace: true
       mergeStepFunctionAndLambdaTraces: true
   

   • Sustituye <DATADOG_SITE> por (asegúrate de que has seleccionado el SITIO DATADOG correcto a la derecha de esta página).
   • Reemplaza <DATADOG_API_KEY_SECRET_ARN> por el ARN del secreto de AWS en el que almacenas la clave de la API de Datadog de forma segura. La clave debe estar almacenada en una cadena de texto sin formato (no en un blob JSON). Además, el permiso secretsmanager:GetSecretValue es obligatorio. Si quieres hacer un testeo rápido, puedes usar apiKey en lugar del ARN y configurar la clave de la API de Datadog en texto sin formato.
   • Sustituye <FORWARDER_ARN> por el ARN de tu Datadog Lambda Forwarder. Este paso configura la suscripción a flujos de logs del Forwarder.

   Para ver parámetros adicionales, consulta [Complemento del marco serverless de Datadog - Parámetros de configuración][7].

   Nota: La línea enableStepFunctionsTracing: true habilita automáticamente el rastreo.

1. Asegúrate de que has desplegado el Datadog Lambda Forwarder y de que estés utilizando la v3.130.0 o posterior. Es posible que necesites actualizar tu Forwarder.

2. Instala la biblioteca de constructos CDK de Datadog, que configura automáticamente la generación de logs y suscribe el Forwarder al grupo de logs.

Ejemplo

from aws_cdk import (
    aws_stepfunctions as sfn,
    aws_stepfunctions_tasks as tasks,
)
from datadog_cdk_constructs_v2 import DatadogStepFunctions, DatadogLambda

state_machine = sfn.StateMachine(...)
datadog_sfn = DatadogStepFunctions(
    self,
    "DatadogSfn",
    env="<ENV>", # e.g. "dev"
    service="<SERVICE>", # e.g. "my-cdk-service"
    version="<VERSION>", # e.g. "1.0.0"
    forwarderArn="<FORWARDER_ARN>", # e.g. "arn:test:forwarder:sa-east-1:12345678:1"
    tags=<TAGS>, # optional, e.g. "custom-tag-1:tag-value-1,custom-tag-2:tag-value-2"
)
datadog_sfn.add_state_machines([child_state_machine, parent_state_machine])

Para ver ejemplos de stack tecnológico y de código adicionales, consulta ejemplos de CDK para la instrumentación de AWS Step Functions.

Nota: El constructo CDK de Step Functions de Datadog habilita automáticamente el rastreo.