Puedes utilizar la interfaz de línea de comandos (CLI) para instrumentar tus funciones de AWS Lambda con Datadog. La CLI habilita la instrumentación mediante la modificación de la configuración de las funciones de Lambda existentes y, por lo tanto, no requiere redistribución. Es la forma más rápida de empezar a trabajar con la monitorización serverless de Datadog.

También puedes añadir el comando a tus pipelines de CI/CD y así activar la instrumentación para todas tus aplicaciones serverless. Ejecuta el comando después del despliegue normal de tu aplicación serverless para evitar que los cambios del comando de la Datadog CLI se sobrescriban.

Instalación

Para instrumentar tus funciones de Lambda con el comando datadog-ci lambda instrument, sigue las instrucciones de uno de los tiempos de ejecución específicos que se enumeran abajo:

• .NET
• Go
• Java
• Node.js
• Python
• Ruby

Comandos

instrument

Ejecuta datadog-ci lambda instrument para aplicar la instrumentación de Datadog a una función de Lambda. Este comando añade la biblioteca Lambda de Datadog o la Datadog Lambda Extension como capas de Lambda a las funciones de Lambda instrumentadas y modifica sus configuraciones.

datadog-ci lambda instrument -f <function-name> -f <another-function-name> -r us-east-1 -v 81 -e 49

# Instrumentar varias funciones especificadas mediante los ARN completos
datadog-ci lambda instrument -f <lambda-arn> -f <another-lambda-arn> -f <a-third-lambda-arn> -v 81 -e 49

# Instrumentar funciones en modo interactivo
datadog-ci lambda instrument -i

# Instrumentar varias funciones que coinciden con un patrón regex
datadog-ci lambda instrument --functions-regex <valid-regex-pattern> -r us-east-1 -v 81 -e 49

# Ejecutar tests de todas las actualizaciones
datadog-ci lambda instrument -f <function-name> -f <another-function-name> -r us-east-1 -v 81 -e 49 --dry-run

uninstrument

Ejecuta datadog-ci lambda uninstrument para revertir la instrumentación de Datadog en una función de Lambda. Este comando elimina automáticamente la configuración de Datadog, como las capas de la biblioteca Lambda de Datadog y la Datadog Lambda Extension, así como otras configuraciones aplicadas por la datadog-ci.

# Revertir la instrumentación de varias funciones especificadas mediante los nombres
datadog-ci lambda uninstrument -f <function-name> -f <another-function-name> -r us-east-1

# Revertir la instrumentación de las funciones en modo interactivo
datadog-ci lambda uninstrument -i

# Revertir la instrumentación de varias funciones que coinciden con un patrón regex
datadog-ci lambda uninstrument --functions-regex <valid-regex-pattern> -r us-east-1

# Ejecutar tests de todas las actualizaciones
datadog-ci lambda uninstrument -f <function-name> -f <another-function-name> -r us-east-1 --dry-run

Consulta la sección de configuración para ver parámetros adicionales.

Configuración

Credenciales de AWS

Debes tener credenciales de AWS válidas configuradas con acceso a los servicios Lambda y CloudWatch en los que ejecutas cualquier comando datadog-ci lambda.

Variables de entorno

Debes exponer estas variables de entorno en el entorno en el que ejecutas datadog-ci lambda instrument:

Argumentos

Puedes llevar a cabo la configuración con argumentos de la línea de comandos o un archivo de configuración JSON (consulta la siguiente sección).

instrument

Puedes pasar los siguientes argumentos a instrument para especificar su comportamiento. Estos argumentos anularán los valores definidos en el archivo de configuración, si los hay.

uninstrument

Los siguientes argumentos se pasan a uninstrument para especificar su comportamiento. Estos argumentos anularán los valores definidos en el archivo de configuración, si los hay.

Cualquier otro argumento indicado en la tabla instrument, pero no debajo, se ignorará para permitir una reversión más rápida de la instrumentación, en caso de que sea necesario.

Archivo de configuración

En lugar de suministrar argumentos, puedes crear un archivo de configuración en tu proyecto y simplemente ejecutar el comando datadog-ci lambda {instrument|uninstrument} --config datadog-ci.json en cada despliegue. Especifica el archivo datadog-ci.json mediante el argumento --config y utiliza esta estructura de archivo de configuración:

{
    "lambda": {
        "layerVersion": 10,
        "extensionVersion": 8,
        "functions": ["arn:aws:lambda:us-east-1:000000000000:function:autoinstrument"],
        "region": "us-east-1",
        "tracing": true,
        "mergeXrayTraces": true,
        "captureLambdaPayload": true,
        "forwarder": "arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder",
        "logLevel": "debug",
        "service": "some-service",
        "version": "b17s47h3w1n",
        "profile": "my-credentials",
        "environment": "staging",
        "extraTags": "layer:api,team:intake"
    }
}

Solucionar problemas de instrumentación de Lambda

Para solucionar los problemas relacionados con la monitorización de Datadog en tus funciones de Lambda, ejecuta el comando datadog-ci lambda flare en la raíz del directorio de tu proyecto. Este comando recopila datos importantes sobre una función de Lambda, como las variables de entorno y el archivo de configuración. Estos archivos luego se envían al equipo de asistencia de Datadog a través de un ticket que coincide con el ID del caso de Zendesk especificado.

Nota: Este comando funciona independientemente de si instrumentaste tus funciones de Lambda mediante datadog-ci lambda instrument.

Ejemplos

# Recopilar y enviar archivos al equipo de asistencia de Datadog para una sola función
datadog-ci lambda flare -f <function-arn> -c <case-id> -e <email-on-case-id>

# Incluir logs de CloudWatch recientes
datadog-ci lambda flare -f <function-name> -r <AWS region> -c <case-id> -e <email-on-case-id> --with-logs

# Ejecutar tests: recopilar datos, pero sin enviarlos al equipo de asistencia de Datadog
datadog-ci lambda flare -f <function-arn> -c <case-id> -e <email-on-case-id> --with-logs --dry-run

Argumentos

Comunidad

Si tienes preguntas o comentarios sobre el producto, únete al canal #serverless en la comunidad Datadog en Slack.