

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

# Usar a experiência de design visual
<a name="visual-designer-use"></a>

Aprenda a criar, editar e executar fluxos de trabalho do runbook usando a experiência de design visual. Depois que seu fluxo de trabalho estiver pronto, você poderá salvá-lo ou exportá-lo. Você também pode usar a experiência de design visual para prototipagem rápida. 

## Criar um runbook
<a name="visual-designer-create-runbook-workflow"></a>

1. Faça login no [console do Systems Manager Automation](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/).

1. Escolha **Criar runbook**.

1. Na caixa **Nome**, insira um nome para o runbook, por exemplo, `{{MyNewRunbook}}`.

1. Ao lado do botão **Design** e **Código**, selecione o ícone de lápis e insira um nome para o seu runbook.

Agora você pode criar um fluxo de trabalho para seu novo runbook.

## Desenvolver um runbook
<a name="visual-designer-build"></a>

 Para criar um fluxo de trabalho de runbook usando a experiência de design visual, arraste uma ação de automação do navegador **Ações** para a tela, colocando-a onde desejar no fluxo de trabalho do seu runbook. Você também pode reordenar as ações em seu fluxo de trabalho arrastando-as para um local diferente. Quando você arrasta uma ação para a tela, uma linha aparece nos locais em que é possível soltar a ação no fluxo de trabalho. Após uma ação ser colocada na tela, seu código é gerado automaticamente e adicionado ao conteúdo do seu runbook.

Se você souber o nome da ação que deseja adicionar, use a caixa de pesquisa na parte superior do navegador **Ações** para encontrá-la.

Depois de soltar uma ação na tela, configure-a usando o painel **Formulário** à direita. Esse painel contém as guias **Geral**, **Entradas**, **Saídas** e **Configuração** para cada ação de automação ou ação de API que você coloca na tela. Por exemplo, a guia **Geral** consiste nas seguintes seções:
+ O **Nome da etapa** identifica a etapa. Especifique um valor exclusivo para o nome da etapa.
+ A **Descrição** ajuda você a descrever o que a ação está fazendo no fluxo de trabalho do seu runbook.

A guia **Entradas** contém campos que variam com base na ação. Por exemplo, a ação de automação `aws:executeScript` consiste nas seguintes seções:
+ O **Runtime** é a linguagem que será usada para executar o script fornecido.
+ O **Manipulador** é o nome da sua função. É necessário garantir que a função definida no manipulador tenha dois parâmetros: `events` e `context`. O runtime do PowerShell não é compatível com este parâmetro. 
+ O **Script** é um script incorporado que você deseja executar durante o fluxo de trabalho.
+ (Opcional) O **Anexo** é para scripts autônomos ou arquivos.zip que podem ser invocados pela ação. Esse parâmetro é obrigatório para runbooks JSON.

A guia **Saídas** ajuda a especificar os valores que você deseja gerar de uma ação. Você pode referenciar valores de saída em ações posteriores do seu fluxo de trabalho ou gerar resultados de ações para fins de registro. Nem todas as ações terão uma guia **Saídas** porque nem todas as ações oferecem suporte a saídas. Por exemplo, a ação `aws:pause` não aceita saídas. Para ações que oferecem suporte a saídas, a guia **Saídas** consiste nas seguintes seções:
+ O **Nome** é o nome a ser usado para o valor de saída. Você pode referenciar saídas em ações posteriores do seu fluxo de trabalho.
+ O **Seletor** é uma string de expressão JSONPath que começa com `"$."` e é usada para selecionar um ou mais componentes em um elemento JSON.
+ O **Tipo** é o tipo de dados para o valor de saída. Por exemplo, o tipo de dados `String` ou `Integer`.

A guia **Configuração** contém propriedades e opções que todas as ações de automação podem usar. A ação consiste nas seguintes seções:
+ A propriedade **Máximo de tentativas** é o número tentativas de executar uma ação em caso de falha.
+ A propriedade **Tempo limite em segundos** especifica o valor do tempo limite para uma ação.
+ A propriedade **É crítica** determina se a falha na ação interrompe toda a automação.
+ A propriedade **Próxima etapa** determina qual ação a automação executará em seguida no runbook.
+ A propriedade **Em falha** determina qual ação a automação executará em seguida no runbook se a ação falhar.
+ A propriedade **Em cancelamento** determina qual ação a automação executará em seguida no runbook se a ação for cancelada por um usuário.

Para excluir uma ação, você pode usar o backspace, a barra de ferramentas acima da tela ou clicar com o botão direito do mouse e escolher **Excluir ação**.

À medida que seu fluxo de trabalho cresce, ele pode não caber na tela. Para ajudar a ajustar o fluxo de trabalho à tela, tente uma das opções a seguir: 
+ Use os controles nos painéis laterais para redimensionar ou fechar os painéis.
+ Use a barra de ferramentas na parte superior da tela para ampliar ou reduzir o gráfico do fluxo de trabalho.

## Atualizar seu runbook
<a name="visual-designer-update-runbook"></a>

Você pode atualizar um fluxo de trabalho de runbook existente criando uma nova versão do seu runbook. As atualizações em seus runbooks podem ser feitas usando a experiência de design visual ou editando o código diretamente. Para atualizar um runbook existente, use o procedimento a seguir:

1. Faça login no [console do Systems Manager Automation](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/).

1. Escolha o runbook que deseja atualizar.

1. Escolha **Create new version (Criar nova versão)**.

1. A experiência de design visual tem dois painéis: um painel de código e um painel de fluxo de trabalho visual. Escolha **Design** no painel de fluxo de trabalho visual para editar seu fluxo de trabalho com a experiência de design visual. Ao concluir, escolha **Criar nova versão** para salvar as alterações e sair.

1. (Opcional) Use o painel de código para editar o conteúdo do runbook em YAML ou JSON.

## Exportar seu runbook
<a name="visual-designer-export-runbook"></a>

Para exportar o código YAML ou JSON do fluxo de trabalho do seu runbook e também um gráfico do seu fluxo de trabalho, use o procedimento a seguir: 

1. Escolha seu runbook no console **Documentos**.

1. Escolha **Create new version (Criar nova versão)**.

1. No menu suspenso **Ações**, escolha se você deseja exportar o gráfico ou o runbook, além do formato preferido.