サーバーレス環境にデプロイされたウェブフレームワークの計測

を使用して AWS CLI、アプリケーションのディレクトリを作成します。その新しいディレクトリに変更します。

mkdir serverless_application
cd serverless_application

次に、新しいディレクトリ内に仮想環境を作成します。アクティベートするには以下のコマンドを使用します。

# Create our virtual environment
virtualenv serverless_env

# Activate it
source serverless_env/bin/activate

X-Ray、Flask、Zappa およびリクエストライブラリをその環境にインストールします。

# Install X-Ray, Flask, Zappa, and Requests into your environment
pip install aws-xray-sdk flask zappa requests

アプリケーションコードを serverless_application ディレクトリに追加します。この例では、Flasks の Hello World の例を基にします。

serverless_application ディレクトリに my_app.py という名前のファイルを作成します。テキストエディタで、次のコマンドを追加します。このアプリケーションでは、リクエストライブラリを計測し、Flask アプリケーションのミドルウェアにパッチを適用して、エンドポイント '/' を開きます。

# Import the X-Ray modules
from aws_xray_sdk.ext.flask.middleware import XRayMiddleware
from aws_xray_sdk.core import patcher, xray_recorder
from flask import Flask
import requests

# Patch the requests module to enable automatic instrumentation
patcher.patch(('requests',))

app = Flask(__name__)

# Configure the X-Ray recorder to generate segments with our service name
xray_recorder.configure(service='My First Serverless App')

# Instrument the Flask application
XRayMiddleware(app, xray_recorder)
 
@app.route('/')
def hello_world():
    resp = requests.get("https://aws.amazon.com")
    return 'Hello, World: %s' % resp.url

serverless_application ディレクトリ内から Zappa を初期化します。この例では、デフォルト設定を使用しましたが、カスタマイズ設定がある場合は Zappa に設定手順が表示されます。

zappa init

What do you want to call this environment (default 'dev'): dev
...
What do you want to call your bucket? (default 'zappa-*******'): zappa-*******
...
...
It looks like this is a Flask application.
What's the modular path to your app's function?
This will likely be something like 'your_module.app'.
We discovered: my_app.app
Where is your app's function? (default 'my_app.app'): my_app.app
...
Would you like to deploy this application globally? (default 'n') [y/n/(p)rimary]: n

X-Ray を有効にします。zappa_settings.json ファイルを開き、例のように表示されていることを確認します。

{
    "dev": {
        "app_function": "my_app.app",
        "aws_region": "us-west-2",
        "profile_name": "default",
        "project_name": "serverless-exam",
        "runtime": "python2.7",
        "s3_bucket": "zappa-*********"
    }
}

設定ファイルのエントリとして "xray_tracing": true を追加します。

{
    "dev": {
        "app_function": "my_app.app",
        "aws_region": "us-west-2",
        "profile_name": "default",
        "project_name": "serverless-exam",
        "runtime": "python2.7",
        "s3_bucket": "zappa-*********",
        "xray_tracing": true
    }
}

アプリケーションをデプロイします。これにより、API Gateway エンドポイントが設定され、コードは Lambda に更新されます。

zappa deploy

...
Deploying API Gateway..
Deployment complete!: https://**********.execute-api.us-west-2.amazonaws.com/dev

にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/apigateway/ で API Gateway コンソールを開きます。

新しく生成された API を探します。serverless-exam-dev のようになります。

[Stages] (ステージ) を選択します。

API のデプロイステージの名前を選択します。デフォルトは dev です。

[Logs/Tracing] タブで、[X-Ray トレースを有効にする] チェックボックスをオンにします。

[Save changes] (変更の保存) をクリックします。

ブラウザでエンドポイントにアクセスします。サンプルの Hello World アプリケーションを使用した場合は、次のように表示されます。

"Hello, World: https://aws.amazon.com/"

にサインイン AWS マネジメントコンソール し、https://console.aws.amazon.com/xray/home で X-Ray コンソールを開きます。

API Gateway、Lambda 関数、Lambda コンテナによって生成されたセグメントを表示します。

Lambda 関数のセグメントで、My First Serverless App という名前のサブセグメントを表示します。次に、https://aws.amazon.com という名前の 2 番目のサグメントが続きます。

Lambda では、初期化中に initialization という名前の 3 番目のサブセグメントが生成されることがあります。