• La AWS Systems Manager CloudWatch dashboard non sarà più disponibile dopo il 30 aprile 2026. I clienti possono continuare a utilizzare la CloudWatch console Amazon per visualizzare, creare e gestire le proprie CloudWatch dashboard Amazon, proprio come fanno oggi. Per ulteriori informazioni, consulta la [documentazione di Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Creare OpsItems
Dopo aver configurato OpsCenter, uno strumento di AWS Systems Manager, e averlo integrato con i tuoi Servizi AWS, i Servizi AWS creano automaticamente OpsItems in base a regole, eventi o allarmi predefiniti.
Puoi visualizzare gli stati e i livelli di gravità delle regole Amazon EventBridge predefinite. Se necessario, puoi creare o modificare queste regole da Amazon EventBridge. Puoi anche visualizzare gli allarmi provenienti da Amazon CloudWatch e creare o modificare gli allarmi. Utilizzando regole e allarmi, puoi configurare gli eventi per i quali desideri generare automaticamente OpsItems.
Quando il sistema crea un OpsItem, è nello stato **Aperto**. È possibile modificare lo stato a **In corso** quando avvii l'indagine sull'OpsItem e in **Risolto** dopo aver risolto l'OpsItem. Per ulteriori informazioni su come configurare gli allarmi e le regole in Servizi AWS per la creazione di OpsItems e per informazioni sulla creazione manuale di OpsItems, consulta gli argomenti seguenti.
**Topics**
+ [Configura EventBridge le regole per creare OpsItems](OpsCenter-automatically-create-OpsItems-2.md)
+ [Configura CloudWatch allarmi da creare OpsItems](OpsCenter-create-OpsItems-from-CloudWatch-Alarms.md)
+ [Crea OpsItems manualmente](OpsCenter-manually-create-OpsItems.md)
# Configura EventBridge le regole per creare OpsItems
Quando Amazon EventBridge riceve un evento, ne crea uno nuovo OpsItem basato su regole predefinite. Puoi creare una regola o modificare una regola esistente da impostare OpsCenter come destinazione di un EventBridge evento. Per informazioni su come creare una regola di evento, consulta [Creating a rule for an Servizio AWS](https://docs.aws.amazon.com/eventbridge/latest/userguide/create-eventbridge-rule.html) nella *Amazon EventBridge User Guide*.
**Per configurare una EventBridge regola da creare OpsItems in OpsCenter**
1. Apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel riquadro di navigazione, scegli **Regole**.
1. Alla pagina **Regole**, per **Router di eventi**, scegli **predefinito**.
1. Per **Regole**, scegli una regola selezionando la casella di controllo accanto al rispettivo nome.
1. Seleziona il nome della regola per aprire la relativa pagina dei dettagli. Nella sezione **Dettagli regola**, verifica che **Stato** sia impostato su **Abilitato**.
**Nota**
Se necessario, puoi aggiornare lo stato utilizzando il selettore **Modifica** nell'angolo in alto a destra della pagina.
1. Scegliere la scheda **Destinazioni**.
1. Nella scheda **Destinazioni** scegliere **Modifica**.
1. Per i **tipi di destinazione**, selezionare **Servizio AWS**.
1. Per **Select a target** (Seleziona una destinazione), scegli **Systems Manager OpsItem**.
1. Per molti tipi di target, è EventBridge necessaria l'autorizzazione per inviare eventi alla destinazione. In questi casi, EventBridge può creare il ruolo AWS Identity and Access Management (IAM) necessario per l'esecuzione della regola:
+ Per creare un ruolo IAM automaticamente, seleziona **Crea un nuovo ruolo per questa risorsa specifica**.
+ Per utilizzare un ruolo IAM che hai creato per EventBridge autorizzare la creazione OpsItemsOpsCenter, scegli **Usa il ruolo esistente**.
1. Nella sezione **Impostazioni aggiuntive**, per **Configura input target**, scegli **Trasformatore di input**.
È possibile utilizzare l'opzione **Trasformatore di input** per specificare una stringa di deduplicazione e altre informazioni importanti per OpsItems, come un titolo e una gravità.
1. Seleziona **Configura il trasformatore di input**.
1. Nella sezione **Trasformatore di input target**, per **Percorso di input**, specifica i valori da analizzare dell'evento di attivazione. Ad esempio, per analizzare l'ora di inizio, l'ora di fine e altri dettagli dell'evento che attiva la regola, utilizza il seguente JSON.
```
{
"end-time": "$.detail.EndTime",
"failure-cause": "$.detail.cause",
"resources": "$.resources[0]",
"source": "$.detail.source",
"start-time": "$.detail.StartTime"
}
```
1. Per **Template**, specifica le informazioni da inviare alla destinazione. Ad esempio, utilizza il seguente codice JSON per trasmettere informazioni aOpsCenter. Le informazioni vengono utilizzate per creare un OpsItem.
**Nota**
Se il modello di input è in formato JSON, il valore dell'oggetto nel modello non può includere virgolette. Ad esempio, i valori per le risorse, la causa dell'errore, l'origine, l'ora di inizio e l'ora di fine non possono essere racchiusi tra virgolette.
```
{
"title": "EBS snapshot copy failed",
"description": "CloudWatch Event Rule SSMOpsItems-EBS-snapshot-copy-failed was triggered. Your EBS snapshot copy has failed. See below for more details.",
"category": "Availability",
"severity": "2",
"source": "EC2",
"operationalData": {
"/aws/dedup": {
"type": "SearchableString",
"value": "{\"dedupString\":\"SSMOpsItems-EBS-snapshot-copy-failed\"}"
},
"/aws/automations": {
"value": "[ { \"automationType\": \"AWS:SSM:Automation\", \"automationId\": \"AWS-CopySnapshot\" } ]"
},
"failure-cause": {
"value":
},
"source": {
"value":
},
"start-time": {
"value":
},
"end-time": {
"value":
},
},
"resources": {
"value":
}
}
}
```
Per ulteriori informazioni su questi campi, consulta [Transforming target input](https://docs.aws.amazon.com/eventbridge/latest/userguide/transform-input.html) nella *Amazon EventBridge User Guide*.
1. Scegli **Conferma**.
1. Scegli **Successivo**.
1. Scegli **Next (Successivo)**.
1. Scegli **Aggiorna regola**.
Dopo che un OpsItem viene creato da un evento, è possibile visualizzare i dettagli dell'evento aprendo OpsItem e scorrendo alla sezione **Dati operativi privati**. Per ulteriori informazioni su come configurare le opzioni in un OpsItem, consulta [Gestione degli OpsItems](OpsCenter-working-with-OpsItems.md).
# Configura CloudWatch allarmi da creare OpsItems
Durante la configurazione integrata diOpsCenter, a tool in AWS Systems Manager, consenti CloudWatch ad Amazon di creare automaticamente in OpsItems base agli allarmi comuni. Puoi creare un allarme o modificare un allarme esistente per la creazione di OpsItems in OpsCenter.
CloudWatch crea un nuovo ruolo collegato ai servizi in AWS Identity and Access Management (IAM) quando configuri un allarme da creare. OpsItems Il nuovo ruolo è denominato `AWSServiceRoleForCloudWatchAlarms_ActionSSM`. *Per ulteriori informazioni sui ruoli CloudWatch collegati ai servizi, consulta [Using service-linked roles nella](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/using-service-linked-roles.html) Amazon User CloudWatch Guide. CloudWatch *
Quando un CloudWatch allarme genera un allarmeOpsItem, OpsItem visualizza l'**CloudWatch allarme: '*alarm\$1name*' è** in stato ALARM.
Per visualizzare i dettagli relativi a uno specifico OpsItem, scegli l'OpsItem, quindi scegli la scheda **Dettagli della risorsa correlata**. È possibile modificare manualmente OpsItems per cambiare dettagli quali la gravità o la categoria. Tuttavia, quando si modifica la gravità o la categoria di un allarme, Systems Manager non può aggiornare la gravità o la categoria degli OpsItems che sono già stati creati dall'allarme. Se un allarme ha creato una stringa di deduplicazione OpsItem e se hai specificato una stringa di deduplicazione, l'allarme non ne creerà un'altra OpsItems anche se modifichi l'avviso in. CloudWatch Se OpsItem viene risolto inOpsCenter, CloudWatch ne creerà uno nuovo. OpsItem
Per ulteriori informazioni sulla configurazione degli CloudWatch allarmi, consulta i seguenti argomenti.
**Topics**
+ [Configurazione di un CloudWatch allarme da creare OpsItems (console)](OpsCenter-creating-or-editing-existing-alarm-console.md)
+ [Configurazione di un CloudWatch allarme esistente da creare OpsItems (a livello di codice)](OpsCenter-configuring-an-existing-alarm-programmatically.md)
# Configurazione di un CloudWatch allarme da creare OpsItems (console)
Puoi creare manualmente un allarme o aggiornare un allarme esistente OpsItems da creare da Amazon CloudWatch.
**Per creare un CloudWatch allarme e configurare Systems Manager come bersaglio di tale allarme**
1. Completa i passaggi da 1 a 9 come specificato in [Creare un CloudWatch allarme basato su una soglia statica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) nella *Amazon CloudWatch User Guide*.
1. Nella sezione **Azione Systems Manager**, scegli **Aggiungi OpsCenter azione Systems Manager**.
1. Scegli **OpsItems**.
1. Per **Gravità**, scegli un valore da 1 a 4.
1. (Facoltativo) Per **Categoria**, scegli una categoria per l'OpsItem.
1. Completa i passaggi da 11 a 13 come specificato in [Creare un CloudWatch allarme basato su una soglia statica](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/ConsoleAlarms.html) nella *Amazon CloudWatch User Guide*.
1. Scegli **Next (Successivo)** e completa la procedura guidata.
**Per modificare un allarme esistente e configurare Systems Manager come destinazione di quell'allarme**
1. Apri la CloudWatch console all'indirizzo. [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/)
1. Nel pannello di navigazione, seleziona **Alarms** (Allarmi).
1. Seleziona l'allarme, quindi scegli **Actions (Operazioni)**, **Edit (Modifica)**.
1. (Facoltativo) Modifica le impostazioni nelle sezioni **Metrics (Parametri)** e **Conditions (Condizioni)**, quindi scegli **Next (Successivo)**.
1. Nella sezione **Systems Manager**, scegli l'operazione **Add Systems Manager OpsCenter (Aggiungi Systems Manager )**.
1. Per **Severity (Gravità)** scegli un numero.
**Nota**
La gravità è un valore definito dall'utente. L'utente o la propria organizzazione determinano il significato di ogni valore di gravità e qualsiasi accordo sui livelli di servizio associato a ogni gravità.
1. (Facoltativo) Per **Category (Categoria)**, scegliere un'opzione.
1. Scegli **Next (Successivo)** e completa la procedura guidata.
# Configurazione di un CloudWatch allarme esistente da creare OpsItems (a livello di codice)
Puoi configurare gli CloudWatch allarmi Amazon per crearli a OpsItems livello di codice utilizzando AWS Command Line Interface (AWS CLI), AWS CloudFormation modelli o Java frammenti di codice.
**Topics**
+ [Prima di iniziare](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin)
+ [Configurazione degli CloudWatch allarmi da creare OpsItems ()AWS CLI](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-manually-configure-cli)
+ [Configurazione degli CloudWatch allarmi per creare o aggiornare OpsItems () CloudFormation](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-CloudFormation)
+ [Configurazione degli CloudWatch allarmi per creare o aggiornare OpsItems () Java](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-programmatically-configure-java)
## Prima di iniziare
Se modifichi a livello di programmazione un allarme esistente o crei un allarme che crea OpsItems, devi specificare un nome della risorsa Amazon (ARN). Questo ARN identificherà Systems Manager OpsCenter come obiettivo per la creazione di OpsItems dall'allarme. È possibile personalizzare l'ARN in modo che OpsItems creati dall'allarme includano informazioni specifiche quali la gravità o la categoria. Ogni ARN include le informazioni descritte nella tabella seguente.
****
| Parametro | Informazioni |
| --- | --- |
| `Region`(richiesto) | La posizione Regione AWS in cui si trova l'allarme. Ad esempio: `us-west-2`. Per informazioni su Regioni AWS dove è possibile utilizzare OpsCenter, consulta [Endpoint e quote AWS Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html). |
| `account_ID`(richiesto) | Lo stesso Account AWS ID usato per creare l'allarme. Ad esempio: `123456789012`. L'ID account deve essere seguito da due punti (`:`) e dal parametro `opsitem` come mostrato negli esempi seguenti. |
| `severity`(richiesto) | Un livello di gravità definito dall'utente per la creazione di OpsItems dall'allarme. Valori validi: `1`, `2`, `3`, `4` |
| `Category` (facoltativo) | categoria per la creazione di OpsItems dall'allarme. Valori validi: `Availability`, `Cost`, `Performance`, `Recovery` e `Security`. |
Creare l'ARN utilizzando la seguente sintassi. Questo ARN non include l'opzione di parametro `Category`.
```
arn:aws:ssm:Region:account_ID:opsitem:severity
```
Di seguito è riportato un esempio.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3
```
Per creare un ARN che utilizza l'opzione `Category` utilizzare la seguente sintassi.
```
arn:aws:ssm:Region:account_ID:opsitem:severity#CATEGORY=category_name
```
Di seguito è riportato un esempio.
```
arn:aws:ssm:us-west-2:123456789012:opsitem:3#CATEGORY=Security
```
## Configurazione degli CloudWatch allarmi da creare OpsItems ()AWS CLI
Questo comando richiede di specificare un ARN per il parametro `alarm-actions`. Per informazioni su come creare l'ARN, consulta [Prima di iniziare](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Per configurare un CloudWatch allarme da creare OpsItems ()AWS CLI**
1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.
Per informazioni, consulta la pagina [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Eseguire il seguente comando per raccogliere informazioni sull'allarme da configurare.
```
aws cloudwatch describe-alarms --alarm-names "alarm name"
```
1. Esegui il seguente comando per aggiornare un allarme. Sostituisci ogni *example resource placeholder* con le tue informazioni.
```
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
```
Ecco un esempio:
------
#### [ 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
```
------
#### [ Windows ]
```
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
```
------
## Configurazione degli CloudWatch allarmi per creare o aggiornare OpsItems () CloudFormation
Questa sezione include AWS CloudFormation modelli che è possibile utilizzare per configurare gli CloudWatch allarmi da creare o aggiornare automaticamente. OpsItems Ogni modello richiede di specificare un ARN per il parametro `AlarmActions`. Per informazioni su come creare l'ARN, consulta [Prima di iniziare](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Allarme metrico**: utilizza il seguente CloudFormation modello per creare o aggiornare un allarme CloudWatch metrico. L'allarme specificato in questo modello monitora i controlli dello stato delle istanze Amazon Elastic Compute Cloud (Amazon EC2). Se l'allarme entra nel `ALARM`, crea un OpsItem in OpsCenter.
```
{
"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"}}]
}
}
}
}
```
**Allarme composito**: utilizza il seguente CloudFormation modello per creare o aggiornare un allarme composito. Un allarme composito è costituito da più allarmi dei parametri. Se l'allarme entra nel `ALARM`, crea un OpsItem in OpsCenter.
```
"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"
}
}
}
```
## Configurazione degli CloudWatch allarmi per creare o aggiornare OpsItems () Java
Questa sezione include frammenti di Java codice che è possibile utilizzare per configurare gli CloudWatch allarmi da creare o aggiornare automaticamente. OpsItems Ogni frammento richiede di specificare un ARN per il parametro `validSsmActionStr`. Per informazioni su come creare l'ARN, consulta [Prima di iniziare](#OpsCenter-create-OpsItems-from-CloudWatch-Alarms-before-you-begin).
**Un allarme specifico**: utilizza il seguente frammento di Java codice per creare o aggiornare un avviso. CloudWatch L'allarme specificato in questo modello monitora i controlli dello stato delle istanze Amazon EC2. Se l'allarme entra nel `ALARM`, crea un OpsItem in OpsCenter.
```
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);
}
```
**Aggiorna tutti gli allarmi**: utilizza il seguente frammento di Java codice per aggiornare tutti gli CloudWatch allarmi presenti nel tuo sistema e Account AWS creare OpsItems quando un allarme entra in uno stato. `ALARM`
```
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;
}
}
}
```
# Crea OpsItems manualmente
Quando individui un problema operativo, puoi creare manualmente un OpsItem da OpsCenter, uno strumento di AWS Systems Manager, per gestire e risolvere il problema.
Se imposti OpsCenter per l'amministrazione multi-account, un amministratore delegato di Systems Manager o un account di gestione AWS Organizations possono creare OpsItems per gli account membri. Per ulteriori informazioni, consulta [(Facoltativo) Configurazione manuale di OpsCenter per la gestione centralizzata di OpsItems su più account](OpsCenter-getting-started-multiple-accounts.md).
Puoi creare OpsItems utilizzando la console AWS Systems Manager, l'AWS Command Line Interface (AWS CLI) o la AWS Tools for Windows PowerShell.
**Topics**
+ [Creazione manuale di OpsItems (console)](OpsCenter-creating-OpsItems-console.md)
+ [Creazione manuale di OpsItems (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md)
+ [Creazione manuale di OpsItems (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md)
# Creazione manuale di OpsItems (console)
Puoi creare manualmente OpsItems utilizzando la AWS Systems Manager console. Quando crei un OpsItem, viene visualizzato nell'account OpsCenter. Se imposti OpsCenter per l'amministrazione multi-account, OpsCenter fornisce all'amministratore delegato o a un account di gestione la possibilità di creare OpsItems per gli account membri selezionati. Per ulteriori informazioni, consulta [(Facoltativo) Configurazione manuale di OpsCenter per la gestione centralizzata di OpsItems su più account](OpsCenter-getting-started-multiple-accounts.md).
**Per creare un file OpsItem utilizzando la AWS Systems Manager console**
1. Apri la AWS Systems Manager console all'indirizzo [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Nel pannello di navigazione, scegli **OpsCenter**.
1. Scegli **Crea OpsItem**. Se non visualizzi questo pulsante, seleziona la scheda **OpsItems**, quindi scegli **Crea OpsItem**.
1. (Facoltativo) Scegli **Altro account**, quindi scegli l'account in cui desideri creare l'OpsItem.
**Nota**
Questo passaggio è obbligatorio se stai creando OpsItems per un account membro.
1. Per **Titolo**, immetti un nome dettagliato per aiutare a comprendere lo scopo di OpsItem.
1. Per **Origine**, inserisci il tipo di risorsa AWS coinvolta o altre informazioni sull'origine per aiutare gli utenti a comprendere l'origine di OpsItem.
**Nota**
Non è possibile modificare il campo **Origine** dopo aver creato OpsItem.
1. Per **Priorità**, scegli il livello di priorità.
1. (Facoltativo) Per **Gravità**, scegli il livello di gravità.
1. (Facoltativo) Per **Categoria**, scegli una categoria.
1. Per **Descrizione**, immetti le informazioni su questo OpsItem tra le quali (se applicabile) la procedura per riprodurre il problema.
**Nota**
La console supporta la maggior parte della formattazione dei markdown nel campo della OpsItem descrizione. Per ulteriori informazioni, consulta [Uso di Markdown nella console](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) nella *Guida introduttiva alla Console di gestione AWS *.
1. Per **Stringa di deduplicazione**, inserisci le parole che il sistema deve utilizzare per verificare la presenza di OpsItems duplicati. Per ulteriori informazioni sulle stringhe di deduplicazione, consulta [Gestione dei OpsItems duplicati](OpsCenter-working-deduplication.md).
1. (Facoltativo) Per **Notifiche**, specifica il nome della risorsa Amazon (ARN) dell'argomento Amazon SNS al quale desideri che vengano inviate le notifiche quando questo OpsItem viene aggiornato. È necessario specificare un ARN Amazon SNS che sia uguale a. Regione AWS OpsItem
1. (Facoltativo) In **Risorse correlate**, scegli **Aggiungi** per specificare l'ID o l'ARN della risorsa coinvolta e di qualsiasi risorsa correlata.
1. Scegli **Crea OpsItem**.
Se l'esito è positivo, la pagina visualizza l'OpsItem. Quando un amministratore delegato o un account di gestione crea un OpsItem per gli account membri selezionati, i nuovi OpsItems vengono visualizzati nell'OpsCenter dell'account amministratore e degli account membri. Per ulteriori informazioni su come configurare le opzioni in un OpsItem, consulta [Gestione degli OpsItems](OpsCenter-working-with-OpsItems.md).
# Creazione manuale di OpsItems (AWS CLI)
Nella procedura riportata di seguito viene descritto come creare un OpsItem tramite AWS Command Line Interface (AWS CLI).
**Per creare un file OpsItem utilizzando il AWS CLI**
1. Installa e configura AWS Command Line Interface (AWS CLI), se non l'hai già fatto.
Per informazioni, consulta la pagina [Installazione o aggiornamento della versione più recente di AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Apri AWS CLI ed esegui il seguente comando per creare unOpsItem. Sostituisci ogni *example resource placeholder* con le tue informazioni.
```
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"
```
**Specificare i dati operativi da un file**
Quando crei un OpsItem, è possibile specificare i dati operativi da un file. Il file deve essere un file JSON e i contenuti del file devono avere il formato seguente.
```
{
"key_name": {
"Type": "SearchableString",
"Value": "Up to 20 KB of data"
}
}
```
Ecco un esempio.
```
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"
```
**Nota**
Per informazioni su come immettere parametri in formato JSON sulla riga di comando in diversi sistemi operativi locali, consulta [Utilizzo di virgolette con stringhe AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) nella *Guida per l'utente di AWS Command Line Interface *.
Il sistema restituisce informazioni simili alle seguenti.
```
{
"OpsItemId": "oi-1a2b3c4d5e6f"
}
```
1. Esegui questo comando per visualizzare i dettagli sull'OpsItem che hai creato.
```
aws ssm get-ops-item --ops-item-id ID
```
Il sistema restituisce informazioni simili alle seguenti.
```
{
"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. Eseguire il seguente comando per aggiornare OpsItem. Questo comando modifica lo stato da `Open` (predefinito) a `InProgress`.
```
aws ssm update-ops-item --ops-item-id ID --status InProgress
```
Il comando non ha output.
1. Esegui nuovamente il seguente comando per verificare che lo stato sia cambiato in `InProgress`.
```
aws ssm get-ops-item --ops-item-id ID
```
## Esempi di creazione di un OpsItem
Negli esempi seguenti viene illustrato come creare un OpsItem utilizzando il portale di gestione Linux, macOS oppure Windows Server.
**Portale di gestione Linux oppure macOS**
Il comando seguente crea un OpsItem quando un disco istanza Amazon Elastic Compute Cloud (Amazon EC2) è pieno.
```
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"
```
Il comando seguente utilizza la chiave `/aws/resources` in `OperationalData` per creare un OpsItem con una risorsa correlata ad Amazon DynamoDB.
```
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"
```
Il comando seguente utilizza la chiave `/aws/automations` in `OperationalData` per creare un OpsItem che specifica il documento `AWS-ASGEnterStandby` come runbook Automation associato.
```
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**
Il comando seguente crea un OpsItem quando un'istanza Amazon Relational Database Service (Amazon RDS) non risponde.
```
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"
```
Il comando seguente utilizza la chiave `/aws/resources` in `OperationalData` per creare un OpsItem con una risorsa correlata a un'istanza Amazon EC2.
```
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\"}}
```
Il comando seguente utilizza la chiave `/aws/automations` in `OperationalData` per creare un OpsItem che specifica il runbook `AWS-RestartEC2Instance` come runbook Automation associato.
```
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\"}}
```
# Creazione manuale di OpsItems (PowerShell)
Nella procedura riportata di seguito viene descritto come creare un OpsItem utilizzando AWS Tools for Windows PowerShell.
**Per creare un OpsItem utilizzo AWS Tools for Windows PowerShell**
1. Apri AWS Tools for Windows PowerShell ed esegui il comando seguente per specificare le tue credenziali.
```
Set-AWSCredentials –AccessKey key-name –SecretKey key-name
```
1. Esegui il comando seguente Regione AWS per impostare la PowerShell sessione.
```
Set-DefaultAWSRegion -Region Region
```
1. Per creare un nuovo OpsItem, eseguire il comando seguente. Sostituisci ogni *example resource placeholder* con le tue informazioni. Questo comando specifica un runbook di automazione di Systems Manager per la correzione di questo OpsItem.
```
$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
```
In caso di esito positivo, il comando emette l'ID del nuovo OpsItem.
L'esempio seguente specifica il nome della risorsa Amazon (ARN) di un'istanza Amazon Elastic Compute Cloud (Amazon EC2) compromessa.
```
$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
```