• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
# Criar OpsItems manualmente
Ao encontrar um problema operacional, é possível criar um OpsItem manualmente no OpsCenter, uma ferramenta do AWS Systems Manager, para gerenciar e resolver o problema.
Se você configurar o OpsCenter para administração entre contas, um administrador delegado do Systems Manager ou uma conta de gerenciamento do AWS Organizations poderá criar OpsItems para contas de membros. Para ter mais informações, consulte [(Opcional) Configuração do OpsCenter para gerenciar OpsItems de forma centralizada entre contas](OpsCenter-getting-started-multiple-accounts.md).
É possível criar OpsItems usando o console do AWS Systems Manager, a AWS Command Line Interface (AWS CLI) ou as AWS Tools for Windows PowerShell.
**Topics**
+ [Criação de OpsItems manualmente (console)](OpsCenter-creating-OpsItems-console.md)
+ [Criação de OpsItems manualmente (AWS CLI)](OpsCenter-creating-OpsItems-CLI.md)
+ [Criação de OpsItems manualmente (PowerShell)](OpsCenter-creating-OpsItems-Powershell.md)
# Criação de OpsItems manualmente (console)
É possível criar OpsItems manualmente usando o console do AWS Systems Manager. Quando você cria um OpsItem, ele é exibido em sua conta do OpsCenter. Se você configurar o OpsCenter para administração entre contas, o OpsCenter fornecerá ao administrador delegado ou à conta de gerenciamento a opção de criar OpsItems para contas de membros selecionados. Para obter mais informações, consulte [(Opcional) Configuração do OpsCenter para gerenciar OpsItems de forma centralizada entre contas](OpsCenter-getting-started-multiple-accounts.md).
**Como criar um OpsItem usando o console do AWS Systems Manager**
1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. No painel de navegação, escolha **OpsCenter**.
1. Escolha **CreateOpsItem** (Criar OpsItem). Se este botão não for exibido, escolha **OpsItems** e, em seguida, escolha **CreateOpsItem** (Criar).
1. (Opcional) Escolha **Outra conta** e, em seguida, selecione a conta na qual você deseja criar o OpsItem.
**nota**
Esta etapa será necessária se você estiver criando OpsItems para uma conta de membro.
1. Em **Title (Título)**, insira um nome descritivo para ajudar a compreender a finalidade do OpsItem.
1. Em **Source** (Origem), insira o tipo de recurso da AWS afetado ou outras informações de origem para ajudar usuários a compreender a origem do OpsItem.
**nota**
Você não poderá editar o campo **Source (Origem)** depois de criar a OpsItem.
1. Em **Priority (Prioridade)**, escolha o nível de prioridade.
1. (Opcional) Em **Severity** (Gravidade), escolha o nível de gravidade.
1. (Opcional) Em **Category** (Categoria), escolha uma categoria.
1. Em **Description (Descrição)**, insira informações sobre esse OpsItem, inclusive (se aplicáveis) etapas para reproduzir o problema.
**nota**
O console oferece suporte à maior parte da formatação de markdown no campo de descrição do OpsItem. Para obter mais informações, consulte [Usar o Markdown no console](https://docs.aws.amazon.com/awsconsolehelpdocs/latest/gsg/aws-markdown.html) no *Guia de conceitos básicos do Console de gerenciamento da AWS*.
1. Em **String de eliminação de duplicação**, insira palavras que o sistema pode usar para verificar se há OpsItems duplicados. Para obter mais informações sobre strings de desduplicação, consulte [Gerenciamento de OpsItems duplicados](OpsCenter-working-deduplication.md).
1. (Opcional) Em **Notificações**, especifique o nome do recurso da Amazon (ARN) do tópico do Amazon SNS para o qual você deseja que as notificações sejam enviadas quando esse OpsItem for atualizado. Você deve especificar um ARN do Amazon SNS que esteja na mesma Região da AWS em que a OpsItem.
1. (Opcional) Em **Recursos relacionados**, escolha **Adicionar** para especificar o ID ou o ARN do recurso afetado e quaisquer recursos relacionados.
1. Escolha **CreateOpsItem** (Criar OpsItem).
Se tiver êxito, a página exibirá o OpsItem. Quando um administrador delegado ou uma conta de gerenciamento cria um OpsItem para contas de membros selecionados, os novos OpsItems são exibidos no OpsCenter das contas de administrador e de membros. Para obter informações sobre como configurar as opções em um OpsItem, consulte [Gerenciamento de OpsItems](OpsCenter-working-with-OpsItems.md).
# Criação de OpsItems manualmente (AWS CLI)
O procedimento a seguir descreve como criar um OpsItem usando a AWS Command Line Interface (AWS CLI).
**Como criar um OpsItem usando a AWS CLI**
1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito.
Para obter informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
1. Abra a AWS CLI e execute o comando a seguir para criar uma OpsItem. Substitua cada *espaço reservado para recurso de exemplo* por suas próprias informações.
```
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"
```
**Especificar dados operacionais de um arquivo**
Ao criar uma OpsItem, você pode especificar dados operacionais de um arquivo. O arquivo deve ser um arquivo JSON e o conteúdo do arquivo deve usar o formato a seguir.
```
{
"key_name": {
"Type": "SearchableString",
"Value": "Up to 20 KB of data"
}
}
```
Aqui está um exemplo.
```
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**
Para obter informações sobre como inserir parâmetros formatados em JSON na linha de comando em diferentes sistemas operacionais locais, consulte [Uso de aspas com strings na AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-parameters-quoting-strings.html) no *Guia do usuário da AWS Command Line Interface*.
O sistema retorna informações como estas.
```
{
"OpsItemId": "oi-1a2b3c4d5e6f"
}
```
1. Execute o comando a seguir para visualizar detalhes sobre o OpsItem que você criou.
```
aws ssm get-ops-item --ops-item-id ID
```
O sistema retorna informações como estas.
```
{
"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. Execute o comando a seguir para atualizar a OpsItem. Esse comando altera o status de `Open` (o padrão) para `InProgress`.
```
aws ssm update-ops-item --ops-item-id ID --status InProgress
```
O comando não tem uma saída.
1. Execute o comando a seguir novamente para verificar se o status foi alterado para `InProgress`.
```
aws ssm get-ops-item --ops-item-id ID
```
## Exemplos de criação de um OpsItem
Os exemplos de código a seguir mostram como criar um OpsItem usando o portal de gerenciamento do Linux, macOS ou Windows Server.
**Portal de gerenciamento do Linux ou macOS**
O comando a seguir cria um OpsItem quando um disco de instância do Amazon Elastic Compute Cloud (Amazon EC2) está cheio.
```
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"
```
O comando a seguir usa a chave `/aws/resources` em `OperationalData` para criar um OpsItem com um recurso relacionado ao 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"
```
O comando a seguir usa a chave `/aws/automations` em `OperationalData` para criar um OpsItem que especifica o documento `AWS-ASGEnterStandby` como um runbook do Automation associado.
```
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**
O comando a seguir cria um OpsItem quando uma instância do Amazon Relational Database Service (Amazon RDS) não está respondendo.
```
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"
```
O comando a seguir usa a chave `/aws/resources` em `OperationalData` para criar um OpsItem com um recurso relacionado à instância do 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\"}}
```
O comando a seguir usa a chave `/aws/automations` em `OperationalData` para criar um OpsItem que especifica o runbook `AWS-RestartEC2Instance` como um runbook do Automation associado.
```
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\"}}
```
# Criação de OpsItems manualmente (PowerShell)
O procedimento a seguir descreve como criar um OpsItem usando as AWS Tools for Windows PowerShell.
**Como criar um OpsItem usando as AWS Tools for Windows PowerShell**
1. Abra o AWS Tools for Windows PowerShell e execute o seguinte comando para especificar suas credenciais.
```
Set-AWSCredentials –AccessKey key-name –SecretKey key-name
```
1. Execute o comando a seguir para definir a Região da AWS para sua sessão do PowerShell.
```
Set-DefaultAWSRegion -Region Region
```
1. Execute o comando a seguir para criar um novo OpsItem. Substitua cada *espaço reservado para recurso de exemplo* por suas próprias informações. Este comando especifica um runbook de automação do Systems Manager para corrigir esse 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
```
Se for bem-sucedido, o comando mostrará o ID do novo OpsItem.
O exemplo a seguir especifica o nome do recurso da Amazon (ARN) de uma instância comprometida do Amazon Elastic Compute Cloud (Amazon EC2).
```
$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
```