CloudWatch Synthetics 完全ガイド v2.0

初心者から実務者向けの包括的解説

ドキュメントの目的

本ガイドは以下を対象としています。

• 初心者向け： CloudWatch Synthetics とは何か、なぜ外形監視に使用するかを学びたい方
• SRE/DevOps 向け： API・GUI・ビジュアル監視を実装して可用性を定期検証したい方
• 運用者向け： Canary の設定・トラブルシューティング・本番運用を実施したい方
• 意思決定者向け： Datadog Synthetic・Pingdom・Checkly・New Relic Synthetic との比較・投資判断

2025-2026 年の CloudWatch Synthetics 最新動向

• マルチブラウザ対応（2025年9月）：Firefox + Chrome での同時検証。Playwright/Puppeteer ベースで複数ブラウザを並列実行
• マルチチェックキャンバーボンドル（2025年10月）：最大 10 個の異なるエンドポイント監視を 1 つの Canary で実行。JSON ベースの簡単設定で API 群の一括監視が可能
• Visual Monitoring 強化：スクリーンショット比較による UI 変化検知が標準化。ベースライン自動学習で誤検知削減
• Application Signals 統合：Synthetics Canary が Application Map に可視化され、サービス依存関係とトレースが統合表示
• VPC Endpoint Canary：プライベート環境での Canary 実行がより堅牢に

目次

1. 本質・定義
2. Synthetics が解決する課題
3. 主な特徴
4. アーキテクチャ
5. Canary の種類
6. コアコンポーネント
7. 主要ユースケース
8. Canary スクリプト（コード例）
9. 設定例（CLI / SDK / IaC）
10. Visual Monitoring（ビジュアル監視）
11. Groups（グループ管理）
12. 類似サービス比較表
13. セキュリティ・ベストプラクティス
14. トラブルシューティング
15. 2025-2026 最新動向
16. コスト最適化
17. 学習リソース・参考文献
18. 実装例・チェックリスト
19. まとめ

本質・定義

定義

Amazon CloudWatch Synthetics は、「定期実行で外形監視（Synthetic Monitoring）を行うマネージドサービス」。Node.js・Python・Java で記述した Canary スクリプトを定期実行（最小 1 分間隔）し、API・GUI ワークフロー・ウェブサイト可用性を事前検証する。実ユーザーのアクセスなしに 24/7 サービス健全性をモニタリングでき、問題を先手で検知できる。

初心者向けメモ： Synthetics は「CloudWatch が代わりにあなたのサービスを定期的に監視する」イメージ。実際のユーザーがアクセスする前に、自動化されたテストスクリプト（Canary）が「このサービス、ちゃんと動いているか？」を確認する。

このサービスを選ぶ理由

Synthetics が解決する課題

1. RUM との補完：RUM（Real User Monitoring）は実ユーザーのデータを事後収集。Synthetics は能動的に事前テスト。ユーザーが経験する前に問題を検出
2. アラーム遅延削減：CloudWatch アラームはリクエスト発生後に反応。Synthetics は定期的に事前チェック
3. グローバル可用性監視：複数リージョン・複数キャリアから Canary を実行してエッジローケーション単位の可用性を把握
4. CI/CD パイプラインの品質確認：デプロイ後に自動的に Canary を実行してレグレッション検出

主な特徴

graph TB
    subgraph CW["CloudWatch Synthetics"]
        Canary1["API Canary<br/>REST エンドポイント"]
        Canary2["GUI Canary<br/>Puppeteer E2E フロー"]
        Canary3["Visual Canary<br/>スクリーンショット比較"]
        Canary4["Multi-Check<br/>複数エンドポイント"]
    end
    
    subgraph Schedule["スケジュール実行"]
        Rate["rate(5 minutes)"]
        Cron["cron(0 * * * *)"]
    end
    
    subgraph Output["出力・通知"]
        CWMetrics["CloudWatch メトリクス"]
        CWLogs["CloudWatch Logs"]
        S3["S3 アーティファクト<br/>スクリーンショット"]
        SNS["SNS 通知"]
        EventBridge["EventBridge トリガー"]
    end
    
    Canary1 --> Rate
    Canary2 --> Rate
    Canary3 --> Cron
    Canary4 --> Cron
    Rate --> CWMetrics
    Cron --> CWMetrics
    CWMetrics --> S3
    CWMetrics --> SNS
    CWMetrics --> EventBridge
    
    style CW fill:#ccffcc
    style Output fill:#ffcccc

アーキテクチャ

graph TB
    subgraph CloudWatchAccount["AWS アカウント"]
        CanaryRepo["Canary Lambda 関数<br/>Node.js / Python / Java"]
        S3Artifact["S3 バケット<br/>スクリーンショット・ログ"]
        CWMetrics["CloudWatch メトリクス<br/>SuccessPercent, Duration, LatestRun"]
        CWLogs["CloudWatch Logs<br/>実行ログ"]
    end
    
    subgraph Endpoints["監視対象エンドポイント"]
        API["REST API<br/>api.example.com"]
        WebApp["Web アプリケーション<br/>app.example.com"]
        Internal["プライベートサービス<br/>VPC 内"]
    end
    
    subgraph Alerting["アラート・自動化"]
        CloudWatchAlarm["CloudWatch アラーム"]
        SNS["SNS 通知"]
        EventBridge["EventBridge ルール"]
        Lambda["Lambda 自動修復"]
    end
    
    CanaryRepo -->|定期実行| API
    CanaryRepo -->|Puppeteer で自動操作| WebApp
    CanaryRepo -->|VPC Endpoint で接続| Internal
    
    CanaryRepo --> S3Artifact
    CanaryRepo --> CWMetrics
    CanaryRepo --> CWLogs
    
    CWMetrics --> CloudWatchAlarm
    CloudWatchAlarm --> SNS
    CloudWatchAlarm --> EventBridge
    EventBridge --> Lambda
    
    style CloudWatchAccount fill:#e1f5ff
    style Endpoints fill:#f0f4c3
    style Alerting fill:#ffcccc

Canary の種類

1. API Canary（REST API 監視）

HTTP/HTTPS エンドポイントへの定期リクエスト。レスポンスコード・レスポンスタイム・ボディ内容を検証。

用途：

• マイクロサービスの API ヘルスチェック
• 外部 API 依存関係の可用性監視
• SLA 基準の自動評価

2. GUI Workflow Canary（ブラウザ自動化）

Puppeteer（Node.js）・Playwright・Selenium WebDriver でブラウザを操作。複雑なユーザーフロー（ログイン→フォーム入力→決済）を定期実行。

用途：

• EC サイトの決済フロー検証
• SPA（Single Page Application）の動作確認
• ログイン画面のセッション管理テスト

3. Visual Monitoring Canary（ビジュアル比較）

スクリーンショットをベースラインと自動比較。UI の意図しない変化を検知。

用途：

• デプロイ後のレグレッション検出
• UI/UX の視覚的変化監視
• ブランディング崩れの検知

4. Heartbeat Monitor（死活監視）

URL への最小限のリクエスト。到達可能か否かを単純チェック。

用途：

• ドメイン・CDN の可用性確認
• ステータスページの監視

5. Broken Link Checker（リンク切れ検出）

ウェブサイトのすべてのリンクをクロール。404 エラーを検出。

用途：

• ドキュメントサイトのリンク健全性確認

6. Multi-Check Canary（2025年新機能）

最大 10 個のエンドポイントを JSON ベースで 1 つの Canary に統約。複雑なスクリプトなし。

{
  "checks": [
    {
      "name": "Health API",
      "endpoint": "https://api.example.com/health",
      "method": "GET",
      "assertions": [
        { "statusCode": 200 }
      ]
    },
    {
      "name": "User API",
      "endpoint": "https://api.example.com/users",
      "method": "GET",
      "assertions": [
        { "statusCode": 200 },
        { "responseTime": { "lessThan": 1000 } }
      ]
    }
  ]
}

コアコンポーネント

Lambda 関数

Canary スクリプトを実行するマネージドリソース。Node.js・Python・Java で記述可能。

ランタイムバージョン

実行ロール

Canary が何を触れるか制御する IAM ロール。S3・CloudWatch Logs・Secrets Manager へのアクセスを許可。

実行場所

• デフォルト：AWS マネージド VPC（インターネットへのアクセス制限なし）
• VPC Endpoint Canary：ユーザー VPC 内で実行（プライベートサブネット対応）

主要ユースケース

Canary スクリプト（コード例）

例 1：API Canary（Node.js + Puppeteer）

const synthetics = require('Synthetics');

