如何调试 aws lambda 函数？

Question

在这个周末，我在与 dynamodb 集成的 aws lambda 上运行了一些节点函数，我使用 x-ray 来调试它创建我自己的注释，我想知道是否有更好的方法来调试 lambda 函数，例如逐步-步骤？

Answer 1

Lambda local可用于在本地机器上测试 lambda 代码。

Answer 2

Both SAM Local and The Serverless framework provide tools to locally execute an AWS Lambda functions. In case you need to debug your function in the AWS environment, I suggest using Cloud9 Cloud9 IDE for AWS Lambda debugging .

However, to debug invocation failures occurred in production, you could use something like Dashbird to detect and debug failures using logs, X-ray traces and other metadata.

Answer 3

I think there is some misconception, pardon for switching from node.js context to python (the title is not specific to node so many folks will end up here anyway).

You CAN debug actual deployed AWS lambdas line-by-line. The approach involves running a debug server pydevd on the development machine and lambdas communicating with a debug-server over long-running TCP connection.

Is it supported by various IDEs, we use is with PyCharm Pro, so setup for it (hypothetically you should be able to setup VSCode similarly):

1. Debug configuration with Path mapping: right-top corner run/debug configuration dropdown -> Edit Configurations -> + (add new configuration) -> Python remote debug -> specify host name / port for your dev machine (which needs globally exposed: setup path forwarding on your router or use ngrok if previous option is not available). Make sure to setup path mappings, that is how your IDE can map the remote scripts to local sources.

2. pip install pydevd . (For pycharm, you will need to install IDE-version specific custom distribution like: pip install pydevd-pycharm~=193.5233.109 )

3. Add the RemoteDebugSession context manager abstraction(since debug session is over long-running tcp connection, its needs to be closed explicitly in your lambda otherwise lambda will timeout) like:

# from config import config
from logging import getLogger
logger = getLogger(__name__)


class RemoteDebugSession:
    def __init__(self):
        self.active = False
        if not self.is_available():
            logger.warning(f"Remote debugging is not available")
            return

        try:
            # pydevd_pycharm exposes only settrace() from pydevd, import pydevd directly instead
            # import pydevd_pycharm
            import pydevd
            self.pydevd = pydevd
        except Exception as e:
            logger.warning(f"Remote debugging is unavailable")
            logger.warning(e)
            self.pydevd = None

    def __enter__(self):
        if not self.is_available() or self.pydevd is None:
            return

        self.pydevd.settrace(config.REMOTE_DEBUG_HOST, port=config.REMOTE_DEBUG_PORT,
                             suspend=False,
                             stdoutToServer=True,
                             stderrToServer=True)

        logger.warning("Starting remote dubugging session")
        self.active = True

    def __exit__(self, exc_type, exc_val, exc_tb):
        if not self.active:
            return

        if exc_type or exc_val or exc_tb:
            logger.warning(
                f"Remote debugging on {config.REMOTE_DEBUG_HOST}:{config.REMOTE_DEBUG_HOST} failed")
            logger.warning(exc_type)
            logger.warning(exc_val)
            logger.warning(exc_tb)
        else:
            logger.warning(f"Remote debugging on {config.REMOTE_DEBUG_HOST}:{config.REMOTE_DEBUG_HOST} closed")

        self.pydevd.stoptrace()

    @staticmethod
    def is_available():
        return hasattr(config, 'REMOTE_DEBUG_ENABLED') \
            and hasattr(config, 'REMOTE_DEBUG_HOST') \
            and hasattr(config, 'REMOTE_DEBUG_PORT') \
            and config.REMOTE_DEBUG_ENABLED \
            and config.REMOTE_DEBUG_HOST \
            and config.REMOTE_DEBUG_PORT

You need to have config object with REMOTE_DEBUG_ENABLED, REMOTE_DEBUG_HOST, REMOTE_DEBUG_PORT set. (pydevd.settrace is used with suspend=False so the executing won't stop unless we set a breakpoint)

5. Wrap your feature of interest with it like:

 with RemoteDebugSession() as session:
    # your code to examine
    pass

In practice, when building web servers, this can be inside an individual API handler, which will allow you to debug multiple simultaneous incoming requests as other lambdas will block on connection.

Please REFRAIN from using this in production. Apart from security risk, remote evaluation can allow you to do all sort of nasty things.

Answer 4

You wont be able to do a step by step debug like you would on a regular program by attaching a debugger . As you mentioned you can use X-Ray and basically logging statements to figure out what went wrong.

As @ConfusedCoder pointed out there are ways in which you can run a lambda locally and debug it.

But also make sure you have enough logging in to ensure that you can try to figure out what went wrong, for future issues, using the logs as you would typically be looking at it after the actual execution happened.

Answer 5

Rookout offers live debugging of NodeJS on AWS Lambda. This gives you breakpoints on the production function to allow traditional step-debugging. There are also lots of hacky solutions that effectively run your Lambda locally (eg lambda.local, serverless framework) but if you want to debug with true inputs, then debugging it in its true environment using Rookout is a good option.

Answer 6

You can now create tests within Lambda itself:

Choose Test at the top right of your Lambda function to bring up a screen that allows you to configure a new test that can be run. There are lots of example templates to choose from, including one for DynamoDB like you suggested:

Now choose your new test and click the Test button again. It will run immediately and you'll see console results on your screen, including logs and error messages.

Answer 7

You can use the serverless framework to debug the function. In this approach, you don't have to install docker.

1. npm install -D serverless
2. serverless config credentials --provider aws --key 'your_key' --secret 'your_secret' --profile 'your aws profile'
3. npm install --save-dev serverless-offline
4. in package.json

"scripts": { "start": "serverless offline -s dev", "test": "mocha" }

5. use following code as launch.json if you use vscode (Fill you aws profile name in #PROFILENAME#)

   { // Use IntelliSense to learn about possible attributes. // Hover to view descriptions of existing attributes. // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387 "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "Launch Serverless Offline", "program": "${workspaceRoot}/node_modules/serverless/bin/serverless", "args": [ "offline", "--noTimeout", "--dontPrintOutput", "--stage=local", "-P", "4000", "--aws-profile=#PROFILENAME#" ], "sourceMaps": true, "runtimeArgs": ["--lazy"], "outFiles": ["${workspaceFolder}/.webpack/**/*.js"], "protocol": "inspector", "runtimeExecutable": "node", "env": { // Here we set some environment vars that should be set locally. // They can and will overwrite the ones coming from your serverless.yml }, "windows": { "program": "${workspaceRoot}\\\\node_modules\\\\serverless\\\\bin\\\\serverless" } } ] }

6. SET SLS_DEBUG=*

Then you can debug function as usual. If you don't have package.json you have to npm init and npm install as a 4th step.

You must install serverless in locally not globally to use the given launch.json