

# Habilitar aplicações no Amazon ECS
<a name="CloudWatch-Application-Signals-Enable-ECSMain"></a>

Habilite o CloudWatch Application Signals no Amazon ECS usando as etapas de configuração personalizadas descritas nesta seção.

Para aplicações em execução no Amazon ECS, instale e configure por sua conta o agente do CloudWatch e o AWS Distro para OpenTelemetry. Nessas arquiteturas habilitadas com uma configuração personalizada do Application Signals, o Application Signals não descobre automaticamente os nomes dos seus serviços ou dos hosts ou clusters em que eles são executados. Você deve especificar esses nomes durante a configuração personalizada, e os nomes especificados serão exibidos nos painéis do Application Signals.

## Uso de uma configuração personalizada para habilitar o Application Signals no Amazon ECS
<a name="CloudWatch-Application-Signals-Enable-ECS"></a>

Use essas instruções de configuração personalizadas para integrar suas aplicação no Amazon ECS para o CloudWatch Application Signals. Você instala e configura o agente do CloudWatch e o AWS Distro para OpenTelemetry.

Existem dois métodos para a implantação do Application Signals no Amazon ECS. Escolha o método que for melhor para seu ambiente.
+ [Implemente usando a estratégia de arquivo associado](CloudWatch-Application-Signals-ECS-Sidecar.md): você adiciona um contêiner de arquivo associado do agente do CloudWatch a cada definição de tarefa no cluster.

  Vantagens:
  + Compatível com os tipos de lançamento `ec2` e `Fargate`.
  + Você sempre pode usar `localhost` como endereço IP ao configurar variáveis de ambiente.

  Desvantagens:
  + Você deve configurar o contêiner de arquivo associado do agente do CloudWatch para cada tarefa de serviço executada no cluster.
  + Somente o modo de rede `awsvpc` é compatível.
+ [Implemente usando a estratégia de daemon](CloudWatch-Application-Signals-ECS-Daemon.md): você adiciona uma tarefa de agente do CloudWatch somente uma vez no cluster e a [estratégia de agendamento de daemon do Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs_services.html#service_scheduler_daemon) a implanta conforme necessário. Isso garante que cada instância receba rastreamentos e métricas continuamente, fornecendo visibilidade centralizada sem que seja preciso que o agente funcione como arquivo auxiliar na definição de cada tarefa da aplicação.

  Vantagens:
  + Você precisa configurar o serviço de daemon para o agente do CloudWatch somente uma vez no cluster.

  Desvantagens:
  + Não é compatível com o tipo de inicialização do Fargate.
  + Se você usar o modo de rede `awsvpc` ou `bridge`, precisará especificar manualmente o endereço IP privado de cada instância de contêiner nas variáveis de ambiente.

Com qualquer um dos métodos, em clusters do Amazon ECS o Application Signals não descobre automaticamente os nomes dos seus serviços. Você deve especificar os nomes dos serviços durante a configuração personalizada, e os nomes especificados serão os exibidos nos painéis do Application Signals.

## Habilitar o Application Signals no Amazon ECS usando o protocolo de contexto para modelos (MCP)
<a name="CloudWatch-Application-Signals-ECS-MCP"></a>

Você pode usar o servidor MCP (Protocolo de Contexto para Modelos) do Application Signals do CloudWatch para habilitar o Application Signals nos clusters do Amazon ECS por meio de interações conversacionais de IA. Isso fornece uma interface de linguagem natural para configurar o monitoramento do Application Signals.

O servidor MCP automatiza o processo de habilitação compreendendo os requisitos e gerando a configuração apropriada. Em vez de seguir as etapas do console manualmente ou escrever código de CDK, você pode simplesmente descrever o que deseja habilitar.

### Pré-requisitos
<a name="CloudWatch-Application-Signals-ECS-MCP-Prerequisites"></a>

Antes de usar o servidor MCP para habilitar o Application Signals, certifique-se de ter:
+ Um ambiente de desenvolvimento compatível com MCP (como Kiro, Claude Desktop, VSCode com extensões MCP ou outras ferramentas compatíveis com MCP)
+ O servidor MCP do Application Signals do CloudWatch configurado no IDE. Para obter instruções detalhadas de configuração, consulte a documentação do [servidor MCP do Application Signals do CloudWatch](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server).

### Usar um servidor MCP
<a name="CloudWatch-Application-Signals-ECS-MCP-Usage"></a>

Depois de configurar o servidor MCP do CloudWatch Application Signals no IDE, você pode solicitar orientação sobre a habilitação usando prompts em linguagem natural. Embora o assistente de codificação possa inferir o contexto da estrutura do projeto, fornecer detalhes específicos nas instruções ajuda a garantir uma orientação mais precisa e relevante. Inclua informações como a linguagem da aplicação, o nome do cluster do Amazon ECS, a estratégia de implantação (sidecar ou daemon) e os caminhos absolutos para a infraestrutura e o código da aplicação.

**Prompts de acordo com as práticas recomendadas (específicos e completos):**

```
"Enable Application Signals for my Python service running on ECS.
My app code is in /home/user/flask-api and IaC is in /home/user/flask-api/terraform"

"I want to add observability to my Node.js application on ECS cluster 'production-cluster' using sidecar deployment.
The application code is at /Users/dev/checkout-service and
the task definitions are at /Users/dev/checkout-service/ecs"

"Help me instrument my Java Spring Boot application on ECS with Application Signals using daemon strategy.
Application directory: /opt/apps/payment-api
CDK infrastructure: /opt/apps/payment-api/cdk"
```

**Prompts menos eficazes:**

```
"Enable monitoring for my app"
→ Missing: platform, language, paths

"Enable Application Signals. My code is in ./src and IaC is in ./infrastructure"
→ Problem: Relative paths instead of absolute paths

"Enable Application Signals for my ECS service at /home/user/myapp"
→ Missing: programming language, deployment strategy
```

**Modelo rápido:**

```
"Enable Application Signals for my [LANGUAGE] service on ECS.
Deployment strategy: [sidecar/daemon]
App code: [ABSOLUTE_PATH_TO_APP]
IaC code: [ABSOLUTE_PATH_TO_IAC]"
```

### Benefícios de usar o servidor MCP
<a name="CloudWatch-Application-Signals-ECS-MCP-Benefits"></a>

O uso do servidor MCP do CloudWatch Application Signals oferece várias vantagens:
+ **Interface em linguagem natural:** descreva o que você deseja habilitar sem memorizar comandos nem sintaxe de configuração
+ **Orientação contextual:** o servidor MCP compreende seu ambiente específico e fornece recomendações personalizadas
+ **Menos erros:** a geração automatizada de configuração minimiza os erros da digitação manual
+ **Configuração mais rápida:** passe da intenção à implementação mais rapidamente
+ **Ferramenta de aprendizagem:** veja as configurações geradas e entenda como o Application Signals funciona

### Recursos adicionais
<a name="CloudWatch-Application-Signals-ECS-MCP-MoreInfo"></a>

Para saber mais sobre a configuração e o uso do servidor MCP do CloudWatch Application Signals, consulte a [documentação do servidor MCP](https://awslabs.github.io/mcp/servers/cloudwatch-applicationsignals-mcp-server).