

• 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à.

# Crea OpsItems manualmente
<a name="OpsCenter-manually-create-OpsItems"></a>

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)
<a name="OpsCenter-creating-OpsItems-console"></a>

 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)
<a name="OpsCenter-creating-OpsItems-CLI"></a>

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
<a name="OpsCenter_creating_OpsItems-CLI_examples"></a>

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)
<a name="OpsCenter-creating-OpsItems-Powershell"></a>

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
```