Crie seu próprio fluxo de trabalho

Crie fluxos de trabalho personalizados do zero quando os modelos não atenderem às suas necessidades. Use o construtor crie o seu próprio para arrastar e soltar ações do catálogo de ações em uma automação que corresponda 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 os conceitos principais primeiro: Leia Conceitos principais 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 referência rápida ao criar seus próprios fluxos de trabalho

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:

Exemplos de sintaxe

Use estes padrões ao criar fluxos de trabalho:

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

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 gerenciador de segredos: ${{ :secrets:keyName }}), configuração (regiões, tipos de instância) e dados de tempo de execução (IDs de conta, IDs de alerta)
3. Arraste ações do catálogo, conecte-as com a sintaxe ${{ .steps.stepName.outputs.field }} para passar dados
4. Insira switches para ramificação condicional, loops para processamento de listas ou polling, gates de aprovação para decisões humanas
5. Execute após cada seção para detectar erros antecipadamente, depois inicie ou agende seu fluxo de trabalho

Padrões de fluxo de trabalho principais

Quatro padrões essenciais lidam com a maioria dos cenários de automação. Cada padrão é demonstrado no passo a passo de exemplo 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

Exemplo: Tratar a resposta da equipe, Verificar e limpar

Loops para processar listas

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

Para obter informações detalhadas sobre a estrutura de loop, parâmetros e uso avançado (incluindo break/continue), consulte Estrutura de loop.

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

Exemplo: Executar o redimensionamento

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

Exemplo: Solicitar aprovação da equipe

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

Exemplo: Todas as etapas do fluxo de trabalho

Atribuição de variável com assign

O tipo de etapa de atribuição permite que você inicialize e atribua valores a variáveis que podem ser usadas em etapas subsequentes do fluxo de trabalho. Esta etapa suporta vários tipos de dados, incluindo strings, inteiros, booleanos, mapas (objetos) e listas (arrays).

Estrutura básica:

- name: <step_name>
    type: assign
    inputs:
      <variable_name>: <value_or_expression>

Exemplo:

- name: variableInitialization
    type: assign
    inputs:
      stringVar: "${{ .workflowInputs.initialValue }}"
      intVar: "${{ .workflowInputs.anotherValue }}"
      concatenationVar: "${{ .workflowInputs.initialValue }} - concatenated"
      booleanVar: true
      mapVar:
        key1: "value1"
        key2: "${{ .workflowInputs.initialValue }}"
      listVar:
        - "listItem1"
        - "${{ .workflowInputs.initialValue }}"
        - "${{ .workflowInputs.anotherValue }}"
      statusCode: ${{ .steps.runAction.outputs.statusCode }}

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

Este exemplo cria um fluxo de trabalho que redimensiona instâncias EC2 quando há picos de CPU — após obter aprovação da equipe via Slack. Isso demonstra coleta de dados, lógica condicional, integrações externas e tratamento de erros.

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.

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 gerenciador de segredos

Construa o fluxo de trabalho passo a passo.

Construa cada parte do fluxo de trabalho. Cada etapa inclui ações específicas e demonstra padrões de fluxo de trabalho.

Referência completa de parâmetros

Este fluxo de trabalho requer credenciais, configuração e contexto de tempo de execução como entradas. 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
• 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

Próximos passos

Após concluir este exemplo, explore estes recursos: