ソリューションのモニタリング

ロギングと通知

Instance Scheduler は、CloudWatch Logs Insights クエリ用に最適化された構造化ログ記録を使用します。このソリューションは、タグ付けされた各インスタンスの処理情報、インスタンスの期間評価の結果、その期間中のインスタンスの望ましい状態、適用されたアクション、デバッグメッセージを記録します。

ログは 2 つのロググループで Amazon CloudWatch Logs に書き込まれます。

警告とエラーログは、ソリューションが作成した Amazon SNS トピックにも送信され、そこからサブスクライブされたメールアドレスにメッセージが送信されるよう設定することもできます。Amazon SNS のトピックの名前は、このソリューションスタックの [出力] タブで確認できます。

情報タグ

情報タグ付けが有効になっている場合 (デフォルト)、Instance Scheduler はマネージドリソースに直接タグを書き込み、ソリューションのスケジューリングアクティビティを一目で把握できるようにします。これらのタグは AWS Resource Groups タグ付け API を使用して適用され、スケジューラがリソースを処理するたびに更新されます。

この機能は、ハブスタックの情報タグ付けを有効にするパラメータを使用して有効または無効にできます。詳細については、「グローバル構成設定の更新」を参照してください。

情報タグキー

マネージドリソースには、次のタグが書き込まれます。

エラーコード

IS-Error タグには、次のエラーコードが表示される場合があります。

タグの動作

タグガバナンスに関する考慮事項

コントロールタグ

Instance Scheduler は、情報タグに加えて、特定の機能に次のコントロールタグを使用します。

タグ容量

CloudWatch Logs Insights クエリの例

Instance Scheduler の構造化ログ記録形式により、CloudWatch Logs Insights を使用した効率的なクエリが可能になります。Logs Insights を使用してログデータを検索、分析、視覚化し、運用上の問題のトラブルシューティングやスケジューリングアクティビティのモニタリングを行うことができます。

Instance Scheduler には、CloudWatch Logs コンソールの [保存されたクエリー] セクションからアクセスできる事前形式のログクエリが用意されています。

CloudWatch Logs Insights の詳細については、「Amazon CloudWatch Logs ユーザーガイド」の「CloudWatch Logs Insights でログデータを分析する」を参照してください。

Operational Insights ダッシュボード

Operational Insights ダッシュボードは、スケジュールされたインスタンス管理によるソリューションのパフォーマンスとコスト削減を可視化します。

このダッシュボードを使用するには、ハブスタックパラメータで、[Operational Monitoring] が [有効] に設定されていることを確認します。CloudWatch に移動し、ナビゲーションメニューから [ダッシュボード] を選択します。ダッシュボード名は *{stack-name}-Operational-Insights-Dashboard* になります。

ダッシュボードには、マネージドインスタンス数、保存された実行時間、Lambda 関数のパフォーマンスメトリクスが表示されます。

Operational Insights ダッシュボードの概要

Lambda の実行時間をモニタリングして、最適なパフォーマンスを提供します (「クォータ」を参照)。実行時間がタイムアウトしきい値に一貫して近づいている場合は、Lambda サイズプロパティを増やすか、Instance Scheduler をマネージドリージョンへのレイテンシーが低いリージョンにデプロイすることを検討してください。

期間とエラー数を示す Lambda メトリクス

この機能に関連する追加コスト

この運用ダッシュボードは、ソリューションで収集したカスタム CloudWatch メトリクスを利用するため、追加コストが発生します。この機能をオフにするには、ソリューションハブスタックで [Operational Monitoring] を無効にします。この機能には、デプロイのサイズに基づいて、1 か月あたり 3.00 USD と追加のスケーリングコストがかかります。コストは以下のとおりです。

*これらのコストはサービスカテゴリ (EC2/RDS) ごとに追跡され、スケジューリングに実際に使用されたインスタンスタイプに対してのみ追跡されます。

*

EventBridge イベントのモニタリング

Instance Scheduler は、スケジューリングイベントと登録イベントを EventBridge イベントバスに発行して、ソリューションオペレーションを可視化し、他の AWS サービスとの統合を可能にします。

イベントタイプ

このソリューションは、主に次の 2 つのカテゴリのイベントを発行します。

スケジュールイベント: Instance Scheduler がマネージドリソースを開始、停止、または設定するアクションを実行したときに発行されます。これらのイベントには、インスタンス、スケジュール、実行されたアクションに関する詳細が含まれます。これらのイベントには、インスタンス、スケジュール、実行されたアクションに関する詳細が含まれます。

登録イベント: リソースがタグ付けオペレーションに基づいてスケジューリングのために登録または登録解除されたときに発行されます。

イベントの送信先

IS-LocalEvents イベントバス: IS-LocalEvents イベントバスは、各メンバーアカウント (ハブアカウントを含む) の各マネージドリージョンにデプロイされます。各バスは、そのリージョン内のスケジュールアクションとリソース登録のイベントを受け取ります。

IS-GlobalEvents イベントバス: ハブアカウントの IS-GlobalEvents イベントバスは、すべての IS-LocalEvents イベントバスに送信された各イベントのコピーを受け取り、すべてのアカウントとリージョンを一元的にモニタリングできます。

EBS EventBridge イベント

以下の EventBridge ルールを作成できます。

イベントの構造

すべてのイベントは標準の EventBridge 形式を使用します。次の例は、各イベントタイプの構造を示しています。

スケジュールイベント:

{
  "Source": "instance-scheduler",
  "DetailType": "Scheduling Action",
  "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"],
  "Detail": {
    "account": "123456789012",
    "region": "us-east-1",
    "service": "ec2",
    "resource_id": "i-1234567890abcdef0",
    "requested_action": "Start",
    "action_taken": "Started",
    "schedule": "office-hours"
  }
}

登録イベント:

{
  "Source": "instance-scheduler",
  "DetailType": "Resource Registered",
  "Resources": ["arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0"],
  "Detail": {
    "account": "123456789012",
    "region": "us-east-1",
    "service": "ec2",
    "resource_id": "i-1234567890abcdef0",
    "schedule": "office-hours"
  }
}

各イベントには、次のキーフィールドが含まれます。

イベントをスケジュールするために指定できる requested_action 値:

イベントをスケジュールするために指定できる action_taken 値:

EventBridge ルールの作成

Instance Scheduler イベントをモニタリングするには:

Eventbridge の詳細については、「Amazon EventBridge ユーザーガイド」の「Amazon EventBridge とは」を参照してください。