# Yleinen lokisiirto

## Netacea Universaali offline-POV-opas

Kun haluat lähettää lokidataa Netaecealle analysoitavaksi eikä reaaliaikainen suoratoisto tai alustaintegraatiot ole mahdollisia, voit käyttää **AWS Command Line Interface (CLI)** -työkalua suorittaaksesi kertaluonteisen latauksen turvalliseen Netaecean ylläpitämään Amazon S3 -säilöön. Alla on dokumentoidut vaiheet, jotka tarvitaan AWS CLI:n asentamiseen ja käyttämiseen turvallisen siirron suorittamiseksi.

### Edellytykset

Suorittaaksesi offline-lokisiirron Netaecealle onnistuneesti, varmista seuraavat asiat:

* **AWS CLI** on asennettu ja vahvistettu toimivaksi koneellasi.
* Olet saanut tarvittavat S3-säilön tiedot (säilön nimi ja ARN) Netaecealta. Nämä löytyvät [täältä](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Olet luonut **testitiedoston**, jolla voit vahvistaa yhteyden ennen varsinaisen datan siirtoa.
* Käytät konetta, joka:
  * Sallii **komentorivikäytön**
  * Antaa **luvan asentaa ja suorittaa CLI-työkaluja**
  * Pääsee käsiksi **ladattaviksi tarkoitettuihin lokitiedostoihin**

{% hint style="info" %}
Sinun ei tarvitse perustaa mitään S3-säilön infrastruktuuria tai siihen liittyviä tunnistetietoja, sillä nämä toimitetaan sinulle.
{% endhint %}

#### Vaihe 1: Asenna AWS CLI

Lataa AWS CLI virallisesta lähteestä käyttöjärjestelmäsi mukaan:

* **Windows (64-bittinen)**
* **macOS (PKG-asennusohjelma)**
* **Linux (asennusohjelma)**
* **Amazon Linux (AMI)**

👉 [AWS CLI:n latauslinkki](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

Latauksen jälkeen suorita asennusohjelma ja seuraa näytön ohjeita.

Vahvistaaksesi onnistuneen asennuksen, suorita seuraava komento terminaalissa tai komentokehotteessa:

```
aws --version
```

#### **Vaihe 2: Määritä AWS CLI**

Käytä toimitettuja tunnistetietoja ympäristösi määrittämiseen:

```
aws configure
```

Tämän jälkeen sinua pyydetään syöttämään joitakin lisätietoja. Alla oleva taulukko selittää, mitä tietoja tarvitaan ja mistä ne löytyvät:

<table><thead><tr><th width="245">Nimi</th><th>Arvo</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Saadaan Netaecean <a href="https://portal.netacea.com/">hallintaportaalista</a></td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Saadaan Netaecean <a href="https://portal.netacea.com/">hallintaportaalista</a></td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Vaihe 3: Testaa pääsy testitiedostolla**

Varmista, että olet luonut pienen testitiedoston (se voi olla tyhjä) pääsyn vahvistamiseksi:

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

* Korvaa `/full/path/to/testfile.txt` testitiedostosi todellisella polulla
* Korvaa `<bucket-name>` Netaecean toimittamalla S3-säilön nimellä

Latauksen jälkeen ota yhteyttä **Netaecean Solutions Engineering -tiimiin** vahvistaaksesi, että tiedosto vastaanotettiin onnistuneesti.

#### **Vaihe 4: Lataa lokidata**

Saatuasi vahvistuksen Netaecealta voit jatkaa täyden lokitiedoston lataamisella samalla komennolla:

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

Muista:

* Korvata `/full/path/to/logfile.log` lokitiedostosi todellisella polulla
* Käyttää samaa säilön nimeä kuin toimitettu
* Varmistaa, että lataus valmistuu ilman virheitä.

### Netaecean vähimmäistietojoukko

Suorittaaksesi onnistuneen Proof of Value (PoV) -todennuksen, ladattavien lokitiedostojen tulee sisältää seuraavat kentät:

<table><thead><tr><th width="215">Pakolliset kentät</th><th>Kuvaus</th></tr></thead><tbody><tr><td>Aika</td><td>Ajankohta, jolloin pyyntö vastaanotettiin</td></tr><tr><td>IP-osoite</td><td>IP-osoite, josta pyyntö tehtiin</td></tr><tr><td>Käyttäjäagentti</td><td>Asiakkaan otsikossa lähettämä käyttäjäagenttimerkkijono</td></tr><tr><td>Metodi</td><td>Pyynnön HTTP-metodi</td></tr><tr><td>Polku</td><td>Pyydetyn resurssin polku</td></tr><tr><td>Kysely</td><td>Pyynnön kyselymerkkijono</td></tr><tr><td>Tila</td><td>Palvelimen palauttama HTTP-tilakoodi</td></tr><tr><td>Viittaaja</td><td>Sivu, jolta käyttäjä seurasi linkkiä</td></tr><tr><td>Lähetetyt tavut</td><td>Palvelimen vastauksena lähetetyt tavut</td></tr><tr><td>Client JA3</td><td>Asiakkaan JA3-sormenjälki (jos saatavilla)</td></tr><tr><td>X-Forwarded-For*</td><td>Asiakaspyynnön yhdistävä IP-osoite [taulukko], jos välitetty välityspalvelimen kautta</td></tr><tr><td>True Client IP*</td><td>Luotettu lähde alkuperäiselle asiakkaan IP-osoitteelle</td></tr><tr><td>Isäntä</td><td>Pyynnön kohdeisäntä</td></tr><tr><td>Protokolla</td><td>Pyynnön protokolla</td></tr><tr><td>Pyyntöaika</td><td>Kokonaisaika, joka kului pyynnön käsittelyyn</td></tr></tbody></table>

\* Hyödyllinen, kun välityspalvelimet ovat liikenteen reitillä asiakkaalta > alkupalvelimelle.

### Viimeiset vaiheet

Kun lokien toimitus on aktiivinen, **ilmoita Netaecean Solutions Engineerille**. Tämä mahdollistaa meille:

* Datan vastaanoton vahvistamisen
* Tietojoukon muodon ja täydellisyyden validoinnin
* Analyysin aloittamisen, kun riittävä määrä dataa on kerätty

Jos tarvitset tukea asennuksen aikana, Netaecean SE-tiimi on valmiina auttamaan — älä epäröi ottaa yhteyttä.