# Configuração do Suricato Placa

## Visão Geral

Este procedimento descreve a configuração do **Suricato Placa**, com foco na gestão de logs da aplicação.

Os logs são fundamentais para monitoramento, diagnóstico e análise de erros, sendo configurados por meio do arquivo **log4j2.xml**. A aplicação permite execução em modo console para fins de debug, além de registrar automaticamente os logs em arquivos rotativos.

## Regras de Negócio

Antes de realizar a configuração, observe as seguintes diretrizes técnicas do sistema de logs:

* **Arquivo de Configuração:** A configuração de logs é realizada exclusivamente pelo arquivo `log4j2.xml`.
* **Modo Console:** O modo console deve ser utilizado apenas para debug e análise em ambiente controlado.
* **Separação de Severidade:** Logs do tipo `INFO` e `ERROR` são gerados e separados em arquivos distintos.
* **Política de Retenção:** Os arquivos de log utilizam política de rotação automática (*rolling*).
* **Capacidade e Limite:** Cada tipo de log mantém até 11 arquivos históricos, com o limite de tamanho de 10MB para cada arquivo.

## Como configurar o Suricato Placa

{% stepper %}
{% step %}

#### Configuração do Sistema

Localize o arquivo de configuração de log:

* **log4j2.xml**

Realize os ajustes necessários conforme o padrão desejado de log.
{% endstep %}

{% step %}

#### Configuração de Log da Aplicação

* **Appender Console**

Utilize o modo console apenas para debug e análise.

Execute o comando abaixo para iniciar a aplicação em modo console:

```
java -cp suricato-placa.jar -Dloader.main=br.com.telematica.suricato.placa.Main org.springframework.boot.loader.PropertiesLauncher
```

Nesse modo, os logs serão exibidos diretamente na tela.

* **Appender RollingFile (INFO)**
  * Todos os logs do tipo **INFO** são registrados no arquivo:
    * `suricato-vv.info.log`
  * O sistema mantém:
    * Até **11 arquivos**
      * Com tamanho máximo de **10MB cada.**
* **Appender RollingFile – ErrorLogFile (ERROR)**
  * Todos os logs do tipo **ERROR** são registrados no arquivo:
    * `suricato-vv.error.log`
  * O sistema mantém:
    * Até **11 arquivos**
    * Com tamanho máximo de **10MB cada**
      {% endstep %}
      {% endstepper %}

## FAQ – Perguntas Frequentes

<details>

<summary>Onde configuro os logs da aplicação?</summary>

No arquivo **log4j2.xml**.

</details>

<details>

<summary>Posso executar a aplicação sem instalar o serviço?</summary>

Sim. Utilize o modo console para debug através do comando informado.

</details>

<details>

<summary>Qual a diferença entre os logs INFO e ERROR?</summary>

* **INFO:** informações gerais de execução
* **ERROR:** falhas e problemas na aplicação

</details>

<details>

<summary>Os logs crescem indefinidamente?</summary>

Não. Os logs utilizam rotação automática, mantendo até **11 arquivos de 10MB** cada.

</details>

<details>

<summary>Quando devo usar o modo console?</summary>

Apenas para **debug e análise**, não sendo recomendado para uso em produção.

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://software-telematica-com.gitbook.io/suricato-docs/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-suricato-placa/configuracao-do-suricato-placa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.