}
}
}
```
これらのフィールドの詳細については、*Amazon EventBridge ユーザーガイド* の「[ターゲット入力を変換する](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html)」を参照してください。
1. **[確認]** を選択します。
1. [**次へ**] を選択します。
1. [**次へ**] を選択します。
1. [**ルールの更新**] を選択します。
イベントから OpsItem が作成されたら、OpsItem を開いて、[**Private operational data (プライベート運用データ)**] セクションまで下にスクロールして、イベントの詳細を表示することができます。OpsItem でオプションを設定する方法については、「[OpsItems を管理する](OpsCenter-working-with-OpsItems.md)」を参照してください。
# OpsItems を作成するように CloudWatch を設定する
AWS Systems Manager のツールである OpsCenter の統合セットアップ中に、Amazon CloudWatch を有効にして、一般的なアラームに基づいて OpsItems を自動的に作成します。アラームを作成するか、既存のアラームを編集して、OpsCenter に OpsItems を作成できます。
OpsItems を作成するアラームを設定すると、CloudWatch は AWS Identity and Access Management (IAM) でサービスにリンクされた新しいロールを自動的に作成します。新しいロールの名前は `AWSServiceRoleForCloudWatchAlarms_ActionSSM` です。CloudWatch サービスにリンクされたロールの詳細については、「Amazon CloudWatch ユーザーガイド」の「[CloudWatch のサービスにリンクされたロールの使用](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html)」を参照してください。
CloudWatch アラームが OpsItem を生成すると、OpsItem に **[CloudWatch アラーム - '*alarm\$1name*' はアラーム状態です]** が表示されます。
特定の OpsItem の詳細を表示するには、[OpsItem] を選択し、**[関連リソースの詳細]** タブを選択します。OpsItems を手動で編集して、重要度やカテゴリなどの詳細を変更できます。ただし、アラームの重要度やカテゴリを編集する場合、そのアラームから既に作成されている OpsItems の重要度やカテゴリは Systems Manager で更新することができません。アラームによって OpsItem が作成され、重複排除文字列を指定した場合、CloudWatch でアラームを編集しても、アラームは追加の OpsItems を作成しません。OpsItem が OpsCenter で解決された場合、CloudWatch は新しい OpsItem を作成します。
CloudWatch アラームの詳細については、次のトピックを参照してください。
**Topics**
+ [OpsItems (コンソール) を作成するように CloudWatch を設定する](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [OpsItems を (プログラムで) 作成するように既存の CloudWatch アラームを設定する](OpsCenter-configuring-an-existing-alarm-programmatically.md)
# OpsItems (コンソール) を作成するように CloudWatch を設定する
アラームを手動で作成するか、既存のアラームを更新して、OpsItems を Amazon CloudWatch から作成できます。
**CloudWatch アラームを作成して、アラームのターゲットとして Systems Manager を設定するには**
1. 「Amazon CloudWatch ユーザーガイド」の「[静的しきい値に基づいて CloudWatch アラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)」で指定されているように、ステップ 1～9 を完了します。
1. **[Systems Manager]** セクションで、**[Systems Manager OpsCenter アクションの追加]** をクリックします。
1. **[OpsItems]** をクリックします。
1. **[重要度]** は、1～4 の中から指定できます。
1. (オプション) **[カテゴリ]** に、OpsItem のカテゴリを選択します。
1. 「Amazon CloudWatch ユーザーガイド」「[静的しきい値に基づいて CloudWatch アラームを作成する](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html)」で指定されているように、ステップ 11～13 を完了します。
1. [**次**] を選択し、ウィザードを完了します。
**既存のアラームを編集し、アラームのターゲットとして Systems Manager を設定するには**
1. CloudWatch コンソールの [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) を開いてください。
1. ナビゲーションペインで、[Alarms] を選択します。****
1. アラームを選択してから、[**アクション**]、[**編集**] の順に選択します。
1. (オプション) [**メトリクス**] セクションと [**条件**] セクションの設定を変更し、[**次**] を選択します。
1. [**Systems Manager**] セクションで、[**Add Systems Manager OpsCenter action** (Systems Manager OpsCenter アクションの追加)]を選択します。
1. [**重大度**] で、数値を選択します。
**注記**
重大度は、ユーザー定義の値です。各重要度値の意味、各重要度に関連するサービスレベルアグリーメントは、お客様または組織が決定します。
1. (オプション) [**カテゴリ**] で、オプションを選択します。
1. [**次**] を選択し、ウィザードを完了します。
# OpsItems を (プログラムで) 作成するように既存の CloudWatch アラームを設定する
AWS Command Line Interface (AWS CLI)、AWS CloudFormation テンプレート、または Java コードスニペットを使用して、OpsItems をプログラムで作成するように Amazon CloudWatch アラームを設定できます。
**Topics**
+ [始める前に](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [OpsItems (AWS CLI) を作成するように CloudWatch アラームを設定する](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [OpsItems (CloudFormation) を作成または更新するように CloudWatch アラームを設定する](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [OpsItems (Java) を作成または更新するように CloudWatch アラームを設定する](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)
## 始める前に
既存のアラームをプログラムで編集するか、OpsItems を作成する新しいアラームを作成する場合は、Amazon リソースネーム (ARN) を指定する必要があります。この ARN により、Systems Manager OpsCenter はアラームから作成された OpsItems のターゲットとして識別されます。アラームから作成された OpsItems に重大度やカテゴリなどの特定の情報が含まれるように、ARN をカスタマイズできます。各 ARN には、次の表に示す情報が含まれています。
****
| Parameter | 詳細 |
| --- | --- |
| `Region` (必須) | アラームが存在する AWS リージョン。例: `us-west-2`。OpsCenter を使用できる AWS リージョン については、「[AWS Systems Manager エンドポイントとクォータ](https://docs.aws.amazon.com/general/latest/gr/ssm.html)」を参照照してください。 |
| `account_ID` (必須) | アラームの作成に使用したのと同じ AWS アカウント ID。例: `123456789012`。以下の例に示すように、アカウント ID の後にはコロン (`:`) とパラメータ `opsitem` を指定する必要があります。 |
| `severity` (必須) | アラームから作成された OpsItems のユーザー定義の重大度。有効な値: `1`、`2`、`3`、`4` |
| `Category` (オプション) | アラームから作成された OpsItems のカテゴリ。有効な値: `Availability`、`Cost`、`Performance`、`Recovery`、および `Security`。 |
次の構文を使用して ARN を作成します。この ARN には、オプションの `Category` パラメータは含まれません。
```
arn:aws:ssm:Region:account_ID:opsitem:severity
```
次に例を示します。
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```
オプションの `Category` パラメータを使用する ARN を作成するには、次の構文を使用します。
```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```
次に例を示します。
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```
## OpsItems (AWS CLI) を作成するように CloudWatch アラームを設定する
このコマンドでは、`alarm-actions` パラメータの ARN を指定する必要があります。ARN を作成する方法については、「[始める前に](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)」を参照してください。
**OpsItems (AWS CLI) を作成するように CloudWatch アラームを設定するには**
1. まだ AWS Command Line Interface (AWS CLI) をインストールして設定していない場合は、インストールして設定します。
詳細については、「[AWS CLI の最新バージョンをインストールまたは更新します。](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
1. 次のコマンドを実行して、設定するアラームに関する情報を収集します。
```
aws cloudwatch describe-alarms --alarm-names "alarm name"
```
1. 次のコマンドを実行してアラームを更新します。各*リソースプレースホルダーの例*をユーザー自身の情報に置き換えます。
```
aws cloudwatch put-metric-alarm --alarm-name name \
--alarm-description "description" \
--metric-name name --namespace namespace \
--statistic statistic --period value --threshold value \
--comparison-operator value \
--dimensions "dimensions" --evaluation-periods value \
--alarm-actions arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name \
--unit unit
```
以下に例を示します。
------
#### [ Linux & macOS ]
```
aws cloudwatch put-metric-alarm --alarm-name cpu-mon \
--alarm-description "Alarm when CPU exceeds 70 percent" \
--metric-name CPUUtilization --namespace AWS/EC2 \
--statistic Average --period 300 --threshold 70 \
--comparison-operator GreaterThanThreshold \
--dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 \
--alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security \
--unit Percent
```
------
#### [ Server ]
```
aws cloudwatch put-metric-alarm --alarm-name cpu-mon ^
--alarm-description "Alarm when CPU exceeds 70 percent" ^
--metric-name CPUUtilization --namespace AWS/EC2 ^
--statistic Average --period 300 --threshold 70 ^
--comparison-operator GreaterThanThreshold ^
--dimensions "Name=InstanceId,Value=i-12345678" --evaluation-periods 2 ^
--alarm-actions arn:aws:ssm:us-east-1:123456789012:opsitem:3#CATEGORY=Security ^
--unit Percent
```
------
## OpsItems (CloudFormation) を作成または更新するように CloudWatch アラームを設定する
このセクションでは、OpsItems を自動的に作成または更新するように CloudWatch アラームを設定する際に使用できる AWS CloudFormation テンプレートを紹介します。各テンプレートでは、`AlarmActions` パラメータの ARN を指定する必要があります。ARN を作成する方法については、「[始める前に](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)」を参照してください。
**メトリクスアラーム** – CloudWatch メトリクスアラームを作成または更新するには、以下の CloudFormation テンプレートを使用します。このテンプレートで指定されたアラームは、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスのステータスチェックをモニタリングします。アラームが `ALARM` ステートになると、OpsCenter で OpsItem が作成されます。
```
{
"AWSTemplateFormatVersion": "2010-09-09",
"Parameters" : {
"RecoveryInstance" : {
"Description" : "The EC2 instance ID to associate this alarm with.",
"Type" : "AWS::EC2::Instance::Id"
}
},
"Resources": {
"RecoveryTestAlarm": {
"Type": "AWS::CloudWatch::Alarm",
"Properties": {
"AlarmDescription": "Run a recovery action when instance status check fails for 15 consecutive minutes.",
"Namespace": "AWS/EC2" ,
"MetricName": "StatusCheckFailed_System",
"Statistic": "Minimum",
"Period": "60",
"EvaluationPeriods": "15",
"ComparisonOperator": "GreaterThanThreshold",
"Threshold": "0",
"AlarmActions": [ {"Fn::Join" : ["", ["arn:arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name", { "Ref" : "AWS::Partition" }, ":ssm:", { "Ref" : "AWS::Region" }, { "Ref" : "AWS:: AccountId" }, ":opsitem:3" ]]} ],
"Dimensions": [{"Name": "InstanceId","Value": {"Ref": "RecoveryInstance"}}]
}
}
}
}
```
**複合アラーム** – 複合アラームを作成または更新するには、以下の CloudFormation テンプレートを使用します。複合アラームは、複数のメトリクスアラームで構成されます。アラームが `ALARM` ステートになると、OpsCenter で OpsItem が作成されます。
```
"Resources":{
"HighResourceUsage":{
"Type":"AWS::CloudWatch::CompositeAlarm",
"Properties":{
"AlarmName":"HighResourceUsage",
"AlarmRule":"(ALARM(HighCPUUsage) OR ALARM(HighMemoryUsage)) AND NOT ALARM(DeploymentInProgress)",
"AlarmActions":"arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name",
"AlarmDescription":"Indicates that the system resource usage is high while no known deployment is in progress"
},
"DependsOn":[
"DeploymentInProgress",
"HighCPUUsage",
"HighMemoryUsage"
]
},
"DeploymentInProgress":{
"Type":"AWS::CloudWatch::CompositeAlarm",
"Properties":{
"AlarmName":"DeploymentInProgress",
"AlarmRule":"FALSE",
"AlarmDescription":"Manually updated to TRUE/FALSE to disable other alarms"
}
},
"HighCPUUsage":{
"Type":"AWS::CloudWatch::Alarm",
"Properties":{
"AlarmDescription":"CPUusageishigh",
"AlarmName":"HighCPUUsage",
"ComparisonOperator":"GreaterThanThreshold",
"EvaluationPeriods":1,
"MetricName":"CPUUsage",
"Namespace":"CustomNamespace",
"Period":60,
"Statistic":"Average",
"Threshold":70,
"TreatMissingData":"notBreaching"
}
},
"HighMemoryUsage":{
"Type":"AWS::CloudWatch::Alarm",
"Properties":{
"AlarmDescription":"Memoryusageishigh",
"AlarmName":"HighMemoryUsage",
"ComparisonOperator":"GreaterThanThreshold",
"EvaluationPeriods":1,
"MetricName":"MemoryUsage",
"Namespace":"CustomNamespace",
"Period":60,
"Statistic":"Average",
"Threshold":65,
"TreatMissingData":"breaching"
}
}
}
```
## OpsItems (Java) を作成または更新するように CloudWatch アラームを設定する
このセクションでは、OpsItems を自動的に作成または更新する CloudWatch アラームの設定に使用できる Java コードスニペットについて説明します。各スニペットでは、`validSsmActionStr` パラメータの ARN を指定する必要があります。ARN を作成する方法については、「[始める前に](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)」を参照してください。
**特定のアラーム** – 次の Java コードスニペットを使用して、CloudWatch アラームを作成または更新します。このテンプレートで指定されたアラームは、Amazon EC2 インスタンスのステータスチェックをモニタリングします。アラームが `ALARM` ステートになると、OpsCenter で OpsItem が作成されます。
```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
import com.amazonaws.services.cloudwatch.model.ComparisonOperator;
import com.amazonaws.services.cloudwatch.model.Dimension;
import com.amazonaws.services.cloudwatch.model.PutMetricAlarmRequest;
import com.amazonaws.services.cloudwatch.model.PutMetricAlarmResult;
import com.amazonaws.services.cloudwatch.model.StandardUnit;
import com.amazonaws.services.cloudwatch.model.Statistic;
private void putMetricAlarmWithSsmAction() {
final AmazonCloudWatch cw =
AmazonCloudWatchClientBuilder.defaultClient();
Dimension dimension = new Dimension()
.withName("InstanceId")
.withValue(instanceId);
String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
PutMetricAlarmRequest request = new PutMetricAlarmRequest()
.withAlarmName(alarmName)
.withComparisonOperator(
ComparisonOperator.GreaterThanThreshold)
.withEvaluationPeriods(1)
.withMetricName("CPUUtilization")
.withNamespace("AWS/EC2")
.withPeriod(60)
.withStatistic(Statistic.Average)
.withThreshold(70.0)
.withActionsEnabled(false)
.withAlarmDescription(
"Alarm when server CPU utilization exceeds 70%")
.withUnit(StandardUnit.Seconds)
.withDimensions(dimension)
.withAlarmActions(validSsmActionStr);
PutMetricAlarmResult response = cw.putMetricAlarm(request);
}
```
**すべてのアラームを更新する** – 次の Java コードスニペットを使用して、アラームが `ALARM` 状態になったときに OpsItems を作成するように、AWS アカウント 内のすべての CloudWatch アラームを更新します。
```
import com.amazonaws.services.cloudwatch.AmazonCloudWatch;
import com.amazonaws.services.cloudwatch.AmazonCloudWatchClientBuilder;
import com.amazonaws.services.cloudwatch.model.DescribeAlarmsRequest;
import com.amazonaws.services.cloudwatch.model.DescribeAlarmsResult;
import com.amazonaws.services.cloudwatch.model.MetricAlarm;
private void listMetricAlarmsAndAddSsmAction() {
final AmazonCloudWatch cw = AmazonCloudWatchClientBuilder.defaultClient();
boolean done = false;
DescribeAlarmsRequest request = new DescribeAlarmsRequest();
String validSsmActionStr = "arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name";
while(!done) {
DescribeAlarmsResult response = cw.describeAlarms(request);
for(MetricAlarm alarm : response.getMetricAlarms()) {
// assuming there are no alarm actions added for the metric alarm
alarm.setAlarmActions(ImmutableList.of(validSsmActionStr));
}
request.setNextToken(response.getNextToken());
if(response.getNextToken() == null) {
done = true;
}
}
}
```
# OpsItems を手動で作成する
オペレーション時の問題が見つかった場合は、AWS Systems Manager のツールである OpsCenter から OpsItem を手動で作成して、その問題を管理および解決することができます。
アカウント間管理のために OpsCenter を設定すると、Systems Manager の委任管理者または AWS Organizations の管理アカウントが、メンバーアカウントの OpsItems を作成することができます。詳細については、「[(オプション) OpsCenter の手動設定により、複数のアカウント間で OpsItems を一元管理する](OpsCenter-getting-started-multiple-accounts.md)」を参照してください。
OpsItems は、AWS Systems Manager コンソール、AWS Command Line Interface (AWS CLI)、または AWS Tools for Windows PowerShell を使用して作成できます。
**Topics**
+ [OpsItems の手動作成 (コンソール)](OpsCenter-creating-OpsItems-console.md)
+ [OpsItems の手動作成 (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md)
+ [OpsItems を手動で作成する (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md)
# OpsItems の手動作成 (コンソール)
AWS Systems Manager コンソールを使用して OpsItems を手動で作成できます。OpsItem を作成すると、OpsCenter アカウントに表示されます。クロスアカウント管理のために OpsCenter を設定した場合、OpsCenter では委任管理者または管理アカウントに、選択したメンバーアカウントの OpsItems を作成するオプションが提供されます。詳細については、「[(オプション) OpsCenter の手動設定により、複数のアカウント間で OpsItems を一元管理する](OpsCenter-getting-started-multiple-accounts.md)」を参照してください。
**AWS Systems Manager コンソールを使用して OpsItem を作成するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[作成]OpsItem** を選択します。このボタンが表示されない場合は、[**OpsItems**] タブを選択してから [**OpsItem の作成**] を選択します。
1. (オプション) **[その他のアカウント]** を選択し、OpsItem を作成するアカウントを選択します。
**注記**
このステップは、メンバーアカウントの OpsItems を作成する場合に必要です。
1. [**タイトル**] に、OpsItem の目的を示すわかりやすい名前を入力します。
1. [**Source**] (ソース) に、影響を受ける AWS リソースのタイプなど、ソースの情報を指定して、ユーザーが OpsItem のオリジンをわかるようにします。
**注記**
OpsItem の作成後に [**ソース**] フィールドを編集することはできません。
1. (オプション) [**優先度**] で、優先度レベルを選択します。
1. (オプション) [**重大度**] で、重大度レベルを選択します。
1. (オプション) [**カテゴリ**] で、カテゴリを選択します。
1. [**説明**] に、問題を再現するための手順など、この OpsItem に関する情報 (該当する場合) を入力します。
**注記**
コンソールは OpsItem 説明フィールドのほとんどの Markdown フォーマットをサポートしています。詳細については、「AWS マネジメントコンソール 入門ガイド」の「[コンソールでの Markdown の使用](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)」を参照してください。**
1. **[重複排除文字列]** に、システムが重複する OpsItems をチェックするために使用できる単語を入力します。重複排除文字列の詳細については、「[OpsItems の重複を管理する](OpsCenter-working-deduplication.md)」を参照してください。
1. (オプション) **[通知]** で、OpsItem の更新時に通知を送信する Amazon SNS トピックの Amazon リソースネーム (ARN) を指定します。OpsItem と同じ AWS リージョン にある Amazon SNS ARN を指定する必要があります。
1. (オプション) **[関連リソース]** で、**[追加]** を選択して、影響を受けるリソースおよび関連リソースの ID または ARN を指定します。
1. **[作成]OpsItem** を選択します。
成功すると、ページに OpsItem が表示されます。委任された管理者または管理アカウントが、選択したメンバーアカウントの OpsItem を作成すると、新しい OpsItems が管理者アカウントとメンバーアカウントの OpsCenter に表示されます。OpsItem でオプションを設定する方法については、「[OpsItems を管理する](OpsCenter-working-with-OpsItems.md)」を参照してください。
# OpsItems の手動作成 (AWS CLI)
次の手順では、AWS Command Line Interface (AWS CLI) を使用して OpsItem を作成する方法について説明します。
**AWS CLI を使用して OpsItem を作成するには**
1. まだ AWS Command Line Interface (AWS CLI) をインストールして設定していない場合は、インストールして設定します。
詳細については、「[AWS CLI の最新バージョンをインストールまたは更新します。](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
1. AWS CLI を開き、以下のコマンドを実行して OpsItem を作成します。各*リソースプレースホルダーの例*をユーザー自身の情報に置き換えます。
```
aws ssm create-ops-item \
--title "Descriptive_title" \
--description "Information_about_the_issue" \
--priority Number_between_1_and_5 \
--source Source_of_the_issue \
--operational-data Up_to_20_KB_of_data_or_path_to_JSON_file \
--notifications Arn="SNS_ARN_in_same_Region" \
--tags "Key=key_name,Value=a_value"
```
**ファイルから運用データを指定する**
OpsItem を作成する場合、ファイルから運用データを指定することができます。ファイルは JSON ファイルで、ファイルの内容には、次の形式を使用する必要があります。
```
{
"key_name": {
"Type": "SearchableString",
"Value": "Up to 20 KB of data"
}
}
```
以下はその例です。
```
aws ssm create-ops-item ^
--title "EC2 instance disk full" ^
--description "Log clean up may have failed which caused the disk to be full" ^
--priority 2 ^
--source ec2 ^
--operational-data file:///Users/TestUser1/Desktop/OpsItems/opsData.json ^
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
--tags "Key=EC2,Value=Production"
```
**注記**
さまざまなローカルオペレーティングシステムでコマンドラインに JSON 形式のパラメータを入力する方法については、*AWS Command Line Interface ユーザーガイド*の「[AWS CLI で文字列に引用符を使用する](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html)」を参照してください。
システムが以下のような情報をレスポンスします。
```
{
"OpsItemId": "oi-1a2b3c4d5e6f"
}
```
1. 以下のコマンドを実行して、作成した OpsItem の詳細を表示します。
```
aws ssm get-ops-item --ops-item-id ID
```
システムが以下のような情報をレスポンスします。
```
{
"OpsItem": {
"CreatedBy": "arn:aws:iam::12345678:user/TestUser",
"CreatedTime": 1558386334.995,
"Description": "Log clean up may have failed which caused the disk to be full",
"LastModifiedBy": "arn:aws:iam::12345678:user/TestUser",
"LastModifiedTime": 1558386334.995,
"Notifications": [
{
"Arn": "arn:aws:sns:us-west-1:12345678:TestUser"
}
],
"Priority": 2,
"RelatedOpsItems": [],
"Status": "Open",
"OpsItemId": "oi-1a2b3c4d5e6f",
"Title": "EC2 instance disk full",
"Source": "ec2",
"OperationalData": {
"EC2": {
"Value": "12345",
"Type": "SearchableString"
}
}
}
}
```
1. 次のコマンドを実行して OpsItem を更新します。このコマンドでは、ステータスを `Open` (デフォルト) から `InProgress` に変更します。
```
aws ssm update-ops-item --ops-item-id ID --status InProgress
```
コマンドには出力がありません。
1. 次のコマンドを再度実行し、ステータスが `InProgress` に変更されていることを確認します。
```
aws ssm get-ops-item --ops-item-id ID
```
## OpsItem の作成例
次のコード例は、Linux 管理ポータルmacOS、または Windows Server を使用して OpsItem を作成する方法を示します。
**Linux 管理ポータル、または macOS**
次のコマンドは、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスディスクがいっぱいになったときに OpsItem を作成します。
```
aws ssm create-ops-item \
--title "EC2 instance disk full" \
--description "Log clean up may have failed which caused the disk to be full" \
--priority 2 \
--source ec2 \
--operational-data '{"EC2":{"Value":"12345","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" \
--tags "Key=EC2,Value=ProductionServers"
```
次のコマンドは、`OperationalData` の `/aws/resources` キーを使用して、Amazon DynamoDB 関連リソースを持つ OpsItem を作成します。
```
aws ssm create-ops-item \
--title "EC2 instance disk full" \
--description "Log clean up may have failed which caused the disk to be full" \
--priority 2 \
--source ec2 \
--operational-data '{"/aws/resources":{"Value":"[{\"arn\": \"arn:aws:dynamodb:us-west-2:12345678:table/OpsItems\"}]","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```
以下のコマンドは、`OperationalData` の `/aws/automations` キーを使用して、関連付けられた Automation ランブックとして `AWS-ASGEnterStandby` ドキュメントを指定する OpsItem を作成します。
```
aws ssm create-ops-item \
--title "EC2 instance disk full" \
--description "Log clean up may have failed which caused the disk to be full" \
--priority 2 \
--source ec2 \
--operational-data '{"/aws/automations":{"Value":"[{\"automationId\": \"AWS-ASGEnterStandby\", \"automationType\": \"AWS::SSM::Automation\"}]","Type":"SearchableString"}}' \
--notifications Arn="arn:aws:sns:us-west-2:12345678:TestUser"
```
**Windows**
次のコマンドは、Amazon Relational Database Service (Amazon RDS) インスタンスが応答しない場合に OpsItem を作成します。
```
aws ssm create-ops-item ^
--title "RDS instance not responding" ^
--description "RDS instance not responding to ping" ^
--priority 1 ^
--source RDS ^
--operational-data={\"RDS\":{\"Value\":\"abcd\",\"Type\":\"SearchableString\"}} ^
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser1" ^
--tags "Key=RDS,Value=ProductionServers"
```
以下のコマンドは、`OperationalData` の `/aws/resources` キーを使用して、Amazon EC2 インスタンスの関連リソースを持つ OpsItem を作成します。
```
aws ssm create-ops-item ^
--title "EC2 instance disk full" ^
--description "Log clean up may have failed which caused the disk to be full" ^
--priority 2 ^
--source ec2 ^
--operational-data={\"/aws/resources\":{\"Value\":\"[{\\"""arn\\""":\\"""arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\\"""}]\",\"Type\":\"SearchableString\"}}
```
次のコマンドは、`OperationalData` の `/aws/automations` キーを使用して、関連付けられた Automation ランブックとして `AWS-RestartEC2Instance` ランブックを指定する OpsItem を作成します。
```
aws ssm create-ops-item ^
--title "EC2 instance disk full" ^
--description "Log clean up may have failed which caused the disk to be full" ^
--priority 2 ^
--source ec2 ^
--operational-data={\"/aws/automations\":{\"Value\":\"[{\\"""automationId\\""":\\"""AWS-RestartEC2Instance\\”"",\\"""automationType\\""":\\"""AWS::SSM::Automation\\"""}]\",\"Type\":\"SearchableString\"}}
```
# OpsItems を手動で作成する (PowerShell)
次の手順では、(AWS Tools for Windows PowerShell) を使用して OpsItem を作成する方法について説明します。
**AWS Tools for Windows PowerShell を使用して OpsItem を作成するには**
1. AWS Tools for Windows PowerShell を開き、次のコマンドを実行して認証情報を指定します。
```
Set-AWSCredentials –AccessKey key-name –SecretKey key-name
```
1. 次のコマンドを実行して、PowerShell セッションの AWS リージョン を設定します。
```
Set-DefaultAWSRegion -Region Region
```
1. 次のコマンドを実行して、新しい OpsItem を作成します。各*リソースプレースホルダーの例*をユーザー自身の情報に置き換えます。このコマンドは、OpsItem を修復するために Systems Manager Automation ランブックを指定します。
```
$opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
$opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString
$opsItem.Value = '[{\"automationId\":\"runbook_name\",\"automationType\":\"AWS::SSM::Automation\"}]'
$newHash = @{" /aws/automations"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
New-SSMOpsItem `
-Title "title" `
-Description "description" `
-Priority priority_number `
-Source AWS_service `
-OperationalData $newHash
```
成功すると、コマンドは、新しい OpsItem の ID を出力します。
次の例では、障害が発生した Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの Amazon リソースネーム (ARN) を指定しています。
```
$opsItem = New-Object Amazon.SimpleSystemsManagement.Model.OpsItemDataValue
$opsItem.Type = [Amazon.SimpleSystemsManagement.OpsItemDataType]::SearchableString
$opsItem.Value = '[{\"arn\":\"arn:aws:ec2:us-east-1:123456789012:instance/i-1234567890abcdef0\"}]'
$newHash = @{" /aws/resources"=[Amazon.SimpleSystemsManagement.Model.OpsItemDataValue]$opsItem}
New-SSMOpsItem -Title "EC2 instance disk full still" -Description "Log clean up may have failed which caused the disk to be full" -Priority 2 -Source ec2 -OperationalData $newHash
```
# OpsItems を管理する
AWS Systems Manager のツールである OpsCenter は、OpsItems の作成から解決までを追跡します。クロスアカウント管理のために OpsCenter を設定すると、委任管理者または管理アカウントが自分のアカウントから OpsItems を管理できます。詳細については、「[(オプション) OpsCenter の手動設定により、複数のアカウント間で OpsItems を一元管理する](OpsCenter-getting-started-multiple-accounts.md)」を参照してください。
Systems Manager コンソールの次のページを使用して OpsItems を表示および管理できます。
+ **概要** — 未解決かつ進行中の OpsItems の数、ソース別、経過時間別の OpsItems の数、運用上のインサイトが表示されます。ソース別および OpsItems のステータス別に OpsItems をフィルターできます。
+ **OpsItems** — タイトル、ID、優先度、説明、OpsItem のソース、最終更新日時など、複数のフィールドの情報が含まれる OpsItems のリストを表示します。このページを使用して、OpsItems の手動作成、ソースの設定、OpsItem のステータスの変更、新しいインシデントによる OpsItems のフィルタリングを行うことができます。OpsItem をクリックして、**[OpsItems の詳細]** ページを表示できます。
+ **OpsItem の詳細** — OpsItem の管理に使用できる詳細なインサイトとツールを提供します。OpsItems の詳細ページには、次のタブが表示されます。
+ **[概要]** — 関連リソース、過去 30 日間に実行されたランブック、実行可能なランブックのリストが表示されます。同様の OpsItems の情報を表示したり、運用データを追加したり、関連する OpsItems のデータを追加したりすることもできます。
+ **[関連リソースの詳細]** - AWS のいくつかのサービスから提供されるリソースに関する情報が表示されます。ホスト元の AWS のサービスから提供されるこのリソースに関する情報を表示するには、**[リソースの詳細]** のセクションを展開します。**[関連リソース]** リストを使用して、この OpsItem に関連付けられている他の関連リソース間を切り替えることもできます。
OpsItems の管理方法については、次のトピックを参照してください。
**Topics**
+ [OpsItem の詳細を表示する](OpsCenter-working-with-OpsItems-viewing-details.md)
+ [OpsItem の編集](OpsCenter-working-with-OpsItems-editing-details.md)
+ [関連リソースを OpsItem に追加する](OpsCenter-working-with-OpsItems-adding-related-resources.md)
+ [関連する OpsItems を OpsItem に追加する](OpsCenter-working-with-OpsItems-adding-related-OpsItems.md)
+ [運用データを OpsItem に追加する](OpsCenter-working-with-OpsItems-adding-operational-data.md)
+ [OpsItem のインシデントを作成する](OpsCenter-working-with-OpsItems-create-an-incident.md)
+ [OpsItems の重複を管理する](OpsCenter-working-deduplication.md)
+ [OpsItems を減らすために運用上のインサイトを分析する](OpsCenter-working-operational-insights.md)
+ [OpsCenter ログとレポートを表示する](OpsCenter-logging-auditing.md)
# OpsItem の詳細を表示する
OpsItem の包括的なビューを表示するには、OpsCenter コンソールの **[OpsItem の詳細]** ページを使用します。**[概要]** ページには、次の情報が表示されます。
+ **OpsItems の詳細** — 選択した OpsItem の一般情報を表示します。
+ **関連リソース** - 関連リソースは、影響を受けるリソース、またはイベントを開始して OpsItem を作成したリソースです。
+ **過去 30 日間の自動化の実行** — 過去 30 日間に実行されたランブックのリスト。
+ **ランブック** — 利用可能なランブックのリストからランブックを選択できます。
+ **類似する OpsItems** - ユーザーに関連している、または関心のある OpsItems のリスト。リストを生成するために、システムはすべての OpsItems のタイトルと説明をスキャンし、同様の用語を使用している OpsItems を返します。
+ **運用データ** – OpsItem に関する有用なリファレンスの詳細を提供するカスタムデータ。例えば、ログファイル、エラー文字列、ライセンスキー、トラブルシューティングのヒント、その他の関連データを指定することができます。
+ **関連する OpsItems** - 現在の OpsItem 何らかの関係がある OpsItems の ID を指定できます。
+ **関連リソースの詳細** - Amazon CloudWatch メトリクスとアラーム、AWS CloudTrail ログ、AWS Config の詳細などを含む、データプロバイダーを表示します。
**OpsItem の詳細を表示するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem を選択して、詳細を表示します。
# OpsItem の編集
**[OpsItem の詳細]** セクションには、OpsItem に関する情報 (説明、タイトル、ソース、OpsItem ID、ステータスなど) が含まれています。
OpsItem を個別に編集するか、複数のOpsItems を選択して、**[ステータス]**、**[優先度]**、**[重要度]**、**[カテゴリ]** フィールドを編集できます。
Amazon EventBridge が OpsItem を作成すると、**[タイトル]**、**[ソース]**、**[説明]** の各フィールドにデータが入力されます。**[タイトル]** および **[説明]** フィールドは編集できますが、**[ソース]** フィールドは編集できません。
**注記**
コンソールは OpsItem 説明フィールドのほとんどの Markdown フォーマットをサポートしています。詳細については、「AWS マネジメントコンソール 入門ガイド」の「[コンソールでの Markdown の使用](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html)」を参照してください。**
通常は、以下の OpsItem の設定可能なデータを編集することができます。
+ **タイトル** — OpsItem の名前。ソースが OpsItem のタイトルを作成します。
+ **説明** - 問題を再現するための手順など、この OpsItem に関する情報。
+ **ステータス** – OpsItem のステータス。有効なステータスの値のリストについては、「*AWS Systems Manager API リファレンス*」の「[OpsItem のステータス](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_OpsItem.html#systemsmanager-Type-OpsItem-Status)」を参照してください。
+ **優先度** — OpsItem の優先度は 1～5 の範囲で指定できます。各優先度の意味と、各レベルに対応するサービスレベルアグリーメントは組織で決定することをお勧めします。
+ **重要度** — OpsItem の重要度は 1～4 の範囲で指定します。1 は「重大」、2 は「高い」、3 は「中程度」、4 は「低い」です。
+ **カテゴリ** — OpsItem のカテゴリには、可用性、コスト、パフォーマンス、リカバリ、セキュリティなどがあります。
+ **通知** — OpsItem の編集時に **[通知]** フィールドで、Amazon Simple Notification Service (SNS) トピックの Amazon リソースネーム (ARN) を指定できます。ARN を指定することで、OpsItem が編集されると、ステータス変更を含むすべての関係者に通知が送信されるようにします。詳細については、「[Amazon Simple Notification Service デベロッパーガイド](https://docs.aws.amazon.com/sns/latest/dg/)」を参照してください。
**重要**
Amazon SNS トピックは、OpsItem と同じ AWS リージョン にある必要があります。トピックと OpsItem のリージョンが異なる場合は、システムはエラーを返します。
OpsCenter は AWS Security Hub CSPM と双方向に統合しています。セキュリティの検出結果に関連する OpsItem ステータスと重要度を更新すると、変更内容が自動的に Security Hub CSPM に送信され、常に最新で正しい情報が表示されます。
Security Hub CSPM 検出結果から OpsItem を作成すると、Security Hub CSPM メタデータが OpsItem の運用データフィールドに自動的に追加されます。このメタデータが削除されると、双方向更新は機能しなくなります。
**OpsItem の詳細を編集するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem ID を選択して、詳細ページを開くか、複数の OpsItems を選択します。複数の OpsItems 選択した場合、ステータス、優先度、重大度、またはカテゴリのみを編集できます。複数の OpsItems を編集する場合、OpsCenter は新しいステータス、優先度、重大度、またはカテゴリを選択すると、すぐに変更内容を更新、保存します。
1. [**OpsItem の詳細**] セクションで、[**編集**] を選択します。
1. 組織で指定された要件やガイドラインに応じて、OpsItem の詳細を編集します。
1. 完了したら、[**保存**] を選択します。
# 関連リソースを OpsItem に追加する
各 OpsItem には、**[関連リソース]** セクションが含まれ、関連リソースの Amazon リソースネーム (ARN) の一覧が表示されます。*[関連リソース]* とは、調査行う必要がある影響を受けた AWS リソースです。
Amazon EventBridge が OpsItem を作成すると、システムは自動的にリソースの ARN を OpsItem に入力します。また、関連リソースの ARN を手動で指定することもできます。特定の ARN タイプでは、OpsCenter が、リソースに関する詳細を表示するディープリンクを OpsCenter コンソールに自動的に作成します。例えば、Amazon Elastic Compute Cloud (Amazon EC2) インスタンスの ARN を指定すると、OpsCenter がその EC2 インスタンスに関する詳細を取得できます。これにより、影響を受ける AWS リソースに感する詳細な情報を表示することができます。OpsCenter を離れる必要はありません。
**関連リソースを表示して OpsItem に追加するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[OpsItems]** タブを選択します。
1. OpsItem ID を選択します。
![\[OpsCenter 概要ページの新しい OpsItem\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_working_scenario_1.png)
1. 影響を受けるリソースに関する情報を表示するには、[**関連リソースの詳細**] タブを選択します。
![\[OpsItem の関連リソースの詳細タブを表示する\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_working_scenario_1_5.png)
このタブには、いくつかの AWS のサービスから提供されるリソースに関する情報が表示されます。ホスト元の AWS のサービスから提供されるこのリソースに関する情報を表示するには、[**Resource details**] (リソースの詳細) のセクションを展開します。**[関連リソース]** リストを使用して、この OpsItem に関連付けられている他の関連リソース間を切り替えることもできます。
1. その他の関連リソースを追加するには、[**概要**] タブを選択します。
1. [**関連リソース**] セクションで、[**追加**] を選択します。
1. [**リソースタイプ**] で、リストからリソースを選択します。
1. [**リソース ID**] に、ID または Amazon リソースネーム (ARN) を入力します。選択する情報のタイプは、前のステップで選択したリソースによって異なります。
**注記**
その他の関連リソースの ARN は手動で追加することができます。各 OpsItem セクションには、最大 100 個の関連リソースの ARN を表示できます。
次の表は、関連するリソースへのディープリンクを自動的に作成するリソースタイプの一覧です。
**サポートされているリソースタイプ**
| リソース名 | ARN 形式 |
| --- | --- |
| AWS Certificate Manager 証明書 | arn:aws:acm:region:account-id:certificate/certificate-id
|
| Amazon EC2 Auto Scaling グループ | arn:aws:autoscaling:region:account-id:autoScalingGroup:groupid:autoScalingGroupName/groupfriendlyname
|
| Amazon CloudFront ディストリビューション | arn:aws:cloudfront::account-id:*
|
| AWS CloudFormation スタック | arn:aws:cloudformation:region:account-id:stack/stackname/additionalidentifier
|
| Amazon CloudWatch アラーム | arn:aws:cloudwatch:region:account-id:alarm:alarm-name
|
| AWS CloudTrail 証跡 | arn:aws:cloudtrail:region:account-id:trail/trailname
|
| AWS CodeBuild プロジェクト | arn:aws:codebuild:region:account-id:resourcetype/resource
|
| AWS CodePipeline | arn:aws:codepipeline:region:account-id:resource-specifier
|
| Amazon DevOps Guru のインサイト | arn:aws:devops-guru:region:account-id:insight/proactive or reactive/resource-id
|
| Amazon DynamoDB テーブル | arn:aws:dynamodb:region:account-id:table/tablename
|
| Amazon Elastic Compute Cloud (Amazon EC2) カスタマーゲートウェイ | arn:aws:ec2:region:account-id:customer-gateway/cgw-id
|
| Amazon EC2 elastic IP | arn:aws:ec2:region:account-id:eip/eipalloc-id
|
| Amazon EC2 Dedicated Host | arn:aws:ec2:region:account-id:dedicated-host/host-id
|
| Amazon EC2 インスタンス | arn:aws:ec2:region:account-id:instance/instance-id
|
| Amazon EC2 インターネットゲートウェイ | arn:aws:ec2:region:account-id:internet-gateway/igw-id
|
| Amazon EC2 ネットワークアクセスコントロールリスト (ネットワーク ACL) | arn:aws:ec2:region:account-id:network-acl/nacl-id
|
| Amazon EC2 ネットワークインターフェイス | arn:aws:ec2:region:account-id:network-interface/eni-id
|
| Amazon EC2 ルートテーブル | arn:aws:ec2:region:account-id:route-table/route-table-id
|
| Amazon EC2 セキュリティグループ | arn:aws:ec2:region:account-id:security-group/security-group-id
|
| Amazon EC2 サブネット | arn:aws:ec2:region:account-id:subnet/subnet-id
|
| Amazon EC2 ボリューム | arn:aws:ec2:region:account-id:volume/volume-id
|
| Amazon EC2 VPC | arn:aws:ec2:region:account-id:vpc/vpc-id
|
| Amazon EC2 VPN 接続 | arn:aws:ec2:region:account-id:vpn-connection/vpn-id
|
| Amazon EC2 VPN ゲートウェイ | arn:aws:ec2:region:account-id:vpn-gateway/vgw-id
|
| AWS Elastic Beanstalk アプリケーション | arn:aws:elasticbeanstalk:region:account-id:application/applicationname
|
| Elastic Load Balancing (Classic Load Balancer) | arn:aws:elasticloadbalancing:region:account-id:loadbalancer/name
|
| Elastic Load Balancing (Application Load Balancer) | arn:aws:elasticloadbalancing:region:account-id:loadbalancer/app/load-balancer-name/load-balancer-id
|
| Elastic Load Balancing (Network Load Balancer) | arn:aws:elasticloadbalancing:region:account-id:loadbalancer/net/load-balancer-name/load-balancer-id
|
| AWS Identity and Access Management (IAM) グループ | arn:aws:iam::account-id:group/group-name
|
| IAM ポリシー | arn:aws:iam::account-id:policy/policy-name
|
| IAM ロール | arn:aws:iam::account-id:role/role-name
|
| IAM ユーザー | arn:aws:iam::account-id:user/user-name
|
| AWS Lambda 関数 | arn:aws:lambda:region:account-id:function:function-name
|
| Amazon Relational Database Service (Amazon RDS) クラスター | arn:aws:rds:region:account-id:cluster:db-cluster-name
|
| Amazon RDS データベースインスタンス | arn:aws:rds:region:account-id:db:db-instance-name
|
| Amazon RDS サブスクリプション | arn:aws:rds:region:account-id:es:subscription-name
|
| Amazon RDS セキュリティグループ | arn:aws:rds:region:account-id:secgrp:security-group-name
|
| Amazon RDS クラスターのスナップショット | arn:aws:rds:region:account-id:cluster-snapshot:cluster-snapshot-name
|
| Amazon RDS サブネットグループ | arn:aws:rds:region:account-id:subgrp:subnet-group-name
|
| Amazon Redshift クラスター | arn:aws:redshift:region:account-id:cluster:cluster-name
|
| Amazon Redshift パラメータグループ | arn:aws:redshift:region:account-id:parametergroup:parameter-group-name
|
| Amazon Redshift セキュリティグループ | arn:aws:redshift:region:account-id:securitygroup:security-group-name
|
| Amazon Redshift クラスターのスナップショット | arn:aws:redshift:region:account-id:snapshot:cluster-name/snapshot-name
|
| Amazon Redshift サブネットグループ | arn:aws:redshift:region:account-id:subnetgroup:subnet-group-name
|
| Amazon Simple Storage Service (Amazon S3) バケット | arn:aws:s3:::bucket_name
|
| AWS Systems Manager マネージドノードのインベントリの AWS Config の記録 | arn:aws:ssm:region:account-id:managed-instance-inventory/node_id
|
| Systems Manager State Manager の関連付け | arn:aws:ssm:region:account-id:association/association_ID
|
# 関連する OpsItems を OpsItem に追加する
**[OpsItems 詳細]** ページの **[関連する OpsItems]** を使用すると、運用上の問題を調査し、問題の背景情報を取得できます。OpsItems は、OpsItems 間の親子関係、根本原因、または重複など、さまざまな方法で関連付けることができます。ある OpsItem を他の OpsItems と関連付けて、**[関連する OpsItem**] セクションに表示することができます。現在の OpsItem に関連する他の OpsItems の ID は、最大 10 個まで指定できます。
![\[関連する OpsItems の表示。\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_working_scenario_4.png)
**関連のある OpsItem を追加するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem ID を選択して、詳細ページを開きます。
1. [**関連 OpsItem**] セクションで、[**追加**] を選択します。
1. [**OpsItem ID**] で、ID を指定します。
1. **[Add]** (追加) を選択します。
# 運用データを OpsItem に追加する
運用データは、OpsItem に関する有用なリファレンスの詳細を提供するカスタムデータです。運用データの複数のキーと値のペアを入力できます。例えば、ログファイル、エラー文字列、ライセンスキー、トラブルシューティングのヒント、その他の関連データを指定することができます。キーの最大長は 128 文字、値の最大サイズは 20 KB になる可能性があります。
![\[OpsItem の運用データの表示。\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_working_scenario_7.png)
アカウント内の他のユーザーがデータを検索できるようにしたり、検索アクセスを制限したりすることもできます。検索可能なデータとは、OpsItem の **[概要]** ページ ([Describe OpsItems](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DescribeOpsItems.html) API オペレーションによって提供) にアクセスできるすべてのユーザーが特定のデータを表示および検索できるということです。検索可能でない運用データは、OpsItem ([GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html) API オペレーションによって提供) にアクセスできるユーザーが表示のみできます。
**運用データを OpsItem に追加するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem ID を選択して、詳細ページを開きます。
1. **[運用データ]** を展開します。
1. 運用データが OpsItem に存在しない場合は、**[追加]** をクリックします。運用データが OpsItem に既に存在する場合は、[**管理**] を選択します。
運用データを作成したら、[**管理**] を選択して、キーと値の編集、運用データの削除、その他キーと値のペアの追加を行うことができます。
1. [**キー**] で、データの目的を示すわかりやすい用語を指定します。
**重要**
オペレーションデータキーは、`amazon`、`aws`、`amzn`、`ssm`、`/amazon`、`/aws`、`/amzn`、`/ssm` で始まることは*できません*。
1. [**値**] で、データを指定します。
1. **[保存]** を選択します。
**注記**
**OpsItems** ページで [**Operational data (運用データ)**] 演算子を使用して OpsItems をフィルタ処理できます。**[検索]** ボックスで、**[運用データ]** をクリックし、キーと値のペアを JSON で入力します。次の形式を使用してキーと値のペアを入力する必要があります。`{"key":"key_name","value":"a_value"}`
# OpsItem のインシデントを作成する
以下の手順で、OpsItem のインシデントを手動で作成して、AWS Systems Manager のツールである AWS Systems Manager Incident Manager でインシデントの追跡と管理を行います。インシデントとは、サービスの品質の計画外の中断または低下です。インシデントマネージャーの詳細については、「[OpsCenter と他の AWS のサービス との統合](OpsCenter-applications-that-integrate.md)」を参照してください。
**OpsItem のインシデントを手動で作成するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. Incident Manager が OpsItem を作成した場合は、それを選択してステップ 5 に進みます。そうでない場合は、[**OpsItem の作成**] を選択し、フォームに記入します。このボタンが表示されない場合は、[**OpsItems**] タブを選択してから [**OpsItem の作成)**] を選択します。
1. 新しい OpsItem を作成した場合は、それを開きます。
1. [**インシデントの開始**] を選択します。
1. **[対応プラン]** で、このインシデントに割り当てるインシデントマネージャーの対応プランを選択します。
1. (オプション) [**タイトル**] に、他のチームメンバーがインシデントの性質を理解するのに役立つわかりやすい名前を入力します。新しいタイトルを入力しない場合、OpsCenter は対応プランのタイトルを使用して、Incident Manager に OpsItem と対応するインシデントを作成します。
1. (オプション) [**インシデントの影響**] では、このインシデントの影響レベルを選択します。影響レベルを選択しない場合、OpsCenter は、対応プランの影響レベルを使用して、Incident Manager で OpsItem および対応するインシデントを作成します。
1. **[開始]** を選択します。
# OpsItems の重複を管理する
OpsCenter は、1 つのソースに対して複数の AWS のサービス から複数の重複する OpsItems を受け取ることができます。OpsCenter は、組み込みロジックと設定可能な重複排除文字列の組み合わせを使用して、重複する OpsItems を作成しないようにします。AWS Systems Manager は、[Create OpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_CreateOpsItem.html) API オペレーションが呼び出されると、重複排除の組み込みロジックを適用します。
AWS Systems Manager は、次の重複排除ロジックを使用します。
1. OpsItem を作成するとき、Systems Manager は重複排除文字列と OpsItem を開始したリソースに基づいてハッシュを作成して保存します。
1. OpsItem を作成するリクエストを受け取ると、システムは新しいリクエストの重複排除文字列をチェックします。
1. この重複排除文字列に一致するハッシュが存在する場合、Systems Manager は既存の OpsItem をチェックします。既存の OpsItem のステータスが未解決または進行中の場合、OpsItem は作成されません。既存の OpsItem が解決されると、Systems Manager は新しい OpsItem を作成します。
OpsItem を作成した後、その OpsItem で重複排除文字列を編集または変更することは*できません*。
OpsItems の重複を管理するには、次の操作を行います。
+ OpsCenter をターゲットにする Amazon EventBridge ルールの重複排除文字列を編集します。詳細については、「[デフォルトの EventBridge ルールの重複排除文字列を編集する](#OpsCenter-working-deduplication-editing-cwe)」を参照してください。
+ OpsItem を手動で作成するときに、重複排除文字列を指定します。詳細については、「[AWS CLI を使用して重複排除文字列を指定する](#OpsCenter-working-deduplication-configuring-manual-cli)」を参照してください。
+ 運用インサイトを使用して、重複する OpsItems を確認して解決します。重複する OpsItems は、ランブックを使用して解決できます。
重複する OpsItems を解決し、ソースによって作成される OpsItems の数を減らすために、Systems Manager では自動化ランブックが提供されています。詳細については、「[インサイトに基づく重複 OpsItems の解決](OpsCenter-working-operational-insights.md#OpsCenter-working-operational-insights-resolve)」を参照してください。
## デフォルトの EventBridge ルールの重複排除文字列を編集する
OpsCenter をターゲットとする EventBridge ルールに重複排除文字列を指定するには、次の手順を使用します。
**デフォルトの EventBridge ルールの重複排除文字列を編集するには**
1. AWS マネジメントコンソール にサインインし、Amazon EventBridge コンソール ([https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/)) を開きます。
1. ナビゲーションペインで [**ルール**] を選択します。
1. ルールを選択し、[**編集**] を選択します。
1. [**Select target(s)**] (ターゲットの選択) ページに移動します。
1. [**Additional settings**] (追加設定) セクションの [**Configure input transformer**] (入力トランスフォーマーの設定) を選択します。
1. [**Template**] (テンプレート) ボックスで、編集する `"operationalData": { "/aws/dedup"` JSON エントリと重複排除文字列を見つけます。
EventBridge ルールの重複排除文字列を入力する際は、以下の JSON 形式を使用します。
```
"operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"Words the system should use to check for duplicate OpsItems\"}"}}
```
以下はその例です。
```
"operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"SSMOpsCenter-EBS-volume-performance-issue\"}"}}
```
1. 重複排除文字列を編集し、**[確認]** をクリックします。
1. [**次へ**] を選択します。
1. [**次へ**] を選択します。
1. [**ルールの更新**] を選択します。
## AWS CLI を使用して重複排除文字列を指定する
重複排除文字列は、AWS Systems Manager コンソールまたは AWS CLI のいずれかを使用して、新しい OpsItem を手動で作成するときに指定することができます。コンソールで OpsItem を手動で作成するときに重複排除文字列を入力する方法については、「[OpsItems を手動で作成する](OpsCenter-manually-create-OpsItems.md)」を参照してください。AWS CLI を使用している場合、`OperationalData` パラメータに重複排除文字列を入力できます。次の例に示すように、パラメータの構文では JSON を使用します。
```
--operational-data '{"/aws/dedup":{"Value":"{\"dedupString\": \"Words the system should use to check for duplicate OpsItems\"}","Type":"SearchableString"}}'
```
以下に示しているのは、`disk full` の重複排除文字列を指定するコマンドの例です。
------
#### [ Linux & macOS ]
```
aws ssm create-ops-item \
--title "EC2 instance disk full" \
--description "Log clean up may have failed which caused the disk to be full" \
--priority 1 \
--source ec2 \
--operational-data '{"/aws/dedup":{"Value":"{\"dedupString\": \"disk full\"}","Type":"SearchableString"}}' \
--tags "Key=EC2,Value=ProductionServers" \
--notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser"
```
------
#### [ Windows ]
```
aws ssm create-ops-item ^
--title "EC2 instance disk full" ^
--description "Log clean up may have failed which caused the disk to be full" ^
--priority 1 ^
--source EC2 ^
--operational-data={\"/aws/dedup\":{\"Value\":\"{\\"""dedupString\\""":\\"""disk full\\"""}\",\"Type\":\"SearchableString\"}} ^
--tags "Key=EC2,Value=ProductionServers" --notifications Arn="arn:aws:sns:us-west-1:12345678:TestUser"
```
------
# OpsItems を減らすために運用上のインサイトを分析する
OpsCenter の**運用上のインサイトには、重複する OpsItems に関する情報が表示されます。OpsCenter はアカウント内で自動的に OpsItems を分析し、3 種類の**インサイトを生成します。この情報は OpsCenter **[概要]** タブの **[運用上のインサイト]** セクションで確認できます。
+ **OpsItems を複製** – このフィールドには、同じリソースに同じタイトルの OpsItems が 8 個以上ある場合に、インサイトが 1 件生成されます。
+ **最も一般的なタイトル** — 同じタイトルの OpsItems が 50 件を超えるとインサイトが 1 件生成されます。
+ **OpsItems を最も多く生成するリソース** — AWS 件のリソースに OpsItems が 10 件以上開いているときにインサイトが 1 件生成されます。これらのインサイトとそれに対応するリソースが、OpsCenter **[概要] ** タブの [**OpsItems を最も多く生成するリソース**] テーブルに表示されます。リソースは OpsItem の数の多い順に一覧表示されます。
**注記**
OpsCenter は以下のリソースタイプについて **[OpsItems を最も多く生成するリソース]** インサイトを作成します。
Amazon Elastic Compute Cloud (Amazon EC2) インスタンス
Amazon EC2 セキュリティグループ
Amazon EC2 Auto Scaling グループ
Amazon Relational Database Service (Amazon RDS) データベース
Amazon RDS クラスター
AWS Lambda 関数
Amazon DynamoDB テーブル
Elastic Load Balancing ロードバランサー
Amazon Redshift クラスター
AWS Certificate Manager 証明書
Amazon Elastic Block Store ボリューム
OpsCenter は 1 つのタイプにつきインサイト 15 件までという上限を設けています。タイプがこの上限に達すると、OpsCenter はそのタイプのインサイトの表示を停止します。追加のインサイトを表示するには、そのタイプの OpsInsight に関連付けられた OpsItems をすべて解決する必要があります。15 件のインサイトの上限により、保留中のインサイトがコンソールに表示されない場合、そのインサイトは他のインサイトが閉じられた後に表示されます。
インサイトを選択すると、影響を受ける OpsItems とリソースに関する情報が OpsCenter に表示されます。次のスクリーンショットは、重複している OpsItem インサイトの詳細を示した例です。
![\[OpsItems に関する情報が含まれる OpsCenter インサイトの詳細ビュー。\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsCenter-insights-detailed.png)
運用上のインサイトは、デフォルトで無効になっています。運用上のインサイトの使用に関する詳細については、以下のトピックを参照してください。
**Topics**
+ [運用上のインサイトを無効化する](#OpsCenter-working-operational-insights-viewing)
+ [インサイトに基づく重複 OpsItems の解決](#OpsCenter-working-operational-insights-resolve)
+ [オペレーションインサイトの無効化](#OpsCenter-working-operational-insights-disable)
## 運用上のインサイトを無効化する
Systems Manager コンソールの **OpsCenter** ページで運用上のインサイトを有効にできます。運用上のインサイトを有効にすると、Systems Manager は `AWSServiceRoleForAmazonSSM_OpsInsights` という名前の AWS Identity and Access Management (IAM) サービスリンクロールを作成します。サービスにリンクされたロールは、Systems Manager に直接リンクされた一意のタイプの IAM ロールです。サービスにリンクされたロールは事前定義されており、サービスがユーザーに代わって他の AWS のサービス を呼び出すために必要なすべてのアクセス許可が含まれています。`AWSServiceRoleForAmazonSSM_OpsInsights` サービスにリンクされたロールの詳細については、[ロールを使用して Systems Manager OpsCenter で運用上のインサイト OpsItems を作成する](using-service-linked-roles-service-action-4.md)を参照してください。
**注記**
次の重要な情報に注意してください。
運用上のインサイトは、お客様の AWS アカウントに課金されます。詳細については、[AWS Systems Manager の料金](https://aws.amazon.com/systems-manager/pricing/)を参照してください。
OpsCenter は、バッチプロセスを使用してインサイトを定期的に更新します。つまり、OpsCenter に表示されるインサイトの一覧は同期されていない可能性があります。
OpsCenter で運用上のインサイトを有効にして表示するには、次の手順を使用します。
**運用上のインサイトを有効にして表示するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[運用上のインサイトが利用可能です]** メッセージボックスで、**[有効化]** を選択します。このメッセージが表示されない場合は、**[運用上のインサイト]** セクションまで下にスクロールして **[有効化]** を選択します。
1. この機能を有効にしたら、**[概要]** タブの **[運用上のインサイト]** セクションまで下にスクロールします。
1. フィルター処理されたインサイトのリンクを表示するには、**[OpsItems を重複]**、**[最も一般的なタイトル]**、または**[OpsItems を最も多く生成するリソース]** の隣にあるリンクを選択します。すべてのインサイトを表示するには、**[運用に関するすべてのインサイトを表示]** を選択してください。
1. 詳細情報を表示するには、インサイト ID を選択します。
## インサイトに基づく重複 OpsItems の解決
インサイトを解決するには、まず、インサイトに関連付けられている OpsItems をすべて解決する必要があります。インサイトに関連付けられている OpsItems を解決するため、`AWS-BulkResolveOpsItemsForInsight` ランブックを使用できます。
重複する OpsItems を解決し、ソースによって作成された OpsItems の数を減らすために、Systems Manager では、以下のような自動化ランブックが提供されています。
+ `AWS-BulkResolveOpsItems` ランブックは、特定のフィルターに一致する OpsItems を解決します。
+ `AWS-AddOpsItemDedupStringToEventBridgeRule` ランブックは、特定の Amazon EventBridge ルールに関連付けられたすべての OpsItem ターゲットの重複解除文字列を追加します。ルールが既に存在する場合、このランブックは重複解除文字列を追加しません。
+ EventBridge のルールが数十から数百の OpsItems を生成している場合、`AWS-DisableEventBridgeRule` によってそのルールがオフになります。
**オペレーションに関するインサイトを解決するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[概要]** タブで下にスクロールして、**[オペレーションインサイト]**までスクロールダウンします。
1. **[オペレーションに関するすべてのインサイトを表示]** を選択します。
1. 詳細情報を表示するには、インサイト ID を選択します。
1. ランブックを選択し、**[実行]** を選択します。
## オペレーションインサイトの無効化
運用上のインサイトを無効にすると、システムは新しいインサイトの作成を停止し、コンソールでのインサイトの表示を停止します。アクティブなインサイトは、コンソールに表示されることはありませんが、システム内では変更されないままになっています。この機能を再度有効にすると、システムは未解決のインサイトを表示し、新しいインサイトの作成を開始します。運用上のインサイトをオフにするには、次の手順に従います。
**運用上のインサイトをオフにするには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[設定]** を選択します。
1. **[オペレーションインサイト]** セクションで **[編集]** を選択してから、**[無効化]** オプションにトグルします。
1. **[保存]** を選択します。
# OpsCenter ログとレポートを表示する
AWS CloudTrail は、コンソール、AWS Command Line Interface (AWS CLI)、および SDK への AWS Systems Manager OpsCenter API コールをログに記録します。CloudTrail コンソールまたは Amazon Simple Storage Service (Amazon S3) バケットで情報を表示できます。Amazon S3 は、1 つのバケットを使用して、アカウントのすべての CloudTrail ログを保存します。
OpsCenter アクションのログには、OpsItem アクティビティの作成、更新、取得、および説明が含まれます。Systems Manager アクティビティの CloudTrail ログの表示と使用の詳細については、「[AWS CloudTrail による AWS Systems Manager API コールのログ記録](monitoring-cloudtrail-logs.md)」を参照してください。
AWS Systems Manager OpsCenter は、OpsItems に関する情報を提供します。
+ **OpsItem ステータスの概要** - ステータス別 (未解決で進行中、未解決、進行中) の OpsItems の概要。
+ **未解決の上位 OpsItems を含むソース** - 未解決の OpsItems が含まれている上位の AWS のサービス の内訳。
+ **ソース別および経過日数別の OpsItems** - ソース別および経過日数別にグループ化した OpsItems の数。
**OpsCenter の概要レポートを表示するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItems の **[概要]** ページで、**[概要]** をクリックします。
1. [**OpsItems by source and age** (ソース別および経過時間別の OpsItems)] で検索バーを選択し、[**Source ** (ソース)] に基づいて OpsItems をフィルター処理します。リストを使用して、[**Status (ステータス)**] に基づいてフィルタ処理します。
# OpsItems を削除する
AWS Command Line Interface または AWS SDK を使用して [DeleteOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_DeleteOpsItem.html) API 操作を呼び出すと、個々の OpsItem を削除できます。AWS マネジメントコンソール で OpsItem を削除することはできません。OpsItem を削除するには、AWS Identity and Access Management (IAM) ユーザー、グループ、またはロールに管理者アクセス許可があるか、`DeleteOpsItem` API 操作を呼び出すアクセス許可が付与されている必要があります。
**重要**
この操作に関しては、次の重要事項に留意してください。
OpsItem を削除すると元に戻せません。削除された OpsItem を復元することはできません。
この操作では**結果整合性モデルが使用されるため、システムがこの操作を完了するまでに数分かかることがあります。OpsItem を削除し、[GetOpsItem](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_GetOpsItem.html) などをすぐに呼び出しても、削除した OpsItem が応答に表示されることがあります。
このオペレーションはべき等です。同じ OpsItem に対してこの操作を繰り返し呼び出しても、システムは例外を発生させません。最初の呼び出しが成功すると、それ以降のすべての呼び出しは最初の呼び出しと同じ成功応答を返します。
この操作ではアカウント間呼び出しをサポートしていません。OpsCenter がアカウント間管理用にセットアップされている場合、委任管理者または管理アカウントは、他のアカウントで OpsItems を削除できません。アカウント間管理の詳細については、「[(オプション)OpsCenter を設定して、複数のアカウント間で OpsItems を一元管理する](OpsCenter-setting-up-cross-account.md)」を参照してください。
`OpsItemLimitExceededException` が表示された場合は、OpsItems を 1 つ以上削除して、OpsItems の合計数をクォータ制限以下に減らします。この例外の詳細については、「[OpsCenter で問題のトラブルシューティング](OpsCenter-troubleshooting.md)」を参照してください。
## OpsItem の削除
以下の手順に従って、OpsItem を削除します。
**OpsItem を削除するには**
1. まだ AWS CLI をインストールして設定していない場合はインストールして設定します。詳細については、「[Installing or updating the latest version of the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)」を参照してください。
1. 以下のコマンドを実行してください。削除する OpsItem の ID で *[ID]* を置き換えます。
```
aws ssm delete-ops-item --ops-item-id ID
```
正常終了すると、コマンドは何も返しません。
# OpsItem の問題を修正する
AWS Systems Manager 自動化ランブックを使用して、OpsItem で特定した AWS リソースに関する問題を修正できます。オートメーションは、事前定義されたランブックを使用して、AWS リソースに関する一般的な問題を修正します。
各 OpsItem には **[ランブック]** セクションがあり、修正に使用できるランブックがリストされています。リストから自動化ランブックを選択すると、OpsCenter がドキュメントの実行に必要なフィールドの一部を自動的に表示します。自動化ランブックを実行すると、システムはランブックを OpsItem の関連リソースに自動的に関連付けます。Amazon EventBridge が OpsItem を作成すると、ランブックが OpsItem に関連付けられます。OpsCenter は、OpsItem の自動化ランブックを 30 日間記録します。
次の例に示すように、オートメーションが失敗した理由、失敗したときに実行されていた自動化ランブックのステップなど、その実行に関する重要な詳細を表示するステータスを選択できます。
![\[Automation ランブックが最後に実行されたときのステータス情報。\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_automation_results.png)
選択した OpsItem の [**関連リソースの詳細**] ページには、[**Run automation**] リストが含まれます。最近使用した自動化ランブックまたはリソース固有の自動化ランブックを選択して、問題を修正できます。このページには、Amazon CloudWatch メトリクスとアラーム、AWS CloudTrail ログ、AWS Config の詳細など、役立つデータプロバイダーも含まれています。
![\[[関連リソース] タブで使用可能なメトリクス。\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_automation_related_resource_details.png)
Automation ランブックに関する情報を表示するには、コンソールでその名前を選択するか、[Systems Manager Automation ランブックのリファレンス](automation-documents-reference.md) を使用します。
## ランブックを使用して OpsItem を修正する
自動化ランブックを使用して OpsItem の問題を修正する前に、次の操作を行います。
+ Systems Manager Automation ランブックを実行するためのアクセス許可があることを確認します。詳細については、「」を参照してください[オートメーションの設定](automation-setup.md)
+ 実行する自動化のリソース固有の ID 情報を収集します。例えば、EC2 インスタンスを再起動するオートメーションを実行する場合、再起動する EC2 インスタンスの ID を指定する必要があります。
**Automation ランブックを実行して OpsItem の問題を修復するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem ID を選択して、詳細ページを開きます。
![\[OpsCenter 概要ページの新しい OpsItem\]](http://docs.aws.amazon.com/ja_jp/systems-manager/latest/userguide/images/OpsItems_working_scenario_1.png)
1. [**ランブック**] セクションまでスクロールします。
1. 検索バー、または右上の数字を使用して、実行する自動化ランブックを検索します。
1. ランブックを選択し、[**実行**] を選択します。
1. ランブックの必要な情報を入力し、**[送信]** を選択します。
ランブックを起動すると、システムは前の画面に戻り、ステータスを表示します。
1. **[過去 30 日間の自動化]** セクションで、**[実行 ID]** リンクを選択して、実行のステップとステータスを表示します。
## 関連するランブックを使用して、OpsItem を修正する
OpsItem から自動化ランブックを実行すると、OpsCenter がランブックを OpsItem に関連付けます。関連付けられたランブックは、**[ランブック]** リストの他のランブックよりも上位にランク付けされます。
次の手順に従って、OpsItem の関連リソースに既に関連付けられている Automation ランブックを実行します。関連リソースの追加については、「[OpsItems を管理する](OpsCenter-working-with-OpsItems.md)」を参照してください。
**リソースに関連付けられたランブックを実行して OpsItem の問題を修復するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. OpsItem を開きます。
1. [**関連リソース**] セクションで、 Automation ランブックを実行するリソースを選択します。
1. [**Run automation (自動化を実行)**] を選択し、実行する関連付けられた Automation ランブックを選択します。
1. ランブックの必要な情報を入力し、[**実行**] を選択します。
ランブックを起動すると、システムは前の画面に戻り、ステータスを表示します。
1. **[過去 30 日間の自動化]** セクションで、**[実行 ID]** リンクを選択して、実行のステップとステータスを表示します。
# OpsCenter 概要レポートの表示
AWS Systems Manager OpsCenter には、概要ページが含まれており、以下の情報が自動的に表示されます。
+ **OpsItem ステータス概要** – `Open` や `In progress` といった、ステータス別の OpsItems の概要。
+ **最もオープンな OpsItems を持つソース** – OpsItems が最も多く開かれた AWS のサービス の内訳。
+ **ソースと経過日数別の OpsItems** - ソース別および経過日数別にグループ化した OpsItems の数。
**OpsCenter 概要レポートを表示するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで **OpsCenter** を選択し、次に [**概要**] タブを選択します。
1. **ソースと経過日数別の OpsItems** セクションで、以下の操作を行います。
1. (オプション) フィルターフィールドで、[**ソース**] を選択したら、`Equal`、`Begin With`、または `Not Equal` を選択し、検索パラメータを入力します。
1. 隣接するリストで、次のいずれかのステータス値を選択します。
+ `Open`
+ `In progress`
+ `Resolved`
+ `Open and in progress`
+ `All`
# OpsCenter で問題のトラブルシューティング
このトピックには、OpsCenter の一般的なエラーや問題のトラブルシューティングに役立つ情報が収められています。
## OpsItemLimitExceededException の発生
CreateOpsItem API オペレーションを呼び出したときに、AWS アカウント が許可されている OpsItems の最大数に達すると、`OpsItemLimitExceededException` を受け取ります。OpsCenter は呼び出しが以下のいずれかのクォータの OpsItems の最大数を超えると、例外を返します。
+ リージョンの AWS アカウント あたりの `Open` 総数 (OpsItems および `Resolved` OpsItems を含む): 500,000
+ 1 か月の AWS アカウント あたりの OpsItems の最大数: 10,000
これらのクォータは、以下を除くすべてのソースから作成された OpsItems に適用されます。
+ AWS Security Hub CSPM の検出結果により作成された OpsItems
+ Incident Manager のインシデントが開かれると自動生成される OpsItems
これらのソースから作成された OpsItems は OpsItem クォータにはカウントされませんが、OpsItem ごとに課金されます。
`OpsItemLimitExceededException` を受け取った場合は、OpsItem の新規作成を妨げるクォータより少なくなるまで、OpsItems を手動で削除できます。繰り返しになりますが、Security Hub CSPM の検出結果または Incident Manager のインシデント用に作成された OpsItems を削除しても、クォータによって適用される OpsItems の総数は減りません。他のソースから OpsItems を削除する必要があります。OpsItem を削除する方法については、「[OpsItems を削除する](OpsCenter-delete-OpsItems.md)」を参照してください。
## AWS から自動生成された大量の OpsItems に対し高額な請求書が届く
AWS Security Hub CSPM との統合を設定した場合、OpsCenter は Security Hub CSPM の検出結果に OpsItems を作成します。Security Hub CSPM が生成する検出結果の数と、統合を設定したときにログインしていたアカウントによっては、OpsCenter は OpsItems を大量に生成する可能性があります。これには料金が発生します。Security Hub CSPM の検出結果によって生成される OpsItems に関連する具体的な詳細は次のとおりです。
+ 設定時に Security Hub CSPM 管理者アカウントにログインしていて、OpsCenter と Security Hub CSPM の統合を設定すると、システムは管理者**とすべてのメンバーアカウントの検出結果に OpsItems を作成します。OpsItems は管理者アカウントですべて作成されます。**さまざまな要因によっては、これにより AWS から予想外に多額の請求が発生する可能性があります。
統合を設定するときにログインしていたのがメンバーアカウントであった場合、システムは個人のアカウントの検出結果にのみ OpsItems を作成します。Security Hub CSPM 管理者アカウント、メンバーアカウント、および検出結果の EventBridge イベントフィードとの関係の詳細については、AWS Security Hub ユーザーガイドで「[Types of Security Hub CSPM integration with EventBridge](https://docs.aws.amazon.com/securityhub/latest/userguide/securityhub-cwe-integration-types.html)」を参照してください。**
+ 検出結果が OpsItem を作成するたびに、OpsItem の作成には通常料金がかかります。また、OpsItem を編集した場合や、対応する検出結果が Security Hub CSPM で更新された場合 (その結果として OpsItem がトリガーされた場合) にも課金されます。
+ AWS Security Hub CSPM との統合によって作成された OpsItems は現在、リージョンのアカウントあたり 500,000 OpsItems の最大クォータによって制限*されていません*。そのため、Security Hub CSPM アラートによって、アカウント内の各リージョンで 500,000 を超える課金対象の OpsItems が作成される可能性があります。
高負荷の本番環境では、Security Hub CSPM の検出結果の範囲を重要度の高い問題のみに制限することをお勧めします。
**重要**
OpsItems の多くが誤って作成されたもので、AWS の請求内容が不当であると思われる場合は、サポート にお問い合わせください。
Security Hub CSPM の検出結果に対してシステムで OpsItems を作成する必要がなければ、次の手順を使用してください。
**Security Hub CSPM の検出結果に対する OpsItems の受信を停止するには**
1. AWS Systems Manager コンソール ([https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)) を開きます。
1. ナビゲーションペインで、**[OpsCenter]** を選択します。
1. **[設定]** を選択します。
1. **[Security Hub CSPM findings]** セクションで、**[編集]** を選択します。
1. スライダーを選択して **[有効]** を **[無効]** に変更します。スライダーを切り替えられない場合は、AWS アカウント の Security Hub CSPM が有効になっていません。
1. **[保存]** を選択して設定を保存します。OpsCenter は Security Hub CSPM の検出結果に基づいて OpsItems を作成しなくなります。
**重要**
OpsCenter が設定を **[有効]** に戻し、検出結果の OpsItems の作成を続行する場合は、Systems Manager の委任管理者アカウントまたは AWS Organizations 管理アカウントにログインして、この手順を繰り返します。これらのアカウントにログインするアクセス許可がない場合は、管理者に連絡し、この手順を繰り返してアカウントの統合を無効にするよう依頼してください。