Solução de problemas de automação de fluxo de trabalho

Esta página fornece soluções para problemas comuns que você pode encontrar ao usar o fluxo de trabalho Automation. Para obter suporte adicional, consulte o Fórum de Suporte da New Relic ou entre em contato com o Suporte da New Relic.

Credenciais e autenticação da AWS

tokeninválido ou credenciais expiradas

Problema: fluxo de trabalho falha com erros de expiração token.

Soluções:

1. Para o token de sessão: verifique o timestampde expiração — os tokens de sessão geralmente duram de 1 a 12 horas. Gere novas antes que expirem usando:
   bash

   Copiar

   $
   aws sts assume-role \
   >
     --role-arn "arn:aws:iam::YOUR_ACCOUNT:role/YOUR_ROLE" \
   >
     --role-session-name "WorkflowAutomationSession"

2. Para chaves de acesso: Verifique se o ID da chave de acesso e a chave de acesso secreta estão armazenados corretamente no gerenciador de segredos. Verifique novamente os valores no explorador GraphiQL do NerdGraph.
3. Verifique a sintaxe dos segredos: Certifique-se de estar usando o formato ${{ :secrets:keyName }}, e não ${{ secrets.keyName }}. O prefixo de dois pontos (:secrets:) é obrigatório.

Não consigo encontrar o ARN da minha função.

Problema: Você precisa do ARN, mas não consegue encontrá-lo na AWS.

Solução:

1. Faça login no Console do AWS IAM.
2. Selecione Roles na barra de navegação.
3. Procure pelo nome da sua função (ex: NewRelicWorkflowAutomationRole)
4. Selecione a função — o ARN aparece na seção Resumo.
5. O formato ARN é: arn:aws:iam::<YOUR_AWS_ACCOUNT>:role/<ROLE_NAME>

fluxo de trabalho não pode acessar recursos específicos AWS

Problema: Sua função possui permissões, mas o fluxo de trabalho ainda não consegue acessar determinados recursos.

Soluções:

1. Permissões em nível de recurso: verifique se sua política do IAM restringe o acesso a ARNs de recursos específicos. Você pode precisar adicionar um curinga (*) para testes e, em seguida, restringir a recursos específicos.

   {
     "Effect": "Allow",
     "Action": "ec2:DescribeInstances",
     "Resource": "*" // Change from specific ARN to * for testing
   }

   Copiar
2. Políticas de controle de serviço (SCPs): Se você estiver em uma organização da AWS, as SCPs podem bloquear determinadas ações. Entre em contato com o administrador da AWS para revisar as políticas da organização.
3. Incompatibilidade de região: verifique se suas permissões do IAM especificam a região correta da AWS onde seus recursos estão localizados. Atualize o parâmetro awsRegion do fluxo de trabalho para corresponder à localização do seu recurso.

Problemas na execução do fluxo de trabalho

Guia rápido de resolução de problemas

Utilize esta tabela para um diagnóstico rápido de problemas comuns no fluxo de trabalho:

Para obter instruções detalhadas sobre como visualizar logs e histórico de execução, consulte Monitorar execuções de fluxo de trabalho.

O fluxo de trabalho aparece com o status "Falha".

Problema: Um fluxo de trabalho aparece com o status "Falha" no dashboard.

Soluções:

1. Verifique o histórico de execução:

   • Acesse one.newrelic.com > All Capabilities > Workflow Automation
   • Clique no nome do fluxo de trabalho.
   • Veja Run history para verificar qual execução falhou.

2. Analisar os logs de execução:

   • Clique em View logs na execução com falha para identificar a ação específica que falhou.
   • Procure por mensagens de erro que indiquem a causa raiz.

3. Causas comuns:

   • Credenciais inválidas: Token expirado, sintaxe de segredos incorreta ou chaves secretas erradas.
   • Permissões ausentes: Permissões insuficientes do AWS IAM, escopos de token do bot do Slack ou acesso à API.
   • Mudanças nos recursos de destino: instâncias do EC2 excluídas, canais do Slack removidos ou banco de dados renomeado
   • Limites de taxaAPI excedidos: Muitas requests para serviços externos (AWS, Slack, etc.)
   • Tempo limite de rede: APIs externas demorando muito para responder.