const apiCanary = async function () {
    const requestOptions = {
        hostname: 'api.example.com',
        method: 'GET',
        path: '/v1/health',
        port: 443,
        protocol: 'https:',
        headers: {
            'User-Agent': synthetics.getCanaryUserAgentString(),
            'Authorization': `Bearer ${process.env.API_KEY}`
        }
    };

    // リクエスト送信
    const verifyResponse = async function(response) {
        const statusCode = response.statusCode;
        
        if (statusCode !== 200) {
            throw new Error(`Expected 200, got ${statusCode}`);
        }

        const body = await synthetics.getResponseBody(response);
        const parsed = JSON.parse(body);

        if (parsed.status !== 'healthy') {
            throw new Error(`API status: ${parsed.status}`);
        }

        console.log('Health check passed');
    };

    await synthetics.executeHttpStep(
        'API Health Check',
        requestOptions,
        verifyResponse
    );
};

exports.handler = async () => {
    return await apiCanary();
};

例 2：GUI Workflow Canary（ログイン → ダッシュボード表示）

const synthetics = require('Synthetics');
const log = require('SyntheticsLogger');

const loadBlueprint = async function () {
    // ブラウザ・ページ設定
    const syntheticsConfiguration = synthetics.getConfiguration();
    syntheticsConfiguration.setConfig({
        screenshotOnStepStart: true,
        screenshotOnStepSuccess: true,
        screenshotOnStepFailure: true
    });

    const page = await synthetics.getPage();

    // ステップ 1: ログインページへ移動
    await synthetics.executeStep('Navigate to Login', async function() {
        await page.goto('https://app.example.com/login', {
            waitUntil: 'networkidle2',
            timeout: 30000
        });
    });

    // ステップ 2: ログイン情報入力
    await synthetics.executeStep('Enter Credentials', async function() {
        await page.type('#email', process.env.TEST_EMAIL);
        await page.type('#password', process.env.TEST_PASSWORD);
        await page.click('#login-button');
        await page.waitForNavigation({ waitUntil: 'networkidle2' });
    });

    // ステップ 3: ダッシュボード確認
    await synthetics.executeStep('Verify Dashboard', async function() {
        const title = await page.title();
        if (!title.includes('Dashboard')) {
            throw new Error(`Expected Dashboard, got: ${title}`);
        }

        // 特定要素の存在確認
        const userGreeting = await page.$('.user-greeting');
        if (!userGreeting) {
            throw new Error('User greeting element not found');
        }
    });

    // ステップ 4: 遅延測定
    await synthetics.executeStep('Measure Load Time', async function() {
        const navigationTiming = JSON.parse(
            await page.evaluate(() => JSON.stringify(window.performance.timing))
        );

        const loadTime = navigationTiming.loadEventEnd - navigationTiming.navigationStart;
        log.info(`Page load time: ${loadTime}ms`);

        if (loadTime > 5000) {
            log.warn(`Page load time exceeds 5 seconds: ${loadTime}ms`);
        }
    });
};

exports.handler = async () => {
    return await loadBlueprint();
};

例 3：Visual Monitoring Canary

const synthetics = require('Synthetics');

const visualCanary = async function () {
    const page = await synthetics.getPage();

    // ページへ移動
    await synthetics.executeStep('Navigate', async function() {
        await page.goto('https://app.example.com', {
            waitUntil: 'networkidle0'
        });
    });

    // スクリーンショット自動取得・ベースラインと比較
    await synthetics.takeScreenshot('full-page', 'result');
};

exports.handler = async () => {
    return await visualCanary();
};

設定例（CLI / SDK / IaC）

AWS CLI による Canary 作成

# API Canary の作成
aws synthetics create-canary \
  --name api-health-check \
  --code S3Bucket=my-canaries-bucket,S3Key=api-canary.zip \
  --artifact-s3-location s3://my-artifacts/api-health/ \
  --execution-role-arn arn:aws:iam::123456789012:role/SyntheticsRole \
  --schedule Expression="rate(5 minutes)" \
  --run-config TimeoutInSeconds=60 \
  --runtime-version syn-nodejs-puppeteer-7.0 \
  --start-canary-after-creation

# GUI Canary の作成
aws synthetics create-canary \
  --name e2e-checkout-flow \
  --code S3Bucket=my-canaries-bucket,S3Key=gui-canary.zip \
  --artifact-s3-location s3://my-artifacts/e2e/ \
  --execution-role-arn arn:aws:iam::123456789012:role/SyntheticsRole \
  --schedule Expression="rate(30 minutes)" \
  --runtime-version syn-nodejs-puppeteer-7.0

# Canary 実行トレース ON
aws synthetics tag-resource \
  --resource-arn arn:aws:synthetics:ap-northeast-1:123456789012:canary:api-health-check \
  --tags "EnableXray=true"

Terraform による Canary 定義

