Habilite Lambda Insights en una función de Lambda existente con la CLI de AWS SAM

Siga estos pasos para utilizar la AWS CLI de AWS SAM para habilitar Lambda Insights en una función de Lambda existente.

Si aún no instaló la última versión de la CLI de AWS SAM, primero debe instalarla o actualizarla. Para obtener más información, consulte Instalación de la CLI de AWS SAM.

Paso 1: instale la capa

Para que la extensión Lambda Insights esté disponible para todas las funciones de Lambda, agregue una propiedad Layers a la sección Globals de la plantilla SAM con el ARN de la capa de Lambda Insights. En el siguiente ejemplo se utiliza la capa para la versión inicial de Lambda Insights. Para obtener la versión más reciente de la capa de extensión de Lambda Insights, consulte Versiones disponibles de la extensión de Lambda Insights.

Globals:
  Function:
    Layers:
      - !Sub "arn:aws:lambda:${AWS::Region}:580247275435:layer:LambdaInsightsExtension:14"

Para habilitar esta capa para una sola función, agregue la propiedad Layers a la función como se muestra en este ejemplo.

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Layers:
        - !Sub "arn:aws:lambda:${AWS::Region}:580247275435:layer:LambdaInsightsExtension:14"

Paso 2: agregue la política administrada

Para cada función, agregue la política de IAM CloudWatchLambdaInsightsExecutionRolePolicy.

AWS SAM no es compatible con políticas globales, por lo que debe habilitar las de cada función de manera individual, como se muestra en este ejemplo. Para obtener más información acerca de las globales, consulte Globals Section (Sección de globales).

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Policies:
        - CloudWatchLambdaInsightsExecutionRolePolicy

Invocaciones locales

La CLI de AWS SAM admite extensiones Lambda. Sin embargo, cada invocación ejecutada localmente restablece el entorno en tiempo de ejecución. Los datos de Lambda Insights no estarán disponibles desde las invocaciones locales porque el tiempo de ejecución se reinicia sin un evento de cierre. Para obtener más información, consulte Versión 1.6.0: agregar compatibilidad con las pruebas locales de las extensiones de AWS Lambda.

Solución de problemas

Para solucionar problemas con la instalación de Lambda Insights, agregue la siguiente variable de entorno a la función de Lambda para habilitar el registro de depuración.

Resources:
  MyFunction:
    Type: AWS::Serverless::Function
    Properties:
      Environment:
        Variables:
          LAMBDA_INSIGHTS_LOG_LEVEL: info