srest

イベントログの取得 ​

イベント取得の有効化 ​

イベントログを有効化することで、EventBridge 経由で収集したイベントログを srest 上で可視化できます。

  1. インテグレーションページから [Amazon Web Services (v2)] の [設定] を開きます。

  2. [イベントの取得] タブをクリックします。

    INFO

    イベントの取得を有効化するには、事前に AWS との連携 を完了させておく必要があります。

  3. EventBridge から収集するサービスを選択し、[CloudFormation StackSets テンプレートの取得] ボタンをクリックします。

  4. テンプレートの URL が表示されるのでコピーします。

  5. [CloudFormation StackSets ページに移動] ボタンをクリックします。

  6. CloudFormation のコンソールが開くので、[IAM role name] に [srest-integration-CloudFormationAdministration...] から始まる IAM ロールを指定します。

  7. [Amazon S3 URL] フィールドに、先ほどコピーした URL をペーストします。

  8. [IAM execution role name] に IAM 実行ロールを指定します。

    INFO

    IAM 実行ロールは、srest-integration スタックをデプロイした際に作成される IAM ロールを指定します。 IAM ロール名は次の手順で確認してください。

    1. AWS コンソールから IAM のページを開きます。
    2. サイドバーから [Roles] をクリックします。
    3. 検索フィールドに srest-integration と入力し、srest-integration-CloudFormationExecution から始まる IAM ロール名をコピーします。

  9. [Next] ボタンをクリックします。

  10. [Specify StackSet details] ページが開くので、[StackSet name] に srest-aws-event-forwarder と入力し、[Next] ボタンをクリックします。

  11. [Configure StackSet options] ページでは何も変更せずに [Next] ボタンをクリックします。

  12. [Set deployment options] ページでは、[Account numbers] に AWS アカウント ID (12 桁)、[Specify regions] でイベントログを収集するリージョンを指定。最後に [Next] ボタンをクリックします。

    INFO

    Health イベントはリージョン固有ではないグローバルイベントを発生することがあります。 グローバルイベントを srest で取得するには、サービスを提供するリージョンのほか、us-east-1 (バージニア北部) を選択する必要があります。

  13. [Review] ページでセットアップ内容を確認したうえで [Submit] ボタンをクリックします。

  14. StackSets のデプロイが始まるので、ステータスが [SUCCEEDED] になるまで数分待ちます。

TIP

EventBridge で指定可能なイベントパターンの詳細は、Amazon EventBridge event patterns を参照してください。

通知テスト ​

ダッシュボード上でイベントログを表示するには、実際に AWS の各種サービスからイベントを発生させる必要があります。 例えば、GuardDuty でテストアラートを発生させることで、srest にイベントログが表示されることを確認できます。

TIP

イベント通知テストは GuardDuty 以外でも確認できます。 例えば CloudWatch を利用している場合、アラームの状態を変更することでイベントログを確認できます。 同様に ECS を利用している場合、タスクステータスの変更をトリガーにイベントログを確認できます。

以下は GuardDuty でテストイベントを発生させる手順です。

DANGER

  • 対象アカウントで GuardDuty が有効化されている必要があります。
  • GuardDuty は従量課金サービスです。テストで利用する際は 料金 に注意してください。
  • GuardDuty が検知したイベントを Chatbot などに通知する設定がある場合、サンプルイベントが大量に配信される可能性があるので注意してください。
  1. GuardDuty のコンソールを開き、サイドバーから　[設定] をクリックします。
  2. [検出結果のサンプル] から [検索結果サンプルの作成] ボタンをクリックします。
  3. srest のダッシュボードを開き、[GuardDuty] を開きます。
  4. 数分後にページをリロードすると、[アラート一覧] に GuardDuty から送信したイベントログが表示されます。

ログの配送を一時的に停止する ​

イベントログの配送に使用する EventBridge ルールを無効化することで、一時的に srest へのログの配送を停止できます。

  1. AWS コンソールから EventBridge のページを開きます。
  2. サイドバーから [Rules] をクリックします。
  3. [Rules] の一覧から srest-integration にチェックを付け、[Disable] ボタンをクリックします。
  4. 確認モーダルが開いたら、srest-integration が無効化されることを確認したうえで [Disable] ボタンをクリックします。

取得イベントを変更する ​

取得するイベントを変更する場合は、インテグレーションの再実行が必要となります。

  1. インテグレーションページから [Amazon Web Services (v2)] の [設定] を開きます。

  2. [イベントの取得] タブをクリックします。

  3. 取得するサービスを選択し、[CloudFormation StackSets テンプレートの取得] ボタンをクリックします。

  4. 表示されている URL をコピーします。

  5. AWS コンソールから CloudFormation のページを開きます。

  6. リージョンを [us-east-1] に変更します。

  7. サイドバーから [StackSets] をクリックします。

  8. StackSets から [srest-aws-event-forwarder] を選択し、[Actions] から [Edit StackSets details] をクリックします。

  9. [Prerequisite] の項目で、[Replace current template] をクリックします。

  10. [Specify template] の項目で、[Amazon S3 URL] に先ほどコピーした URL をペーストします。

  11. [Next] ボタンをクリックして、レビューページまで進みます。

  12. レビューページで内容を確認したうえで、[Submit] ボタンをクリックします。

  13. しばらく待つとスタックの更新が完了します。

ログの配送を停止する ​

  1. AWS コンソールから CloudFormation のページを開きます。
  2. リージョンを [us-east-1] に変更します。
  3. サイドバーから [StackSets] をクリックします。
  4. StackSets の一覧から [srest-aws-event-forwarder] をクリックします。
  5. [Stack Instances] タブを開き、[Actions] メニューから [Delete stacks from StackSet] を選択します。
  6. [Set deployment options] ページが開くので、[Account numbers] に AWS アカウント ID、[Specify regions] で [Add all regions] ボタンをクリックし、[Next] ボタンをクリックします。
  7. [Review] ページが開くので、内容を確認したうえで [Submit] ボタンをクリックします。
  8. スタックの削除が始まるので、ステータスが [SUCCEEDED] になるまで数分待ちます。
  9. [Actions] メニューから [Delete StackSet] をクリックします。
  10. srest-aws-event-forwarder が削除されることを確認したうえで、[Delete] ボタンをクリックします。
  11. StackSets から srest-aws-event-forwarder が削除されたことを確認します。