# Configuração de Monitoramento

## Pré-requisitos

Para transmitir com sucesso os logs de tráfego web para a Netacea, certifique-se de ter:

* Uma conta Akamai ativa com acesso completo ao Painel da Akamai.
* O Akamai DataStream 2 habilitado.

{% hint style="info" %}
O DataStream 2 está incluído na entrega de conteúdo e não possui custo adicional. Para habilitar esse recurso, entre em contato com a equipe de contas da Akamai.
{% endhint %}

* Fornecido uma lista de casos de uso de proteção e os caminhos vulneráveis a cada um.
* Fornecido uma lista de todos os usuários conhecidos, seguros e permitidos. Isso inclui uma lista de bots confiáveis, IPs e geolocalizações. Informações sobre agentes maliciosos conhecidos também são valiosas.
* Recebido os detalhes (caminho do bucket, nome, localização, credenciais) de um AWS S3 Bucket hospedado e fornecido pela Netacea.

## Configuração do DataStream 2

Siga a documentação da Akamai encontrada [aqui](https://techdocs.akamai.com/datastream2/docs/quick-start) para criar e ativar um stream do DataStream 2, com base na seguinte configuração:

### Etapa 1: Configuração

Use a aba **Configuration** para inserir os detalhes básicos do stream e escolher quaisquer propriedades que deseja monitorar.

### Etapa 2: Conjunto de Dados

Durante a etapa de configuração do Conjunto de Dados, use o seguinte conjunto de dados mínimo, definido pela Netacea:

| **Campo Obrigatório**                          | **Descrição**                                                                                                                                           |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Request time                                   | O horário em que a requisição foi recebida                                                                                                              |
| Bytes                                          | Os bytes enviados como parte da requisição do usuário                                                                                                   |
| Client IP                                      | O endereço IP de onde a requisição foi feita                                                                                                            |
| HTTP status codes                              | O código de status HTTP retornado pelo servidor                                                                                                         |
| Protocol type                                  | O protocolo do ciclo de requisição-resposta.                                                                                                            |
| Request host                                   | O valor do cabeçalho host na requisição                                                                                                                 |
| Request method                                 | O método HTTP da requisição                                                                                                                             |
| Request path                                   | O caminho do recurso solicitado                                                                                                                         |
| Query string                                   | A query string da requisição                                                                                                                            |
| User-Agent<mark style="color:red;">\*</mark>   | A string do user agent enviada no cabeçalho pelo cliente                                                                                                |
| Referer<mark style="color:red;">\*</mark>      | A página web da qual o usuário seguiu um link                                                                                                           |
| Turn around time                               | O tempo decorrido em milissegundos entre o recebimento do último cabeçalho da requisição e a escrita do primeiro byte da resposta no socket do cliente. |
| Custom field<mark style="color:red;">\*</mark> | Este campo suporta variáveis e é necessário para registrar campos personalizados específicos da Netacea.                                                |

{% hint style="info" %} <mark style="color:red;">\*</mark>Para monitorar esses campos, você precisa habilitar o registro de parâmetros personalizados do conjunto de dados no behavior **Log Request Details** da propriedade Akamai associada. Consulte [Log custom parameters](https://techdocs.akamai.com/datastream2/docs/log-custom-parameters) para mais detalhes.
{% endhint %}

{% hint style="warning" %}
Certifique-se de selecionar **JSON** como o formato de Log.
{% endhint %}

### Etapa 3: Entrega

* Selecione **Amazon S3** como Destino.
* Em **Name**, insira uma descrição legível para o destino.
* Em **Bucket**, insira o nome do S3 Bucket relevante hospedado pela Netacea.
* Em **Folder path**, preencha com "**logs/**", a menos que instruído de outra forma pela Netacea.
* Em **Region**, insira o código da região AWS onde o bucket está localizado. Deve ser eu-west-1 (tudo em minúsculas), a menos que instruído de outra forma pela Netacea.
* Em **Access key ID** e **Secret access key,** insira os valores associados ao bucket Amazon S3 fornecido pela Netacea.
* Clique em **Validate & Save** para validar a conexão com o destino e salvar os detalhes fornecidos.
* Certifique-se de que a **Push frequency** esteja definida para o menor valor possível.

### Etapa 4: Resumo e Ativação

Na aba **Summary**, revise todos os detalhes do stream que você configurou e certifique-se de seguir as instruções acima. Quando estiver pronto, marque a caixa **Activate stream upon saving** e clique em **Save stream.**

### Etapa 5: Habilitar o DataStream via Regra

A ativação de um stream **leva até uma hora**, mas ele só começará a coletar e transmitir dados após você adicionar e habilitar o [DataStream behavior](https://techdocs.akamai.com/datastream2/docs/enable-datastream-behavior) via uma Regra na configuração da propriedade que hospeda o site. Siga estas etapas para criar a Regra para habilitar seu DataStream:

* Crie uma nova versão da propriedade a partir da sua versão ativa existente e edite a versão recém-criada.
* Em **Property Configuration Settings,** selecione +Rules para criar uma nova Regra
* Selecione o **Blank Rule Template** e forneça um nome significativo para a regra antes de clicar em **Insert Rule**.<br>

  <figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-481665751f49c248bbbf7453af292208532af100%2Fimage%20(5)%20(4).png?alt=media" alt=""><figcaption></figcaption></figure>
* Na seção **Criteria**, adicione a seguinte regra de correspondência: `If Hostname is one of <hostname>`.

{% hint style="info" %}
Se a Netacea estiver monitorando múltiplos sites, você pode adicionar múltiplos hostnames. Inclua apenas hostnames que serão monitorados pelo DataStream criado anteriormente.
{% endhint %}

<figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-abf200ab839be8f43c24f23110fc719b3c059867%2Fimage%20(9)%20(3).png?alt=media" alt=""><figcaption><p>Critérios da Regra</p></figcaption></figure>

* Na seção **Behaviors**, adicione um behavior e **habilite** o DataStream que foi criado anteriormente.

{% hint style="info" %}
Uma Regra existente pode ser duplicada e reutilizada.
{% endhint %}

<figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-10d0e74a162432cba13d424d98267487b6e7a857%2Fimage%20(1)%20(1)%20(3).png?alt=media" alt=""><figcaption><p>Behaviors da Regra</p></figcaption></figure>

* Adicionalmente, adicione um novo behavior **Log Request Details**. Defina 'Include Custom Log Field' como 'on' e Custom Log Field como `{{user.PMUSER_NETACEA_DS2_CUSTOM_FIELD}}`

<figure><img src="https://3103183613-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FJ0VONni9fqVKgqwRyueW%2Fuploads%2Fgit-blob-904e3b8952ca40de8eb9533cf912bdc84f8ad8fb%2Fimage%20(11).png?alt=media" alt=""><figcaption><p>Log Request Details</p></figcaption></figure>

O DataStream e a Regra associada estão agora criados.

{% hint style="info" %}
**Repita o procedimento acima para cada site separado (ou grupo de sites) que a Netacea irá monitorar.**
{% endhint %}

## Ativar a Propriedade

Quando todos os DataStreams e Regras tiverem sido criados, clique em **Save** e use a aba **Activate** para ativar (implantar) suas alterações na configuração da propriedade.

{% hint style="success" %}
A configuração de monitoramento será agora implantada na propriedade contra a qual foi configurada. Você pode confirmar que a implantação está correta:

* Solicitando que a Netacea revise as métricas internas de monitoramento.
* Solicitando que a Netacea valide o conteúdo e formato dos dados.
  {% endhint %}