Trabalhar com o OpsItems - AWS Systems Manager

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Trabalhar com o OpsItems

Esta seção descreve como configurar as opções disponíveis em uma OpsItem. Para obter informações sobre como criar OpsItems, consulte Criar OpsItems.

Um recurso relacionado é o recurso afetado (o recurso que precisa ser investigado ou o recurso que acionou o evento do Amazon EventBridge que criou o OpsItem). Cada OpsItem tem uma seção Related resources (Recursos relacionados). Se o EventBridge criar o OpsItem, o sistema preenche automaticamente o OpsItem com o nome de recurso da Amazon (ARN) do recurso. Você também pode especificar manualmente ARNs de recursos relacionados. Para alguns tipos de ARN, OpsCenter cria automaticamente um deep link que exibe detalhes sobre o recurso sem a necessidade de visitar outras páginas do console para visualizar essas informações. Por exemplo, você pode especificar o ARN de uma instância do EC2. Em OpsCenter, você pode visualizar todos os detalhes fornecidos pelo Amazon EC2 sobre essa instância. Para visualizar uma lista dos tipos de recurso que criam automaticamente deep links para recursos relacionados, consulte Referência de recursos compatíveis.

nota

Você pode adicionar manualmente o ARNs de recursos relacionados adicionais. Cada OpsItem pode listar um máximo de 100 recursos relacionados ARNs.

Para visualizar e adicionar recursos relacionados

  1. Abrir o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, selecione OpsCenter.

  3. Escolha a guia OpsItems.

  4. Escolha um ID da OpsItem.

    
                            Uma nova OpsItem na página de visão geral daOpsCenter
  5. Para visualizar informações sobre o recurso afetado, escolha a guia Related resources details (Detalhes de recursos relacionados).

    
                            Visualizar a guia Related Resources (Recursos relacionados) para um OpsItem do

    Essa guia exibe informações sobre o recurso de vários serviços da AWS. Expanda a seção Resource details (Detalhes do recurso) para visualizar informações sobre esse recurso, conforme fornecido pelo serviço da AWS que o hospeda. Você também pode alternar entre outros recursos relacionados associados a esse OpsItem usando a lista Related resources (Recursos relacionados).

  6. Para adicionar recursos relacionados adicionais, escolha a guia Overview (Visão geral).

  7. Na seção Related resources (Recursos relacionados), escolha Add (Adicionar).

  8. Em Resource type (Tipo de recurso), escolha um recurso na lista.

  9. Em Resource ID (ID do recurso), insira o ID ou o nome de recurso da Amazon (ARN). O tipo de informação escolhido depende do recurso escolhido na etapa anterior.

Editar detalhes do OpsItem

A seção Detalhes do OpsItem inclui informações sobre o , incluindo a descrição, o título, a origem, o ID da OpsItem e o status, entre outras.OpsItem


                    Visualizar detalhes no console sobre umOpsItem

Em OpsItems criados automaticamente, Amazon EventBridge preenche os campos Title (Título), Source (Origem) e Description (Descrição). Você pode editar os campos Title (Título) e Description (Descrição), mas não o campo Source (Origem).

Sobre o status da OpsItem

Ao editar uma OpsItem, você pode especificar um status. A lista Status inclui as seguintes opções:

Status Detalhes
Aberto

Ativo no sistema, mas não trabalhado por um engenheiro.

Em andamento

Ativo no sistema e trabalhado por um engenheiro.

Resolvido

Não ativo no sistema, mas disponível em Pesquisar e ao usar o filtro Resolved (Resolvido) na página OpsItem Overview (Visão geral). Você pode editar uma OpsItem resolvida para alterar o status como Open (Aberto) ou In progress (Em andamento).

Você pode visualizar relatórios sobre status da OpsItem na guia Summary (Resumo). Para obter mais informações, consulte Visualizar relatórios de resumo do OpsCenter.

Sobre a prioridade da OpsItem

Ao editar uma OpsItem, você pode escolher uma prioridade para essa OpsItem escolhendo um valor entre 1 e 5. Recomendamos que a organização determine o que cada nível de prioridade significa e um acordo de nível de serviço correspondente para cada.

Sobre o campo de notificações

Ao editar uma OpsItem, você pode especificar o ARN de um tópico do Amazon SNS no campo Notifications (Notificações). Ao especificar um ARN, você garante que todas as partes interessadas recebam uma notificação quando a OpsItem é editada, inclusive uma alteração de status. Pode ser útil criar ARNs diferentes para notificações sobre tipos diferentes de recursos da AWS ou ambientes diferentes. O tópico do Amazon SNS deve existir na mesma região da AWS que o OpsItems. Se estiverem em regiões diferentes, o sistema retornará um erro. Para obter mais informações, consulte o Guia do desenvolvedor do Amazon Simple Notification Service.