4. Corrigir e executar novamente: Após resolver o problema, acione manualmente o fluxo de trabalho usando a API StartWorkflowRun para verificar se ele funciona.

A execução do fluxo de trabalho está demorando muito.

Problema: As execuções do fluxo de trabalho excedem a duração esperada ou o tempo limite.

Soluções:

1. Revisar a sequência de ações: verificar os logs para identificar ações lentas. Procure por ações com tempos de execução superiores a 30 segundos.

2. Otimizar consulta: Se estiver usando consultas NRQL, otimize-as para melhor desempenho:

   • Adicione intervalos de tempo específicos em vez de consultar todos os dados.
   • Use LIMIT para reduzir o tamanho do conjunto de resultados.
   • Filtrar antecipadamente com cláusulas WHERE

3. Verifique as APIs externas: Respostas lentas de serviços integrados (AWS, Slack) podem atrasar a execução. Teste API tempo de resposta separadamente.

4. Considere os limites do fluxo de trabalho: revise os limites do fluxo de trabalho para restrições de tempo limite (normalmente 15 minutos por fluxo de trabalho).

5. Divida o fluxo de trabalho menor: divida o fluxo de trabalho complexo em automações menores e focadas que podem ser executadas em paralelo.

As alterações no fluxo de trabalho não surtem efeito.

Problema: Você editou um fluxo de trabalho, mas as alterações não são aplicadas quando ele é executado.

Soluções:

1. Verifique se você salvou: Confira se você clicou em Save após editar a configuração do fluxo de trabalho.

2. Verifique a versão:

   • Acesse os detalhes do fluxo de trabalho.
   • Clique na guia Version history
   • Certifique-se de que suas alterações mais recentes apareçam como uma nova versão.
   • Verifique se esta versão está marcada como ativa.

3. Atualizar execuções agendadas: Se o fluxo de trabalho for executado de acordo com um agendamento, atualize o agendamento para usar a nova versão:

   • Acesse one.newrelic.com > All Capabilities > Workflow Automation
   • Encontre corridas programadas
   • Atualize o cronograma para fazer referência à nova versão do fluxo de trabalho.

4. Limpar cache: O cache Browser pode exibir configurações antigas — atualize a página completamente (Ctrl+Shift+R ou Cmd+Shift+R).

problemas dashboard fluxo de trabalho

Não consigo encontrar um fluxo de trabalho no dashboard

Problema: Um fluxo de trabalho que você criou não aparece na lista dashboard.

Soluções:

1. Verifique os filtros:

   • Clique no dropdowndo filtro.
   • Selecione "Todos" para os filtros de status.
   • Limpar a barra de pesquisa

2. Verificar conta: Confirme se você está conectado à conta correta do New Relic onde o fluxo de trabalho foi criado. Verifique o seletor de contas no canto superior direito.

3. Verifique as permissões: Certifique-se de que seu perfil do usuário tenha acesso para visualizar o fluxo de trabalho. Entre em contato com o administrador do New Relic se precisar de permissões de acesso ao fluxo de trabalho.

4. Atualize a página: o cache Browser às vezes pode ocultar alterações recentes. Tente uma atualização completa da página (Ctrl+Shift+R ou Cmd+Shift+R).

Não é possível excluir um fluxo de trabalho.

Problema: A opção de excluir está desativada ou a exclusão falha.

Soluções:

1. Verifique permissões: Verifique se seu perfil do usuário possui permissões de exclusão para fluxo de trabalho. Se necessário, entre em contato com o administrador da sua conta.

2. Interromper execuções agendadas: Cancele todas as execuções agendadas ativas antes de excluí-las.

   • Acesse os detalhes do fluxo de trabalho.
   • Acesse a aba Scheduled runs
   • Cancelar todos os agendamentos ativos

3. Verifique dependência: Alguns fluxos de trabalho não podem ser excluídos se outras automações dependerem deles. Verifique se o fluxo de trabalho é referenciado por:

   • Outros fluxos de trabalho que o chamam
   • política de alertas que o acionam
   • Sistemas externos que o iniciam via API

4. Contate o suporte: Se o problema persistir após tentar as soluções acima, entre em contato com o Suporte da New Relic para obter assistência.

