

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

# Integração com DevOps o AWS Agent
<a name="devops-agent-integration"></a>

Com o [AWS DevOps Agent](https://aws.amazon.com/devops-agent/), você pode automatizar a investigação dos resultados do seu teste de carga diretamente da solução Distributed Load Testing on AWS. Ao conectar um Espaço do Agente, você pode enviar execuções de teste concluídas ao agente para análise. O agente identifica proativamente os gargalos de desempenho, determina as causas-raiz e sugere etapas de remediação, sem exigir que você correlacione manualmente métricas, registros e rastreamentos da Amazon. CloudWatch 

## Pré-requisitos
<a name="devops-agent-prerequisites"></a>

Antes de conectar um espaço de agente ao teste de carga distribuído na AWS (DLT), faça o seguinte:
+ O espaço do agente deve estar na mesma conta da AWS que sua implantação de DLT.
+ O Espaço do Agente deve ser marcado com a chave `dlt-integration` e o valor`allowed`. Essa tag estabelece o consentimento duplo — tanto o operador do DLT quanto o administrador do Espaço do Agente devem tomar medidas explícitas antes que o DLT possa acessar o Espaço do Agente.
+ A `dlt-integration: allowed` tag deve estar presente para que o DLT possa aceitar solicitações de teste de conexão ou investigação, mesmo que o ARN do Agent Space seja válido.

Para adicionar a tag, escolha o [console do AWS DevOps Agent](https://console.aws.amazon.com/aidevops) e escolha seu espaço de agente. Escolha a guia **Configuração**. Role para baixo até a seção **Tags**, escolha **Adicionar nova tag**, insira `dlt-integration` como chave e `allowed` como valor e escolha **Salvar**.

## Registrar um espaço de agente
<a name="devops-agent-register"></a>

Depois que seu Agent Space for marcado, conclua as seguintes etapas para registrá-lo no DLT:

1. Escolha **Integração de agentes** na barra lateral esquerda do console web DLT.

1. Na seção **Conexões do DevOps agente**, escolha **Registrar espaço do agente**.

1. Insira um nome de exibição e cole o ARN do Agent Space no console do AWS DevOps Agent.

1. Escolha **Testar conexão** para verificar se o ARN está acessível e se a `dlt-integration: allowed` tag está presente.

1. Depois que a conexão for confirmada, escolha **Salvar**.

Você pode registrar vários Agent Spaces e selecionar entre eles ao iniciar uma investigação.

## Investigue um teste
<a name="devops-agent-investigate"></a>

Depois de registrar pelo menos um Agent Space, você pode iniciar uma investigação a partir de qualquer teste concluído. O botão **Investigar com o DevOps agente** aparece na página de detalhes de cada execução de teste. Execute as etapas a seguir:

1. Escolha **Investigar com o DevOps agente** após a conclusão de uma execução de teste — bem-sucedida, com falha ou parcial.

1. Se você registrou vários Agent Spaces, escolha um na lista.

1. Opcionalmente, forneça contexto adicional, como uma descrição das mudanças recentes na infraestrutura ou a linha de base de desempenho esperada.

1. Selecione **Enviar**.

A investigação aparece na guia **Investigações** da página de detalhes da execução do teste, onde você pode acompanhar seu status e escolher o link para ver as descobertas no console do AWS DevOps Agent.

**nota**  
O AWS DevOps Agent impõe um limite de 10.000 caracteres na descrição da investigação. A descrição enviada pela solução combina seu contexto opcional com um DLT-generated resumo da execução do teste (configuração do teste, comparação da linha de base, principais erros classificados por contagem e detalhamento por endpoint). Para se adequar ao limite, a solução prioriza a configuração do teste e o contexto fornecido pelo usuário e reduz as seções de menor prioridade, começando com a divisão por endpoint, quando, de outra forma, o tamanho combinado excederia 10.000 caracteres.

## Revisar descobertas
<a name="devops-agent-findings"></a>

As investigações DevOps do AWS Agent geralmente são concluídas em alguns minutos, mas podem ser diferentes dependendo da configuração do Agent Space. Ao concluir, escolha **Visualizar descobertas** na guia **Investigações** para abrir as descobertas no console do AWS DevOps Agent.

As descobertas incluem o seguinte:
+ Uma análise estruturada da causa básica que identifica quais componentes contribuíram para a latência ou os erros.
+ Uma lista dos sintomas observados durante a janela de teste.
+ Sugestões concretas de remediação.

As investigações permanecem na guia **Investigações** de DLT durante toda a vida útil do registro de execução do teste, para que você possa consultar análises anteriores à medida que seu aplicativo evolui.

## fluxo de trabalho sugerido
<a name="devops-agent-suggested-workflow"></a>

Para aproveitar ao máximo a integração do AWS DevOps Agent, use-a como parte de um ciclo iterativo de ajuste de desempenho: implante, teste de carga, investigue, corrija e repita. Cada passagem pelo loop fornece ao agente mais histórico para comparar e fornece evidências mensuráveis de que uma mudança melhorou o desempenho.

1.  **Implantar** — Implante seu aplicativo no ambiente que você deseja testar e conclua a configuração única descrita em [Pré-requisitos](#devops-agent-prerequisites) e [Registre](#devops-agent-register) um Espaço do Agente.

1.  **Estabeleça uma linha de base** [— execute seu cenário de teste em uma versão em boas condições e designe a execução como uma linha de base (consulte a comparação da linha de base).](explore-test-results.md#baseline-comparison) Quando uma linha de base é definida, a solução inclui uma comparação com sua solicitação de investigação, para que o agente possa distinguir uma regressão da variação normal.

1.  **Teste de carga** — Execute o cenário de teste após cada alteração no aplicativo ou na infraestrutura. Mantenha a configuração do cenário constante entre as execuções para que os resultados permaneçam comparáveis.

1.  **Investigar** — Após a conclusão da execução, escolha **Investigar com o DevOps agente** na página de detalhes da execução de teste. Forneça contexto sobre o que mudou desde a última execução — implantações recentes, alterações de configuração ou o desempenho esperado — para que o agente possa focar sua análise.

1.  **Remediar** — Analise a causa raiz e as sugestões de remediação na guia **Investigações** ou abra as descobertas no console do AWS DevOps Agent para gerar um plano de mitigação. Aplique a correção em seu aplicativo ou infraestrutura.

1.  **Repita** — Re-run o cenário do teste e compare os resultados com sua linha de base para verificar a correção. Quando o desempenho melhorar, designe a nova corrida como sua linha de base e continue o ciclo com sua próxima alteração.

**nota**  
Cada teste dá suporte a uma investigação ativa por vez. Arquive uma investigação concluída na guia **Investigações** antes de iniciar uma nova no mesmo teste.