教學課程：搭配 Incident Manager 使用 Systems Manager Automation Runbook

建立 Runbook

1. 在 https：//https://console.aws.amazon.com/systems-manager/ 開啟AWS Systems Manager主控台。

2. 在導覽窗格中，選擇 Documents (文件)。

3. 選擇自動化。

4. 針對名稱，輸入 Runbook 的描述性名稱，例如 IncidentResponseRunbook。

5. 選擇 Editor (編輯器) 標籤，然後選擇 Edit (編輯)。

6. 將下方內容貼入編輯工具中：

   description: This runbook attempts to restart an Amazon EC2 instance that caused an incident.
   schemaVersion: '0.3'
   parameters:
     IncidentRecordArn:
       type: String
       description: The incident
   mainSteps:
     - name: ListTimelineEvents
       action: 'aws:executeAwsApi'
       outputs:
         - Selector: '$.eventSummaries[0].eventId'
           Name: eventId
           Type: String
       inputs:
         Service: ssm-incidents
         Api: ListTimelineEvents
         incidentRecordArn: '{{IncidentRecordArn}}'
         filters:
           - key: eventType
             condition:
               equals:
                 stringValues:
                   - SSM Incident Trigger
       description: This step retrieves the ID of the first timeline event with the CloudWatch alarm details.
     - name: GetTimelineEvent
       action: 'aws:executeAwsApi'
       inputs:
         Service: ssm-incidents
         Api: GetTimelineEvent
         incidentRecordArn: '{{IncidentRecordArn}}'
         eventId: '{{ListTimelineEvents.eventId}}'
       outputs:
         - Name: eventData
           Selector: $.event.eventData
           Type: String
       description: This step retrieves the timeline event itself.
     - name: JsonDecode
       action: 'aws:executeScript'
       inputs:
         Runtime: python3.8
         Handler: script_handler
         Script: |-
           import json
   
           def script_handler(events, context):
             data = json.loads(events["eventData"])
             return data
         InputPayload:
           eventData: '{{GetTimelineEvent.eventData}}'
       outputs:
         - Name: rawData
           Selector: $.Payload.rawData
           Type: String
       description: This step parses the timeline event data.
     - name: JsonDecode2
       action: 'aws:executeScript'
       inputs:
         Runtime: python3.8
         Handler: script_handler
         Script: |-
           import json
   
           def script_handler(events, context):
             data = json.loads(events["rawData"])
             return data
         InputPayload:
           rawData: '{{JsonDecode.rawData}}'
       outputs:
         - Name: InstanceId
           Selector: '$.Payload.detail.configuration.metrics[0].metricStat.metric.dimensions.InstanceId'
           Type: String
       description: This step parses the CloudWatch event data.
     - name: RestartInstance
       action: 'aws:executeAutomation'
       inputs:
         DocumentName: AWS-RestartEC2Instance
         DocumentVersion: $DEFAULT
         RuntimeParameters:
           InstanceId: '{{JsonDecode2.InstanceId}}'
       description: This step restarts the Amazon EC2 instance

7. 選擇 Create automation (建立自動化)。

建立從回應計劃啟動 Runbook 的 IAM 角色

1. 在以下網址開啟 IAM 主控台：https://console.aws.amazon.com/iam/。

2. 在導覽窗格中，選擇角色，然後選擇建立角色。

3. 在信任的實體類型下，確認已選取AWS服務。

4. 在使用案例下，在其他AWS服務的使用案例中，輸入 Incident Manager。

5. 選擇 Incident Manager，然後選擇下一步。

6. 在新增許可頁面上，選擇建立政策。許可編輯器會在新的瀏覽器視窗或索引標籤中開啟。

7. 在編輯器中，選擇 JSON 標籤。

