Crie seu próprio fluxo de trabalho

Quando os modelos não atendem às suas necessidades, a opção "Criar o seu próprio" permite que você construa um fluxo de trabalho personalizado. Utilize a interface de arrastar e soltar para encadear ações do catálogo de ações em automações que correspondam ao seu processo.

Como usar este guia

Este guia mostra como construir um fluxo de trabalho usando conceitos e um exemplo completo. Escolha seu caminho de aprendizado:

• Aprenda primeiro os conceitos básicos → Leia Conceitos básicos e Padrões de fluxo de trabalho para entender os fundamentos e, em seguida, aplique-os.

• Siga o exemplo → Acesse o passo a passo do exemplo para criar um fluxo de trabalho de redimensionamento automático do EC2 passo a passo.

• Padrões de referência → Use a seção padrões de fluxo de trabalho como uma referência rápida ao construir seu próprio fluxo de trabalho

  Dica

  Novo no fluxo de trabalho? Comece pelos conceitos básicos e depois siga o exemplo. O fluxo de trabalho do EC2 demonstra todos os padrões principais em um cenário do mundo real.

Por que construir um fluxo de trabalho personalizado?

Crie seu próprio fluxo de trabalho para:

• Implemente uma lógica de negócios exclusiva que os modelos não suportam.
• Integre vários sistemas além dos modelos padrão.
• Lide com decisões complexas com ramificação condicional.
• Combine o processo de sua equipe para aprovações e notificações

Conceitos centrais

Entenda esses fundamentos antes de construir:

Para padrões detalhados de tratamento de erros, consulte práticas recomendadas.

Começo rápido

Crie seu primeiro fluxo de trabalho em cinco etapas:

1. Acesse one.newrelic.com > All Capabilities > Workflow Automation e selecione Create Your Own.
2. Defina parâmetros para credenciais (do secrets manager: ${{ :secrets:keyName }}), configuração (regiões, tipo de instância) e dados de tempo de execução (IDs de conta, IDs de alerta)
3. Arraste ações do catálogo e conecte-as com a sintaxe ${{ .steps.stepName.outputs.field }} para passar dados.
4. Insira interruptores para ramificação condicional, loops para processamento de listas ou polling, e portões de aprovação para decisões humanas.
5. Execute o comando após cada seção para detectar erros precocemente e, em seguida, inicie ou agende seu fluxo de trabalho.

Padrões de fluxo de trabalho principais

Quatro padrões essenciais abrangem a maioria dos cenários de automação. Cada padrão é demonstrado no exemplo passo a passo abaixo.

Ramificação condicional com interruptores

Utilize os interruptores quando: Os resultados variam de acordo com os dados (verificações de limite, respostas da API, decisões do usuário)

Sintaxe da tecla:

- name: hasCompleted
  type: switch
  switch:
    - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Failed' }}"
      next: displayError
    - condition: "${{ .steps.waitForCompletion.outputs.automationExecutionStatus == 'Success' }}"
      next: displaySuccess
  next: displayUnexpected  # Default path when no condition matches

Veja em ação: Gerencie a resposta da equipe e verifique e limpe as seções que mostram o roteamento de switches com base nas reações do Slack e no status do AWS SSM.

Loops para processar listas

Utilize loops quando: estiver processando vários itens ou repetindo ações.

Sintaxe da tecla:

# Send progress updates using range loop
- name: progressLoop
  type: loop
  for:
    in: "${{ [range(1; 5)] }}"  # Loop 5 times
    steps:
      - name: wait
        type: wait
        seconds: 10
      - name: progressMessage
        type: action
        action: slack.chat.postMessage
        version: 1
        inputs:
          channel: "${{ .workflowInputs.channel }}"
          text: "Resizing in progress..."

Veja em ação: Execute a seção de redimensionamento que usa progressLoop para atualizações de status.

Portarias de aprovação e espera

Utilize portões de aprovação quando: for necessário julgamento humano antes de operações destrutivas ou quando for exigida a aprovação de conformidade.

Sintaxe da tecla:

- name: requestApproval
  type: action
  action: slack.chat.postMessage
  version: 1
  inputs:
    channel: "#approvals"
    text: "Approve? React with :thumbsup: or :thumbsdown:"

