# Logs

### Visão Geral

A funcionalidade de Logs do módulo Autofix é o hub central de auditoria e transparência da plataforma. Ela permite visualizar, monitorar e auditar todas as ações automatizadas executadas, fornecendo rastreabilidade completa sobre as mudanças realizadas nos recursos cloud. O foco é garantir que a automação seja acompanhada de governança rigorosa e controle operacional total.

### Objetivo de Negócio

Em infraestruturas dinâmicas, a automação sem visibilidade pode gerar insegurança. O módulo de Logs foi desenhado para responder de forma imediata a perguntas críticas de operação e compliance:

* Rastreabilidade: Qual recurso foi impactado e qual regra disparou a ação?
* Temporalidade: Exatamente quando a automação ocorreu?
* Efetividade: A execução foi bem-sucedida ou houve alguma falha técnica?
* Transparência: Como garantir que as políticas de custo e tags estão sendo aplicadas conforme o planejado?

***

### Abrangência e Dados Registrados

O sistema registra automaticamente todas as atividades provenientes das funcionalidades do Autofix, incluindo:

* Serviços Monitorados: Smart Stop, Scheduled Scaling, Auto Tags e Tag Manager.
* Informações Detalhadas:
  * Tipo de ação executada (ex: Stop, Start, Tagging, Scaling).
  * Identificação do recurso (ID, Nome), Conta e Região AWS/Azure.
  * Carimbo de data e hora (Timestamp) preciso.
  * Status da execução (Sucesso ou erro detalhado).

***

### Como Funciona

#### 1. Registro Automático (Native Logging)

Não é necessária nenhuma configuração manual para ativar a auditoria. Sempre que uma regra do Autofix entra em execução, o evento é capturado nativamente e as informações técnicas são armazenadas de forma segura para consulta futura.

#### 2. Consulta e Filtros

No painel Autofix → Logs, os administradores podem navegar pelo histórico utilizando filtros inteligentes para:

* Isolar eventos de uma automação específica (ex: ver apenas Logs de *Smart Stop*).
* Identificar recursos específicos afetados em um intervalo de tempo.
* Analisar falhas de execução para troubleshooting rápido.

***

### Impacto em FinOps e Governança

A funcionalidade de Logs é o pilar que sustenta a confiança na automação dentro da cultura FinOps:

* Segurança Operacional: Valida se os desligamentos e ajustes de capacidade ocorreram conforme as janelas de manutenção.
* Compliance e Auditoria: Facilita a prestação de contas para auditorias internas e externas sobre a gestão de recursos.
* Confiança Organizacional: Reduz a resistência dos times de engenharia ao uso de automações, provando a consistência das ações realizadas.

### Boas Práticas

* Monitoramento de Erros: Revise periodicamente os logs em busca de falhas recorrentes, que podem indicar permissões de IAM insuficientes ou recursos protegidos.
* Suporte a Incidentes: Utilize o histórico de logs como primeira fonte de consulta caso haja dúvida sobre o estado de um recurso (se foi desligado manualmente ou via automação).
* Revisão de Impacto: Após alterar uma política de escalonamento ou tagueamento, utilize os logs para validar se o comportamento real condiz com a nova configuração.

***

### Para utilização e acesso na plataforma Pier:

Na funcionalidade de Logs, é possível ter uma rastreabilidade das ações feitas. Permitindo visualizar tudo, tanto o que foi bem sucedido, quanto e o que deu erro.

1. **Acessando o Logs**.

No menu de funcionalidades lateral do Autofix, selecione **Logs**.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FpxMeQpYIyFMGWqCioLUL%2Fimage.png?alt=media&#x26;token=01a2f871-df04-4b84-945d-2609cb633d27" alt=""><figcaption></figcaption></figure>

2. **Filtros**

Também existem os filtros para conseguir chegar a uma exatidão de logs.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FzZc3ZI7GQ5EE5mKDEAlw%2Fimage.png?alt=media&#x26;token=a8d4fd98-b502-4801-abda-68873e738340" alt=""><figcaption></figcaption></figure>

**Pesquisar**: O sistema permite Pesquisar o recurso específico ou a account ID.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FHextvzigqg7ih5GaX0fH%2Fimage.png?alt=media&#x26;token=940b74f7-a9ff-422d-badd-1c3eaaeb84db" alt=""><figcaption></figcaption></figure>

**Ação:** O sistema permite filtrar pela Ação específica do Autofix como GP2 para GP3

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FV59eH4pyplD7786h2wfr%2Fimage.png?alt=media&#x26;token=f4844af3-e377-465b-aefa-779a98bbfd50" alt=""><figcaption></figcaption></figure>

**Região:** O sistema permite filtrar por Região, trazendo todos os recursos da região selecionada.

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FhTy6NUCeFV9HfXwCqmiU%2Fimage.png?alt=media&#x26;token=1e9f66a7-1092-4536-a9b3-df8f99b235c1" alt=""><figcaption></figcaption></figure>

**Período:** O sistema permite filtrar por Período, selecionando uma data inicial e uma final

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F7cB2HGwg6seZTtK6ZIfa%2Fimage.png?alt=media&#x26;token=67ac9a24-a6df-4ba1-9d0a-7c3112fbb139" alt=""><figcaption></figcaption></figure>

**Status:** O sistema permite filtrar por Status com **sucesso** ou **falha**, sendo o padrão todos.&#x20;

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2F5ZMsSycf25AmO7V5Acdz%2Fimage.png?alt=media&#x26;token=9c99bc52-06a6-4035-9583-e72a30c6e43c" alt=""><figcaption></figcaption></figure>

3. **Relatório**

Clique no botão “Baixar relatório” para extrair todos os logs em formato CSV

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FX25x8SwTIMkefiglcNwC%2Fimage.png?alt=media&#x26;token=892d4a46-561f-4cc8-afe6-f9942354ed68" alt=""><figcaption></figcaption></figure>

4. **Visualizar log**

O sistema permite visualizar todos os detalhes do log clicando no botão ![](https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FisxL09jsnqmOiA9xFVn8%2Fimage.png?alt=media\&token=adcdae0e-1177-4d40-8330-bfbf62a30092)

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2FKxbhHhdCaZcyEpIb9SlH%2Fimage.png?alt=media&#x26;token=0cf46808-ce3e-40a2-aa7a-76a56617f3db" alt=""><figcaption></figcaption></figure>

<figure><img src="https://109632036-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fcxn6hAOP0k8IqKSI8iRP%2Fuploads%2Ftr6I1lNSOOOPuRPWypgT%2Fimage.png?alt=media&#x26;token=c98c5659-f5bf-4ebe-96bb-f526b02475e9" alt=""><figcaption></figcaption></figure>
