La Datadog CLI modifica la configuración de las funciones de Lambda existentes para permitir la instrumentación sin tener que volver a desplegar. 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.
Instalar
Instala la Datadog CLI con NPM o Yarn:
# NPM
npm install -g @datadog/datadog-ci
# Yarn
yarn global add @datadog/datadog-ci
Instrumentar
Para instrumentar la función, ejecuta el siguiente comando con tus credenciales de AWS.
datadog-ci lambda instrument -f <functionname> -f <another_functionname> -r <aws_region> -v <layer_version> --forwarder <forwarder_arn>
Para rellenar los parámetros, haz lo siguiente:
- Reemplaza
<functionname> y <another_functionname> por los nombres de tu función de Lambda. - Reemplaza
<aws_region> por el nombre de la región de AWS. - Reemplaza
<layer_version> por la versión de la biblioteca Lambda de Datadog que quieres utilizar. La última versión es 23. - Reemplaza
<forwarder_arn> por el nombre de recurso de Amazon (ARN) del Forwarder (consulta la documentación del Forwarder).
Por ejemplo:
datadog-ci lambda instrument -f my-function -f another-function -r us-east-1 -v 23 --forwarder "arn:aws:lambda:us-east-1:000000000000:function:datadog-forwarder"
Si configuraste tu función de Lambda para utilizar la firma de código, debes añadir el ARN del perfil de firma de Datadog (arn:aws:signer:us-east-1:464622532012:/signing-profiles/DatadogLambdaSigningProfile/9vMI9ZAGLc) a la configuración de la firma de código de tu función antes de poder instrumentarla con la Datadog CLI.
Obtén más información y parámetros adicionales en la documentación de la CLI.
El complemento Datadog Serverless Plugin añade la biblioteca Lambda de Datadog automáticamente a tus funciones mediante capas y configura las funciones para enviar métricas, trazas y logs a Datadog a través del Datadog Forwarder.
Si configuraste tu función de Lambda para utilizar la firma de código, debes añadir el ARN del perfil de firma de Datadog (arn:aws:signer:us-east-1:464622532012:/signing-profiles/DatadogLambdaSigningProfile/9vMI9ZAGLc) a la [configuración de la firma de código][4] de tu función antes de poder instalar el Datadog Serverless Plugin.
Para instalar y configurar el Datadog Serverless Plugin, sigue estos pasos:
- Instala el Datadog Serverless Plugin:
yarn add --dev serverless-plugin-datadog
- Añade lo siguiente a tu archivo
serverless.yml:plugins:
- serverless-plugin-datadog
- Añade también la siguiente sección a tu archivo
serverless.yml:custom:
datadog:
forwarderArn: # The Datadog Forwarder ARN goes here.
Instalar
La biblioteca Lambda de Datadog puede instalarse como una capa o como un gem. Para la mayoría de las funciones, Datadog recomienda instalar la biblioteca como capa. Si despliegas tu función de Lambda como una imagen de contenedor, debes instalar la biblioteca como gem.
La versión secundaria del gem datadog-lambda siempre coincide con la versión de la capa. Por ejemplo, la versión 0.5.0 de datadog-lambda coincide con el contenido de la versión 5 de la capa.
Como una capa
Configura las capas de tu función de Lambda con el ARN en el siguiente formato.
# Para las regiones us, us3, us5 o eu
arn:aws:lambda:<AWS_REGION>:464622532012:layer:Datadog-<RUNTIME>:<VERSION>
# Para las regiones us-gov
arn:aws-us-gov:lambda:<AWS_REGION>:002406178527:layer:Datadog-<RUNTIME>:<VERSION>
Las opciones disponibles de RUNTIME son Ruby2-7 y Ruby3-2. La última VERSION es 23. Por ejemplo:
arn:aws:lambda:us-east-1:464622532012:layer:Datadog-Ruby3-2:23
Si configuraste tu función de Lambda para utilizar la firma de código, debes añadir el ARN del perfil de firma de Datadog (arn:aws:signer:us-east-1:464622532012:/signing-profiles/DatadogLambdaSigningProfile/9vMI9ZAGLc) a la configuración de la firma de código de tu función antes de poder añadir la biblioteca Lambda de Datadog como una capa.
Como un gem
Si no puedes utilizar la capa de Lambda de Datadog prediseñada, puedes añadir lo siguiente a tu Gemfile como alternativa:
gem 'datadog-lambda'
gem 'ddtrace'
ddtrace contiene extensiones nativas que deben compilarse para que Amazon Linux funcione con AWS Lambda. Por lo tanto, Datadog recomienda compilar y desplegar la función de Lambda como una imagen de contenedor. Si tu función no puede desplegarse como una imagen de contenedor y quieres utilizar Datadog APM, Datadog recomienda instalar la biblioteca Lambda como una capa en lugar de como un gem.
Instala gcc, gmp-devel y make antes de ejecutar bundle install en el Dockerfile de tu función para asegurarte de que las extensiones nativas se compilen correctamente.
FROM <base image>
# ensambla tu imagen de contenedor
RUN yum -y install gcc gmp-devel make
RUN bundle config set path 'vendor/bundle'
RUN bundle install
Configurar
Habilita Datadog APM y envuelve la función de controlador de Lambda con la envoltura que se encuentra disponible en la biblioteca Lambda de Datadog.
require 'datadog/lambda'
Datadog::Lambda.configure_apm do |c|
# Habilita la instrumentación
end
def handler(event:, context:)
Datadog::Lambda.wrap(event, context) do
return { statusCode: 200, body: 'Hello World' }
end
end
Subscribir
Suscribe la función de Lambda del Datadog Forwarder a cada uno de los grupos de logs de tu función. Esto habilita el envío de métricas, trazas y logs a Datadog.
- Instala el Datadog Forwarder si todavía no lo hiciste.
- Suscribe el Datadog Forwarder a los grupos de logs de tu función.