Importante

O tópico do SNS deve existir na mesma região da AWS do OpsItem. Se eles estiverem em regiões diferentes, o sistema retornará um erro.

Para editar detalhes da OpsItem

  1. Abrir o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, selecione OpsCenter.

  3. Escolha um ID da OpsItem para abrir a página de detalhes.

  4. Na seção OpsItem details (Detalhes do ACS), escolha Edit (Editar).

  5. Edite os detalhes da OpsItem de acordo com os requisitos e as diretrizes especificados pela organização.

  6. Quando terminar, escolha Salvar.

Trabalhar com OpsItems relacionados e semelhantes

Os recursos de OpsItem relacionados e semelhantes foram projetados para ajudar a investigar problemas de operações ao contextualizar o escopo de um problema. Na seção Related OpsItems, você pode especificar um máximo de 10 IDs para outros OpsItems relacionados ao OpsItem atual. Os OpsItems podem ser relacionados de diferentes maneiras, incluindo uma relação pai-filho entre o OpsItems, uma causa raiz ou uma duplicada.


                    Visualizar OpsItems relacionados.

O recurso Similar OpsItems (OIS semelhantes) é uma lista de OpsItems gerada pelo sistema que podem estar relacionadas ou sejam de seu interesse. Para gerar a lista, o sistema examina os títulos e as descrições de todas as OpsItems e retorna OpsItems que usam as palavras semelhantes.


                    Visualizar OpsItems semelhantes.

Como adicionar um OpsItem relacionado de OpsItems semelhantes

  1. Abrir o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, selecione OpsCenter.

  3. Escolha um ID da OpsItem para abrir a página de detalhes.

  4. Na seção Related OpsItem (OI relacionada), escolha Add (Adicionar).

  5. Em OpsItem ID (ID da OI), especifique um ID.

  6. Escolha Adicionar.

Trabalhar com dados operacionais

Dados operacionais são dados personalizados que dão detalhes de referência útil sobre a OpsItem. Por exemplo, você pode especificar arquivos de log, strings de erro, chaves de licença, dicas para solução de problemas ou outros dados relevantes. Você insere dados operacionais como pares de chave/valor. A chave tem um tamanho máximo de 128 caracteres. O valor tem um tamanho máximo de 20 KB. Você pode inserir vários pares de chave-valor de dados operacionais.

Importante

Chaves de dados operacionais não podem começar com o seguinte: amazon, aws, amzn, ssm, /amazon, /aws, /amzn, /ssm.


                    Visualizar dados operacionais para um OpsItem.

Você pode optar por tornar os dados pesquisáveis por outros usuários na conta ou restringir o acesso de pesquisa. Dados pesquisáveis significa que todos os usuários com acesso à página de visão geral do OpsItem (conforme fornecido pela ação de API DescribeOpsItems) podem visualizar e pesquisar nos dados especificados. Dados operacionais que não são pesquisáveis só podem ser visualizados por usuários que tenham acesso ao OpsItem (conforme fornecido pela ação de API GetOpsItem).

Para adicionar dados operacionais a uma OpsItem

  1. Abrir o console do AWS Systems Manager em https://console.aws.amazon.com/systems-manager/.

  2. No painel de navegação, selecione OpsCenter.

  3. Escolha um ID da OpsItem para abrir a página de detalhes.

  4. Expanda um dos Operational data (Dados operacionais).

  5. Se não houver dados operacionais para a OpsItem, escolha Add (Adicionar). Se já houver dados operacionais para a OpsItem, escolha Manage (Gerenciar).

  6. Em Key (Chave), especifique uma palavra ou palavras para ajudar usuários a entender a finalidade dos dados. A chave não pode começar com o seguinte: amazon, aws, amzn, ssm, /amazon, /aws, /amzn, /ssm.

  7. Em Value (Valor), especifique os dados.

  8. Escolha Save (Salvar).

Depois de criar dados operacionais, você poderá editar a chave e o valor, remover os dados operacionais ou adicionar pares de chave-valor adicionais escolhendo Manage (Gerenciar).

nota

Você pode filtrar OpsItems usando o operador Operational data (Dados operacionais) na página do OpsItems. Na caixa de pesquisa, escolha Operational data (Dados operacionais) e insira um par de chave-valor no JSON. É necessário inserir o par de chave-valor usando o seguinte formato: {"key":"key_name","value":"a_value"}