resource "aws_synthetics_canary" "api_canary" {
  name                 = "api-health-check"
  artifact_s3_location = "s3://my-artifacts/api/"
  
  handler      = "index.handler"
  zip_file     = "api-canary.zip"
  runtime_version = "syn-nodejs-puppeteer-7.0"

  schedule {
    expression = "rate(5 minutes)"
  }

  run_config {
    timeout_in_seconds = 60
    memory_in_mb      = 960
  }

  execution_role_arn = aws_iam_role.synthetics_role.arn

  # S3 出力の KMS 暗号化
  artifact_config {
    s3_encryption {
      encryption_mode = "SSE_KMS"
      kms_key_arn    = aws_kms_key.synthetics.arn
    }
  }

  tags = {
    Environment = "production"
    Team        = "platform"
  }
}

resource "aws_iam_role" "synthetics_role" {
  name = "synthetics-execution-role"

  assume_role_policy = jsonencode({
    Version = "2012-10-17"
    Statement = [
      {
        Effect = "Allow"
        Principal = {
          Service = "lambda.amazonaws.com"
        }
        Action = "sts:AssumeRole"
      }
    ]
  })
}

resource "aws_iam_role_policy" "synthetics_policy" {
  name   = "synthetics-policy"
  role   = aws_iam_role.synthetics_role.id
  policy = jsonencode({
    Version = "2012-10-17"
    Statement = [
      {
        Effect = "Allow"
        Action = [
          "logs:CreateLogGroup",
          "logs:CreateLogStream",
          "logs:PutLogEvents"
        ]
        Resource = "arn:aws:logs:*:*:*"
      },
      {
        Effect = "Allow"
        Action = [
          "s3:PutObject"
        ]
        Resource = "arn:aws:s3:::my-artifacts/*"
      },
      {
        Effect = "Allow"
        Action = [
          "secretsmanager:GetSecretValue"
        ]
        Resource = "arn:aws:secretsmanager:*:*:secret:synthetics/*"
      }
    ]
  })
}

# CloudWatch アラーム連携
resource "aws_cloudwatch_metric_alarm" "canary_failure" {
  alarm_name          = "canary-failure-alarm"
  comparison_operator = "LessThanThreshold"
  evaluation_periods  = 2
  metric_name         = "SuccessPercent"
  namespace           = "CloudWatchSynthetics"
  period              = 300
  statistic           = "Average"
  threshold           = 100
  alarm_actions       = [aws_sns_topic.alerts.arn]

  dimensions = {
    CanaryName = aws_synthetics_canary.api_canary.name
  }
}

Visual Monitoring（ビジュアル監視）

ベースライン設定

Visual Canary はスクリーンショットをキャプチャし、ベースラインと比較。視覚的な差分を検知。

// Visual Monitoring の有効化
const visualCanary = async function() {
    const page = await synthetics.getPage();

    await synthetics.executeStep('Navigate', async function() {
        await page.goto('https://app.example.com');
        // ページが完全に読み込まれるまで待機
        await page.waitForTimeout(2000);
    });

    // ベースラインとして最初のスクリーンショットを取得
    await synthetics.takeScreenshot('baseline', 'result');
};

ベースライン更新のベストプラクティス：

• 新しいデザイン・UIリリース時に明示的に更新
• 意図しない変化をベースラインに取り込まない仕組み（レビュープロセス）
• 日時・季節による変化（例：広告・キャンペーン）を考慮

差分検知の閾値設定

Visual Monitoring は ピクセルレベルの差分 を検出。その程度を閾値で制御。

{
  "visualConfig": {
    "threshold": 0.1,  // 10% の差分で失敗
    "compareMode": "colorSensitive"  // または "pixelSensitive"
  }
}

Groups（グループ管理）

複数の Canary をグループ化して一括管理・実行。

# グループ作成
aws synthetics create-canary-group \
  --name e-commerce-canaries \
  --tags "Environment=production"

# Canary をグループに追加
aws synthetics tag-resource \
  --resource-arn arn:aws:synthetics:ap-northeast-1:123456789012:canary:checkout-flow \
  --tags "CanaryGroup=e-commerce-canaries"

# グループ内の Canary を一括実行
aws synthetics start-canary-run \
  --name checkout-flow  # グループ内のいずれかの Canary を指定

類似サービス比較表

判断基準：

• AWS ネイティブ・コスト重視 → Synthetics
• Datadog ユーザー・統合モニタリング → Datadog Synthetic
• シンプル・UI 完結 → Pingdom
• CI/CD パイプライン統合・Git 管理 → Checkly