Questões específicas de integração

A notificação do Slack não aparece

Problema: O fluxo de trabalho é concluído com sucesso, mas as mensagens do Slack não aparecem.

Soluções:

1. Verifique o ID do canal: Certifique-se de usar o ID do canal do Slack (por exemplo, C01234ABCD), e não o nome do canal. Encontre o ID no Slack:

   • Clique com o botão direito do mouse no nome do canal.
   • Selecione View channel details.
   • Copie o ID do canal que está na parte inferior.

2. Verifique as permissões do bot: verifique se o seu bot do Slack possui os seguintes escopos:

   • chat:write - Publicar mensagens
   • channels:read - Ver canais públicos
   • groups:read - Visualizar canais privados (se aplicável)

3. Verifique se o bot está no canal: Adicione o bot ao canal Destino:

   • Digite /invite @YourBotName no canal
   • Confirme se o bot aparece na lista de membros.

4. Verificar token em segredos: Verifique se o token do Slack armazenado no gerenciador de segredos está correto e não expirou.

As operações do AWS Systems Manager falham.

Problema: Os documentos ou comandos de automação do SSM não são executados.

Soluções:

1. Verificar permissões do SSM: Certifique-se de que a função do IAM tenha estas permissões:

   {
     "Effect": "Allow",
     "Action": [
       "ssm:CreateDocument",
       "ssm:DeleteDocument",
       "ssm:StartAutomationExecution",
       "ssm:GetAutomationExecution"
     ],
     "Resource": "*"
   }

   Copiar
2. Verifique o agente SSM: verifique se as instâncias de destino do EC2 têm o agente SSM instalado e em execução:
   bash

   Copiar

   $
   aws ssm describe-instance-information --region us-east-1

3. Verifique o perfil da instância: as instâncias do EC2 precisam de um perfil de instância IAM com permissões SSM para executar comandos.
4. Verificar se o documento existe: Se estiver usando um documento SSM existente, verifique se ele existe em sua conta e região da AWS.

Problemas específicos do modelo

GUID da entidade não encontrado

Problema: Os modelos falham com erros Entity not found.

Soluções:

1. Encontre o GUID da entidade correta:

   • Acesse a página de recursos monitorados no New Relic.
   • Verifique o URL ou os metadados da entidade para obter o GUID.
   • Use a pesquisa de entidade para localizar entidade

2. Verificar se a entidade existe na conta correta: Confirme se você está usando a entidade da mesma conta onde o fluxo de trabalho está implantado.

3. Confirme os dados de reporte da entidade: verifique se a entidade mostra Last seen — entidades desatualizadas podem ter sido removidas.

4. Para entidade AWS : Certifique-se de que a integração esteja ativa

A consulta NRQL não retornou resultados.

Problema: Os modelos que utilizam NRQL consultam o conteúdo, mas retornam conjuntos de dados vazios.

Soluções:

1. Teste a consulta primeiro: Use o criador de consulta para validar a consulta antes de adicionar aos modelos

2. Verificar tipo de dados e nomes de eventos:

   • Use FROM Transaction, não FROM Transactions
   • Verifique se os nomes dos atributos correspondem exatamente (diferenciando maiúsculas de minúsculas).

3. Ajustar intervalos de tempo: Para dados esparsos, expanda a janela de tempo:

   • Adicione SINCE 1 hour ago para dados recentes.
   • Use SINCE 1 day ago para tendências

4. Simplifique e teste incrementalmente: Comece com uma consulta básica e adicione filtros um de cada vez.

5. Verificar sintaxe NRQL: Verificar se a estrutura da consulta corresponde aos requisitos NRQL.

A implantação do modelo falha

Problema: Template não implanta ou apresenta erros durante a implantação.

Soluções:

1. Verifique todas as informações necessárias: Certifique-se de ter preenchido todos os campos obrigatórios (credenciais, GUIDs, consulta).
2. Verifique o formato das credenciais: os segredos devem usar o formato ${{ :secrets:keyName }} com o prefixo de dois pontos.
3. Teste as credenciais de forma independente: Antes da implantação, teste as credenciais AWS com AWS CLI e o token do Slack na APIdo Slack.
4. Verifique os requisitos do modelo: Cada modelo lista pré-requisitos específicos — verifique se todos foram atendidos.
5. Verifique a presença de caracteres especiais: Alguns campos (nomes de canais, consulta) podem não conter caracteres especiais — utilize caracteres alfanuméricos sempre que possível.

