概要
AWS Step Functions では、ビジュアルなワークフローを使用して、分散アプリケーションおよびマイクロサービスのコンポーネントを調整できます。
このインテグレーションにより、AWS Step Functions の基本的なメトリクスを Datadog で確認できるようになります。トレーシングと拡張メトリクスについては、Datadog Serverless Monitoring for AWS Step Functions を参照してください。
セットアップ
インストール
Amazon Web Services インテグレーションをまだセットアップしていない場合は、最初にセットアップします。次に、AWS/Datadog ロールのポリシードキュメントに以下のアクセス許可を追加します。
states:ListStateMachines,
states:DescribeStateMachine
メトリクスの収集
- AWS インテグレーションページの
Metric Collection タブで、States が有効になっていることを確認します。ステートマシンが AWS Lambda を使用している場合は、Lambda がチェックされていることも確認してください。 - Datadog - AWS Step Functions インテグレーションをインストールします。
AWS Lambda メトリクスの増強
Step Functions ステートが Lambda 関数である場合、このインテグレーションをインストールすると、Lambda メトリクスにタグ statemachinename、statemachinearn、stepname が追加されます。これにより、Lambda 関数がどのステートマシンに属しているかを確認でき、サーバーレスページでこれを視覚化できます。
メトリクス収集の強化
Datadog は、Step Functions の拡張メトリクスを生成して、個々のステップ時間の平均や p99 を追跡することもできます。これらの拡張メトリクスを利用するには、Datadog Serverless Monitoring for AWS Step Functions を参照してください。
ログ収集
- AWS Step Functions を CloudWatch にログを送信するように構成します。注: Datadog がログのソースを識別し、自動的にパースするために、CloudWatch のロググループのデフォルトのプレフィックス
/aws/vendedlogs/states を使用します。 - Datadog にログを送信します。
トレースの収集
トレース収集を有効にするには、Datadog APM for AWS Step Functions を利用する方法と、AWS X-Ray を利用する方法の二つがあります。
Datadog APM for AWS Step Functions を利用してトレースを有効にする
AWS Step Functions の分散型トレーシングを有効にするには、Datadog Serverless Monitoring for AWS Step Functions を参照してください。
AWS X-Ray によるトレースの有効化
AWS X-Ray を利用して AWS Step Functions のトレースを収集するには
- Datadog AWS X-Ray インテグレーションを有効にします。
- AWS コンソールにログインします。
- Step Functions にアクセスします。
- Step Functions の 1 つを選択して、Edit をクリックします。
- ページの下部にある Tracing セクションまでスクロールし、Enable X-Ray tracing チェックボックスをオンにします。
- 推奨: より詳細なトレースを行うには、関数に AWS X-Ray トレーシングライブラリをインストールしてください。
収集データ
メトリクス
イベント
AWS Step Functions インテグレーションには、イベントは含まれません。
サービスチェック
AWS Step Functions インテグレーションには、サービスのチェック機能は含まれません。
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問合せください。
