# Retenção de logs

Defina por quanto tempo um grupo de logs do CloudWatch guarda os eventos, veja quanto ele armazena e o que acontece quando o CloudFormation, o CDK ou o Terraform o gerencia.

O CloudWatch Logs guarda os eventos para sempre se o grupo de logs não tiver retenção, e os logs armazenados são cobrados todo mês. Para mudar, abra o grupo de logs (Services → Logs) e toque em **Retention**.

Screenshot: Folha Retention de /ecs/checkout-api com o aviso de que a stack do CloudFormation checkout-service o gerencia

## Escolha uma retenção

A folha lista todos os valores que o CloudWatch Logs aceita, de 1 dia a 10 anos, mais **Never expire**. O atual aparece marcado e, para um grupo que nunca expira, 1 mês vem como **Suggested**. A folha também mostra quanto o grupo armazena agora.

Encurtar a retenção é confirmado como qualquer outra mudança, no nível que você definiu para a conta (por padrão, digitando a última parte do nome do grupo). O CloudWatch Logs então apaga os eventos mais antigos que o novo período, normalmente em até 72 horas, e eles não podem ser recuperados.

## Gerenciado pelo CloudFormation, CDK ou Terraform

Se o grupo de logs pertence a uma stack do CloudFormation, ou se as tags mostram que uma ferramenta como Terraform, Pulumi ou Serverless Framework o gerencia, a folha avisa antes de você escolher: a mudança funciona, mas o próximo deploy (uma atualização da stack, `cdk deploy`, `terraform apply`…) pode trazer o valor do template de volta. Defina `RetentionInDays` (ou `retention_in_days`) no código para a mudança ficar; **Open stack** leva você até a stack.

Quando só a função Lambda que escreve no grupo está em uma stack, a nota é apenas informativa: o Lambda criou o grupo, então a stack não desfaz a mudança.

## Encontre grupos que nunca expiram

O [Waste finder](https://cloudconsole.dev/pt-br/help/waste-finder) lista os grupos de logs que nunca expiram e armazenam muito, com o custo mensal, e pode definir 30 dias em cada um. A lista de grupos de logs também os marca com uma dica.

## Permissões

`logs:PutRetentionPolicy` para definir uma retenção e `logs:DeleteRetentionPolicy` para Never expire. Mudanças precisam do Pro.

## Perguntas frequentes

### Quanto a retenção economiza?

O CloudWatch Logs cobra os dados armazenados por GB por mês, então um grupo que nunca expira custa mais a cada mês. O Waste finder mostra quanto cada um desses grupos custa agora; definir uma retenção para esse crescimento e remove o que é mais antigo.

### Meu plano do Terraform vai mostrar diferença?

Sim, se o Terraform gerencia o grupo de logs e o código diz outra coisa. Mude também retention_in_days no código, senão o próximo apply traz o valor antigo de volta.

**Ainda com dúvidas?**

Escreva para [support@cloudconsole.dev](mailto:support@cloudconsole.dev) contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.

## Veja também

- [Ler e pesquisar no CloudWatch Logs](https://cloudconsole.dev/pt-br/help/logs) – Como usar o app
- [Encontrar desperdício: recursos sem uso que custam dinheiro](https://cloudconsole.dev/pt-br/help/waste-finder) – Como usar o app
- [Custos, previsão e quanto o Cost Explorer cobra](https://cloudconsole.dev/pt-br/help/costs) – Como usar o app
- [Proteções: como as alterações são confirmadas](https://cloudconsole.dev/pt-br/help/guardrails) – Segurança e alterações

[Todos os tópicos de ajuda →](https://cloudconsole.dev/pt-br/help/)

---

Source: https://cloudconsole.dev/pt-br/help/log-retention

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