Aprovação fluxo de trabalho não responde

Problema: Os modelos que exigem aprovação do Slack (reversão do API Gateway, redimensionamento do EC2) não detectam reações.

Soluções:

1. Verificar escopos de token do bot:

   • reactions:read - Necessário para detectar reações com emojis
   • chat:write - É necessário publicar mensagens de aprovação.

2. Verifique o formato da reação: Use o emoji exato especificado no fluxo de trabalho (normalmente 👍 para aprovar, 👎 para rejeitar).

3. Verifique as configurações de tempo limite: requests de aprovação expiram após o tempo limite configurado (geralmente de 5 a 10 minutos).

4. Garantir que o bot possa ler as mensagens: O bot deve estar no canal e ter permissão para ler o histórico de mensagens.

5. Teste com aprovação simples: Crie um fluxo de trabalho de teste com apenas lógica de aprovação para isolar o problema.

problemas de gerenciamento de instâncias do EC2

Problema: o modelo EC2 não consegue redimensionar ou gerenciar a estrutura.

Soluções:

1. Verifique se CloudWatch Metric Streams estão configurados: Necessário para métricas EC2 em tempo real.
2. Verificar se a integração de monitoramento do EC2 está ativa: Garante que os dados da instância sejam enviados para o New Relic.
3. Confirme o estado do participante: o participante deve estar no estado running ou stopped — estados de transição (pendente, parando) causam falhas.
4. Verifique a compatibilidade do tipo de instância: nem todos os tipos de instância suportam todas as operações de redimensionamento - verifique a documentação do tipo de instânciaAWS
5. Verificar permissões de parada/início: a função IAM precisa de ec2:StopInstances e ec2:StartInstances além de ec2:ModifyInstanceAttribute

O modelo de análise JSON não está registrando dados.

Problema: O modelo de análise JSON é executado com sucesso, mas nenhum dado aparece nos logs New Relic.

Soluções:

1. Verifique os endpointda API: Teste a URL da página de status em um navegador — certifique-se de que ela retorne um JSON válido.
2. Verifique a estrutura JSON: o modelo espera um formato específico — verifique se os campos de integridade do componente correspondem à estrutura esperada.
3. Revisar filtros de log: Garantir que a ação de registro utilize o tipo de evento e o atributo corretos.
4. Teste com um endpoint simples: Use um endpoint JSON básico (como https://httpbin.org/json) para verificar se a mecânica do modelo funciona.
5. Verificar permissões da conta: Verifique se o fluxo de trabalho tem permissão para gravar logs no New Relic.

A autenticação da consulta SQL do NRLens falha

Problema: O modelo NRLens falha devido a erros de autenticação ou conexão.

Soluções:

1. Verificar credenciais do NRLens: Confirme se as credenciais do SQL Consulta Gateway estão atualizadas e armazenadas corretamente nos segredos.
2. Verifique os IDs da organização e da conta: Certifique-se de que ambos os IDs correspondam exatamente à sua organização do New Relic.
3. Teste a consulta SQL separadamente: Use a interface NRLens para testar a consulta antes de adicioná-la ao fluxo de trabalho.
4. Verifique a sintaxe SQL: o SQL do NRLens difere do NRQL — consulte a documentação do NRLens para obter informações sobre a sintaxe suportada.
5. Verifique a complexidade da consulta: junções muito complexas ou conjuntos de dados grandes podem atingir o tempo limite — simplifique a consulta ou adicione limites de tempo.

Próximos passos

Se você ainda estiver enfrentando problemas após tentar essas soluções:

• fluxo de trabalho Fórum da comunidade de automação: tire dúvidas e obtenha ajuda de outros usuários
• Suporte da New Relic: Entre em contato com o suporte para problemas específicos da sua conta.
• fluxo de trabalho práticas recomendadas: Aprenda padrões para um fluxo de trabalho confiável
• Limitações do fluxo de trabalho: Compreenda as restrições e quotas do sistema.