# Transferência Universal de Logs

## Guia Netacea Universal Offline POV

Para enviar dados de log à Netacea para análise quando streaming em tempo real ou integrações de plataforma não são viáveis, você pode usar a **Interface de Linha de Comando (CLI) da AWS** para concluir um upload único para um bucket Amazon S3 seguro hospedado pela Netacea. Abaixo estão os passos documentados necessários para instalar e usar a AWS CLI para realizar uma transferência segura.

### Pré-requisitos

Para concluir com sucesso uma transferência offline de logs para a Netacea, certifique-se do seguinte:

* A **AWS CLI** está instalada e confirmada como funcional em sua máquina.
* Você recebeu os detalhes necessários do bucket S3 (nome do bucket e ARN) da Netacea. Estes podem ser encontrados [aqui](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Você criou um **arquivo de teste** que pode ser usado para validar a conexão antes de transferir os dados reais.
* Você está usando uma máquina que:
  * Permite **acesso via linha de comando**
  * Tem **permissão para instalar e executar ferramentas CLI**
  * Tem **acesso ao(s) arquivo(s) de log** destinados ao upload

{% hint style="info" %}
Você não precisa provisionar nenhuma infraestrutura do Bucket S3 ou credenciais associadas, pois estas serão fornecidas a você.
{% endhint %}

#### Passo 1: Instalar a AWS CLI

Baixe a AWS CLI da fonte oficial com base no seu sistema operacional:

* **Windows (64-bit)**
* **macOS (Instalador PKG)**
* **Linux (Instalador)**
* **Amazon Linux (AMI)**

👉 [Link para download da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

Após o download, execute o instalador e siga as instruções na tela.

Para confirmar a instalação bem-sucedida, execute o seguinte comando no seu terminal ou prompt de comando:

```
aws --version
```

#### **Passo 2: Configurar a AWS CLI**

Use as credenciais fornecidas para configurar seu ambiente:

```
aws configure
```

Em seguida, será solicitado que você insira algumas informações adicionais. A tabela abaixo explica quais informações precisam ser fornecidas e onde podem ser localizadas:

<table><thead><tr><th width="245">Nome</th><th>Valor</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Obtido no <a href="https://portal.netacea.com/">portal administrativo</a> da Netacea</td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Obtido no <a href="https://portal.netacea.com/">portal administrativo</a> da Netacea</td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Passo 3: Testar o Acesso com um Arquivo de Exemplo**

Certifique-se de ter criado um pequeno arquivo de teste (pode estar vazio) para verificar o acesso:

```
aws s3 cp localtestfile.txt s3://name-of-bucket 
```

* Substitua `/full/path/to/testfile.txt` pelo caminho real do seu arquivo de teste
* Substitua `<bucket-name>` pelo nome do bucket S3 fornecido pela Netacea

Após o upload, entre em contato com a **equipe de Engenharia de Soluções da Netacea** para confirmar que o arquivo foi recebido com sucesso.

#### **Passo 4: Fazer Upload dos Dados de Log**

Após confirmação da Netacea, você pode prosseguir com o upload do seu arquivo de log completo usando o mesmo comando:

```
aws s3 cp localtestfile.txt s3://name-of-bucket 
```

Certifique-se de:

* Substituir `/full/path/to/logfile.log` pelo caminho real do seu arquivo de log
* Usar o mesmo nome de bucket fornecido
* Garantir que o upload seja concluído sem erros.

### Conjunto de Dados Mínimo da Netacea

Para realizar uma Prova de Valor (PoV) bem-sucedida, o(s) arquivo(s) de log que você enviar deve(m) incluir os seguintes campos:

<table><thead><tr><th width="215">Campos Obrigatórios</th><th>Descrição</th></tr></thead><tbody><tr><td>Timestamp</td><td>O horário em que a requisição foi recebida</td></tr><tr><td>Endereço IP</td><td>O endereço IP de onde a requisição foi feita</td></tr><tr><td>User Agent</td><td>A string de user agent enviada no cabeçalho pelo cliente</td></tr><tr><td>Método</td><td>O método HTTP da requisição</td></tr><tr><td>Caminho</td><td>O caminho do recurso solicitado</td></tr><tr><td>Query</td><td>A query string da requisição</td></tr><tr><td>Status</td><td>O código de status HTTP retornado pelo servidor</td></tr><tr><td>Referrer</td><td>A página web de onde o usuário seguiu um link</td></tr><tr><td>Bytes Enviados</td><td>OS Bytes enviados como parte da resposta do servidor</td></tr><tr><td>Client JA3</td><td>Fingerprint JA3 do cliente (se disponível)</td></tr><tr><td>X-Forwarded-For*</td><td>Endereço IP de conexão [array] de uma requisição do cliente, se proxieda</td></tr><tr><td>True Client IP*</td><td>A fonte confiável do IP original do cliente</td></tr><tr><td>Host</td><td>O host de destino da requisição</td></tr><tr><td>Protocolo</td><td>O protocolo da requisição</td></tr><tr><td>Tempo da Requisição</td><td>O tempo total necessário para processar a requisição</td></tr></tbody></table>

\* Útil quando proxies estão na linha de tráfego do cliente > origem.

### Passos Finais

Uma vez que a entrega de logs esteja ativa, **notifique seu Engenheiro de Soluções da Netacea**. Isso nos permite:

* Confirmar o recebimento dos dados
* Validar o formato e completude do conjunto de dados
* Iniciar a análise assim que um volume suficiente de dados for coletado

Se você precisar de suporte durante a configuração, a equipe de SE da Netacea está aqui para ajudar — não hesite em entrar em contato.