AWS アクションのアプリケーションオブザーバビリティ

IAM ID プロバイダーを作成する

まず、AWS マネジメントコンソールで GitHub の OIDC エンドポイントを信頼する IAM ID プロバイダーを作成します。

IAM ポリシーを作成する

このアクションに必要なアクセス許可を持つ IAM ポリシーを作成します。詳細については、以下の「必要な許可」セクションを参照してください。

IAM ロールを作成する

次の信頼ポリシーテンプレートを使用して、AWS マネジメントコンソールで IAM ロール (例: AWS_IAM_ROLE_ARN) を作成します。これにより、承認された GitHub リポジトリがロールを引き受けることができます。

{
  "Version": "2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Federated": "arn:aws:iam::<AWS_ACCOUNT_ID>:oidc-provider/token.actions.githubusercontent.com"
      },
      "Action": "sts:AssumeRoleWithWebIdentity",
      "Condition": {
        "StringEquals": {
          "token.actions.githubusercontent.com:aud": "sts.amazonaws.com"
        },
        "StringLike": {
          "token.actions.githubusercontent.com:sub": "repo:<GITHUB_ORG>/<GITHUB_REPOSITORY>:ref:refs/heads/<GITHUB_BRANCH>"
        }
      }
    }
  ]
}

テンプレート内の以下のプレースホルダーを置き換えてください。

IAM ポリシーをアタッチする

ロールの [アクセス許可] タブで、ステップ 2 で作成した IAM ポリシーをアタッチします。

リポジトリシークレットを設定する

リポジトリの設定画面に移動し、[設定]、[シークレットと変数]、[アクション] を順に選択します。

ワークフローファイルを追加する

Amazon Bedrock モデルでこのアクションを実際に使用するワークフローの例を以下に紹介します。このテンプレートから、GitHub リポジトリのディレクトリ .github/workflows にアプリケーションオブザーバビリティ調査ワークフローを作成してください。

name: Application observability for AWS

on:
  issue_comment:
    types: [created, edited]
  issues:
    types: [opened, assigned, edited]

jobs:
  awsapm-investigation:
    if: |
      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '@awsapm')) ||
      (github.event_name == 'issues' && (contains(github.event.issue.body, '@awsapm') || contains(github.event.issue.title, '@awsapm')))
    runs-on: ubuntu-latest

    permissions:
      contents: write        # To create branches for PRs
      pull-requests: write   # To post comments on PRs
      issues: write          # To post comments on issues
      id-token: write        # Required for AWS OIDC authentication

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Configure AWS credentials
        uses: aws-actions/configure-aws-credentials@v4
        with:
          role-to-assume: ${{ secrets.AWS_IAM_ROLE_ARN }}
          aws-region: ${{ vars.AWS_REGION || 'us-east-1' }}

      # Step 1: Prepare AWS MCP configuration and investigation prompt
      - name: Prepare Investigation Context
        id: prepare
        uses: aws-actions/application-observability-for-aws@v1
        with:
          bot_name: "@awsapm"
          cli_tool: "claude_code"

      # Step 2: Execute investigation with Claude Code
      - name: Run Claude Investigation
        id: claude
        uses: anthropics/claude-code-base-action@beta
        with:
          use_bedrock: "true"
          # Set to any Bedrock Model ID
          model: "us.anthropic.claude-sonnet-4-5-20250929-v1:0"
          prompt_file: ${{ steps.prepare.outputs.prompt_file }}
          mcp_config: ${{ steps.prepare.outputs.mcp_config_file }}
          allowed_tools: ${{ steps.prepare.outputs.allowed_tools }}

      # Step 3: Post results back to GitHub issue/PR (reuse the same action)
      - name: Post Investigation Results
        if: always()
        uses: aws-actions/application-observability-for-aws@v1
        with:
          cli_tool: "claude_code"
          comment_id: ${{ steps.prepare.outputs.awsapm_comment_id }}
          output_file: ${{ steps.claude.outputs.execution_file }}
          output_status: ${{ steps.claude.outputs.conclusion }}

設定に関する注意事項:

パフォーマンスの問題を調査し、その問題を投稿して修正します。

@awsapm, can you help me investigate availability issues in my appointment service?

@awsapm, can you post a fix?

計測の有効化:

@awsapm, please enable Application Signals for lambda-audit-service and create a PR with the required changes.

テレメトリデータのクエリ:

@awsapm, how many GenAI tokens have been consumed by my services in the past 24 hours?

ワークフローは @awsapm メンションを検出し、調査をトリガーします。

AI エージェントは、設定された MCP サーバーを介してライブ AWS テレメトリデータにアクセスします。

エージェントは問題を分析し、次のいずれかを実行します。

結果を確認し、フォローアップの質問で再度 @awsapm をメンションすることで、対話を継続できます。