Reduzir OpsItems duplicados

OpsCenter usa uma combinação de lógica integrada e strings de desduplicação configuráveis para ajudar a evitar a criação de OpsItems duplicadas. A lógica integrada de desduplicação é aplicada sempre que a ação de API CriarOpsItem é chamada. Ao criar o OpsItem, o Systems Manager cria e armazena um hash baseado na string de desduplicação e no recurso que iniciou o OpsItem. Quando uma solicitação é feita para criar um novo OpsItem, o sistema verifica a string de desduplicação da nova solicitação. Se existir um hash correspondente para essa string de desduplicação, o Systems Manager não criará um novo OpsItem.

Observe as seguintes informações sobre OpsCenter e desduplicação:

  • As strings de desduplicação não fazem distinção entre maiúsculas e minúsculas. Se o sistema encontrar um hash correspondente baseado em uma string de desduplicação em uma OpsItem de entrada, independentemente da capitalização da string de desduplicação, a nova OpsItem não será criada.

  • Se o sistema encontrar uma string de desduplicação correspondente em uma OpsItem e essa OpsItem tiver um status de Open/InProgress, a nova OpsItem não será criada. Se uma string de desduplicação correspondente for encontrada em uma OpsItem com um status de Resolved, o sistema criará uma nova OpsItem.

  • Se o sistema encontrar uma string de desduplicação correspondente em uma OpsItem, mas os recursos forem diferentes, o sistema criará a nova OpsItem.

  • Se nenhuma string de desduplicação for especificada para uma OpsItem de entrada, a OpsItem será sempre criada.

Configurar strings de desduplicação

OpsCenter inclui as opções a seguir para configurar strings de duplicação.

  • Editar strings de desduplicação pré-configuradas: Cada uma das regras do OpsItem padrão EventBridge inclui uma string de desduplicação pré-configurada. Você pode editar essas strings de desduplicação no EventBridge.

  • Especificar manualmente strings de desduplicação: Você pode inserir uma string de desduplicação usando o campo Deduplication string (String de desduplicação) no console ou o parâmetro OperationalData ao criar um novo OpsItem usando a AWS CLI ou o AWS Tools para Windows PowerShell.

Depois de criar um OpsItem, o sistema preencherá o campo Deduplication string (String de desduplicação), se uma string tiver sido especificada. Aqui está um exemplo.


                        Visualizar uma entrada de desduplicação da OpsItem no Console de Gerenciamento da AWS

Depois de criar um OpsItem, não será possível editar ou alterar as strings de desduplicação nesse OpsItem.

Esta seção inclui os procedimentos a seguir para configurar strings de desduplicação.

nota

Para obter informações sobre como inserir strings de desduplicação ao criar manualmente um OpsItem no console, consulte Criar OpsItems manualmente.

Editar uma string de desduplicação em uma regra padrão do EventBridge do OpsCenter

Use o procedimento a seguir para especificar uma string de desduplicação para uma regra do EventBridge direcionada ao OpsCenter.

Para editar uma string de desduplicação em uma regra do EventBridge padrão da OpsItem

  1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, selecione Rules (Regras).

  3. Escolha uma regra e escolha Edit (Editar).

  4. Na seção Select targets (Selecionar destinos), expanda Configure input (Configurar entrada). No campo Input transformer (Transformador de entrada) inferior, localize a entrada JSON "operationalData": { "/aws/dedup" e as strings de desduplicação que você deseja editar.

    A entrada da string de desduplicação em regras do EventBridge usa o formato JSON a seguir.

    "operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"Words the system should use to check for duplicate OpsItems\"}"}}

    Aqui está um exemplo.

    "operationalData": { "/aws/dedup": {"type": "SearchableString","value": "{\"dedupString\":\"SSMOpsCenter-EBS-volume-performance-issue\"}"}}
  5. Edite as strings de desduplicação e escolha Update (Atualizar) para concluir a atualização da regra.

Especificar uma string de desduplicação usando a AWS CLI

Você pode especificar uma string de desduplicação ao criar manualmente um novo OpsItem usando a AWS CLI. Digite a string de desduplicação usando o parâmetro OperationalData. O parâmetro usa a sintaxe JSON, conforme mostrado aqui.

--operational-data '{"/aws/dedup":{"Value":"{\"dedupString\": \"Words the system should use to check for duplicate OpsItems\"}","Type":"SearchableString"}}'

Aqui está um comando de exemplo que especifica uma string de desduplicação de disk full.

Linux
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"