8. 將下列許可政策複製並貼到 JSON 編輯器中。以您的AWS 帳戶 ID 取代 account_ID。

   JSON

   {
       "Version":"2012-10-17",		 	 	 
       "Statement": [
           {
               "Effect": "Allow",
               "Resource": [
                   "arn:aws:ssm:*:111122223333:document/IncidentResponseRunbook",
                   "arn:aws:ssm:*::document/AWS-RestartEC2Instance",
                   "arn:aws:ssm:*:111122223333:automation-execution/*"
               ],
               "Action": "ssm:StartAutomationExecution"
           },
           {
               "Effect": "Allow",
               "Resource": "arn:aws:ssm:*:*:automation-execution/*",
               "Action": "ssm:GetAutomationExecution"
           },
           {
               "Effect": "Allow",
               "Resource": "arn:aws:ssm-incidents:*:*:*",
               "Action": "ssm-incidents:*"
           },
           {
               "Effect": "Allow",
               "Resource": "arn:aws:iam::*:role/AWS-SystemsManager-AutomationExecutionRole",
               "Action": "sts:AssumeRole"
           },
           {
               "Effect": "Allow",
               "Resource": "*",
               "Action": [
                   "ec2:StopInstances",
                   "ec2:DescribeInstanceStatus",
                   "ec2:StartInstances"
               ]
           }
       ]
   }
   

9. 選擇下一步：標籤。

10. （選用） 如有需要，請將標籤新增至您的政策。

11. 選擇下一步：檢閱。

12. 在名稱欄位中，輸入可協助您將此角色識別為用於本教學課程的名稱。

13. （選用） 在描述欄位中輸入描述。

14. 選擇建立政策。

15. 導覽回您要建立之角色的瀏覽器視窗或索引標籤。隨即顯示新增許可頁面。

16. 選擇重新整理按鈕 （位於建立政策按鈕旁），然後在篩選條件方塊中輸入您建立的許可政策名稱。

17. 選擇您建立的許可政策，然後選擇下一步。

18. 在名稱、檢閱和建立頁面上，針對角色名稱輸入名稱，協助您將此角色識別為用於本教學課程。

19. （選用） 在描述欄位中輸入描述。

20. 檢閱角色詳細資訊，視需要新增標籤，然後選擇建立角色。

將 Runbook 指派給您的回應計劃

1. 開啟 Incident Manager 主控台。

2. 選擇回應計劃。

3. 針對回應計劃，選擇現有的回應計劃，然後選擇編輯。如果您沒有現有的回應計劃，請選擇建立回應計劃來建立新的計劃。

   完成下列欄位：

   1. 在 Runbook 區段中，選擇選取現有的 Runbook。

   2. 對於擁有者，確認已選取我擁有的 。

   3. 針對 Runbook，選擇您在 中建立的 Runbook任務 1：建立 Runbook。

   4. 對於版本，請在執行時選擇預設。

   5. 在輸入區段中，針對 IncidentRecordArn 參數，選擇事件 ARN。

   6. 在執行許可區段中，選擇您在 中建立的 IAM 角色任務 2：建立 IAM 角色。

4. 儲存您的變更。

將 CloudWatch 警示指派給您的回應計劃

1. 透過 https://console.aws.amazon.com/cloudwatch/ 開啟 CloudWatch 主控台。

2. 在導覽窗格中的警示下，選擇所有警示。

3. 針對您要連線至回應計畫的 Amazon EC2 執行個體，選擇警示。

4. 選擇動作，然後選擇編輯。確認指標具有稱為 的維度InstanceId。

5. 選擇下一步。

6. 針對設定動作精靈，選擇新增 Systems Manager 動作。

7. 選擇建立事件。

8. 選擇您在 中建立的回應計畫任務 3：將 Runbook 連線至您的回應計劃。

9. 選擇 Update alarm (更新警示)。

1. 開啟 Incident Manager 主控台。

2. 選擇 CloudWatch 警示建立的事件。

3. 選擇 Runbooks 索引標籤。

4. 在 Runbook 步驟區段中檢視在 Amazon EC2 執行個體上執行的動作。

   下圖示範如何在 主控台中報告您在本教學課程中建立的 Runbook 所採取的步驟。每個步驟都會列出時間戳記和狀態訊息。

   

   若要檢視 CloudWatch 警示中的所有詳細資訊，請展開 JsonDecode2 步驟，然後展開輸出。