- name: getReactions
  type: action
  action: slack.chat.getReactions
  version: 1
  inputs:
    token: "${{ .workflowInputs.slackToken }}"
    channelID: "${{ .steps.requestApproval.outputs.channelID }}"
    threadTs: "${{ .steps.requestApproval.outputs.threadTs }}"
    timeout: 300  # Wait 5 minutes for reaction

- name: checkApproval
  type: switch
  switch:
    - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "+1") }}'
      next: handleApproval
    - condition: '${{ .steps.getReactions.outputs.reactions | any(.name == "-1") }}'
      next: handleRejection

Para atrasos simples:

- name: waitBeforeRetry
  type: wait
  seconds: 60  # Wait 60 seconds before continuing

Veja na prática: a seção "Solicitar aprovação da equipe" implementa o fluxo de trabalho completo de aprovação do Slack.

Passando dados entre etapas

Utilize a passagem de dados quando: a saída de uma etapa se torna a entrada de outra (o fundamento de todo fluxo de trabalho).

Sintaxe da tecla:

# Reference previous step outputs
awsRegion: "${{ .inputs.region }}"
instanceId: "${{ .steps.getAlert.outputs.data.entity.instanceId }}"

Veja na prática: Todas as seções demonstram a transferência de dados — cada etapa se baseia nos resultados anteriores.

Exemplo passo a passo: Redimensionamento automático de instâncias EC2 com aprovação

Este exemplo completo demonstra como construir um fluxo de trabalho que redimensiona automaticamente instâncias do EC2 quando há picos de uso da CPU — após obter a aprovação da equipe via Slack. Este vídeo demonstra a coleta de dados, a lógica condicional, a integração externa e o tratamento de erros em um cenário do mundo real.

Pré-requisitos

Antes de criar este fluxo de trabalho, certifique-se de ter:

• AWS: Credenciais com permissões do EC2 e do Systems Manager
• Slack: token de bot e canal para notificação
• New Relic: condição de alerta de monitoramento EC2 CPU
• Gerenciador de segredos: Configurado (consulte gerenciamento de segredos)

Visão geral do fluxo de trabalho

Fluxo de alto nível:

1. Coletar dados: Obter detalhes de alertas e instâncias do New Relic
2. Solicitar aprovação: Envie uma mensagem no Slack e aguarde a resposta da equipe.
3. Executar redimensionamento: Use AWS Systems Manager para redimensionar instâncias do EC2.
4. Verificar e limpar: Verificar resultados, notificar a equipe, remover recursos temporários.

Este exemplo demonstra padrões importantes que você usará em fluxos de trabalho personalizados: consultas a APIs, ramificação condicional, integração externa, loops de polling e tratamento de erros.

Entradas do fluxo de trabalho

Este fluxo de trabalho requer credenciais, configuração e contexto de tempo de execução como entradas. Os valores sensíveis vêm do gerenciador de segredos usando a sintaxe ${{ :secrets:keyName }}.

Categorias de entrada:

• Autenticação: credenciais da AWS e do Slack obtidas no gerenciador de segredos.
• Contexto do alerta: ID da conta e ID do problema do New Relic
• Configuração: região, tipo de instância, fuso horário, canal Slack

Construa o fluxo de trabalho passo a passo.

Agora vamos construir cada parte do fluxo de trabalho. Cada etapa inclui as ações específicas a serem adicionadas e os padrões de fluxo de trabalho que elas demonstram.

Próximos passos

Executar e gerenciar

• Iniciar e agendar fluxo de trabalho: Acionar manualmente ou agendar automaticamente.
• Gerenciando o fluxo de trabalho: edite, versione, clone ou desative o fluxo de trabalho.

Melhorar

• práticas recomendadas: Tratamento de erros, gerenciamento de segredos, desempenho, testes.
• Catálogo de ações: AWS, Azure, GCP, HTTP, transformações de dados.
• Exemplos de fluxo de trabalho: Mais cenários de automação do mundo real.

Escala

• fluxo de trabalho APIs de automação: implantar via API para infraestrutura como código.
• Limitações do fluxo de trabalho: tempos limite, limites de ações, restrições de carga útil.