セキュリティ・ベストプラクティス

✅ 推奨される設定

❌ 避けるべきパターン

トラブルシューティング

2025-2026 最新動向

1. マルチブラウザ対応（2025年9月）

Chrome に加えて Firefox での並列テスト。ブラウザ互換性をプロアクティブに検証。

// Firefox での実行（Playwright ベース）
const syntheticsConfiguration = synthetics.getConfiguration();
syntheticsConfiguration.setBrowser('firefox');

2. マルチチェック Canary（2025年10月）

最大 10 エンドポイントを JSON ベースで 1 つの Canary に統約。スクリプト開発コスト削減。

3. Visual Monitoring 強化

自動ベースライン学習で誤検知削減。セマンティック差分検知（意図しない UI 変化のみ検出）。

4. Application Signals 統合拡張

CloudWatch Application Map に Synthetics Canary が表示。エラーパスをトレースで追跡可能。

5. VPC Endpoint Canary の堅牢性向上

PrivateLink 経由でプライベート環境内の Canary 実行をより高速・安定化。

コスト最適化

料金体系

コスト削減策

【変更前】
- API Canary 10 個 × 5 分ごと = 288 実行/日 = 2,880 実行/月
- コスト: 2,880 × $0.0035 = $10.08/月

【マルチチェック活用後】
- マルチチェック Canary 1 個 × 5 分ごと = 288 実行/日 = 2,880 実行/月
- 10 個の監視が 1 つの Canary に → 同じコスト
- ただしスクリーンショット数削減で S3 コスト削減

削減効果: S3 ストレージ 70% 削減

学習リソース・参考文献

AWS 公式

1. CloudWatch Synthetics User Guide
2. Puppeteer Documentation
3. CloudWatch Synthetics Pricing
4. Application Signals Integration

ブログ・ホワイトペーパー

5. AWS Blogs: Synthetic Monitoring Best Practices
6. Amazon CloudWatch Synthetics Multi-Browser Support（2025年9月）
7. Amazon CloudWatch Synthetics Multi-Check Canaries（2025年10月）

類似ツール・リソース

8. Checkly Documentation
9. Datadog Synthetic Monitoring
10. Pingdom Uptime Monitoring
11. New Relic Synthetic Monitoring

実装例・チェックリスト

フェーズ 1：基本設定（1-2 週間）

• [ ] IAM ロール・S3 バケット作成
• [ ] Node.js / Python 開発環境セットアップ
• [ ] API Canary スクリプト作成・テスト
• [ ] Terraform / CloudFormation で定義化

フェーズ 2：本番展開（2-3 週間）

• [ ] Canary 作成・スケジュール設定
• [ ] CloudWatch メトリクス確認
• [ ] アラーム設定（SuccessPercent < 100%）
• [ ] SNS・EventBridge 通知設定

フェーズ 3：GUI・Advanced（3-4 週間）

• [ ] GUI Workflow Canary 実装
• [ ] Visual Monitoring 構成
• [ ] マルチリージョン展開
• [ ] Application Signals 有効化（X-Ray トレース）

フェーズ 4：運用・最適化（継続）

• [ ] Canary 実行ログ定期確認
• [ ] ベースライン更新プロセス
• [ ] コスト監視・最適化
• [ ] 誤検知の削減・アラーム精度向上

まとめ

Amazon CloudWatch Synthetics は、定期的に自動化されたテストスクリプト（Canary）を実行して、API・GUI・ビジュアルな可用性を 24/7 監視するサービス。実ユーザーが経験する前に問題を検知でき、エンドツーエンドのワークフロー検証が可能。

主要なポイント：

1. 3 種類の監視方法：API（軽量）・GUI（E2E フロー）・Visual（UI 変化検知）
2. マルチロケーション対応：複数リージョンから並列実行で可用性マップを構築
3. 2025年新機能：マルチブラウザ・マルチチェック Canary でコスト最適化
4. AWS 統合：CloudWatch Logs・Alarms・EventBridge・Application Signals と深く統合
5. セキュリティ重視：Secrets Manager・VPC Endpoint・KMS 暗号化で堅牢性確保

新規導入なら API Canary からスタート。段階的に GUI・Visual・マルチリージョンへ展開。Checkly・Datadog との比較で AWS ネイティブ・コスト効率を重視する場合は Synthetics が最適。

最終更新：2026-04-26 バージョン：v2.0 著者：Claude (Anthropic) — i のメモ拡充プロジェクト