# Amazon CloudFront

### Amazon CloudFront -lokien toimitus S3:een

Lähettääksesi käyttölokit Amazon CloudFrontista Amazon S3 -säilöön voit ottaa käyttöön CloudFrontin standardilokit. Alla on dokumentoidut tärkeät vaiheet, jotka keskittyvät ensisijaisesti standardilokitukseen, joka on yleisempi ja suoraviivaisempi menetelmä S3-pohjaiseen toimitukseen.

### **Edellytykset**

Verkkoliikenteen lokien onnistunutta suoratoistoa Netaecan palveluun varten varmista seuraavat asiat:

* Sinulla on aktiivinen AWS-tili ja pääsy AWS Management Consoleen.
* Amazon S3 -säilö on luotu ja määritetty vastaanottamaan lokeja CloudFrontista.
* Olet jakanut AWS-tilisi tunnuksen (Account ID) Netaecalle.

  > Tämä vaaditaan, jotta Netaeca voi soveltaa oikean säilökäytännön CloudFront-lokien vastaanottamiseksi.
* Olet saanut tarvittavat S3-säilön tiedot (säilön nimen ja ARN:n) Netaecalta. Nämä löytyvät [täältä](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Olet tietoinen Netaecan lokianalyysia varten vaatimista[ vähimmäistietokenttävaatimuksista](#netacea-minimum-required-dataset).

### Standardikäyttölokit (lokit S3:een)

Tämä vaihtoehto kirjaa jokaisen pyynnön ja toimittaa lokit erissä (tyypillisesti muutamasta minuutista tuntiin).

#### Vaihe 1: Anna Netaecalle AWS-tilisi tunnus

CloudFront-distribuutiollasi on oltava kirjoitusoikeus säilöön. Tämä edellyttää säilökäytäntöä, jonka on sisällettävä AWS-tilisi tunnus. Tämä on jaettava ennen kuin voimme vastaanottaa dataa.

**Esimerkki säilökäytännöstä:**

```
{
   "Version": "2012-10-17",
   "Statement":[
      {
        "Sid": "AllowCloudFrontLogs",
        "Effect": "Allow",
        "Principal": {
            "Service": "cloudfront.amazonaws.com"
         },
         "Action": "s3:PutObject",
         "Resource": "arn:aws:s3:::cloudfront-access-logs/*",
         "Condition": {
            "StringEquals": {
                "AWS:SourceAccount": "YOUR_AWS_ACCOUNT_ID"
           }
         }
      }
   ]
}
```

#### Vaihe 2: Ota lokitus käyttöön CloudFront-distribuutiossa

1. Avaa **AWS Management Console** → **CloudFront**.
2. Valitse distribuutiosi → siirry **Logging-välilehdelle**
3. Valitse **Add > Amazon S3 Bucket.**
4. Syötä S3-säilön tiedot Netaeca-portaalista (`arn:aws:s3:::bucketName`)
5. Siirry kohtaan Additional settings.
   1. Valitse kohdassa **Field selection** kentät, jotka lähetetään Netaecalle (katso[ Netaecan vaatima tietosisältö](#netacea-required-dataset) alla).
6. Tallenna muutokset.

### **Netaecan vaatima tietosisältö**

Onnistuneen POV:n suorittamiseksi Netaeca pyytää seuraavat tiedot analysoitavaksi:

<table><thead><tr><th width="142.33331298828125" valign="top">Vaadittu kenttä</th><th width="169" valign="top">AWS-kentän nimi</th><th valign="top">Kuvaus</th></tr></thead><tbody><tr><td valign="top">Aika</td><td valign="top">date</td><td valign="top">Pyynnön vastaanottoaika</td></tr><tr><td valign="top"></td><td valign="top">time</td><td valign="top">Pyynnön vastaanottoaika</td></tr><tr><td valign="top">IP-osoite</td><td valign="top">c-ip</td><td valign="top">IP-osoite, josta pyyntö tehtin</td></tr><tr><td valign="top">Käyttäjäagentti</td><td valign="top">cs-user-agent</td><td valign="top">Asiakkaan otsikossa lähettämä käyttäjäagenttimerkkijono</td></tr><tr><td valign="top">Metodi</td><td valign="top">cs-method</td><td valign="top">Pyynnön HTTP-metodi</td></tr><tr><td valign="top">Polku</td><td valign="top">cs-uri-stem</td><td valign="top">Pyydetyn resurssin polku</td></tr><tr><td valign="top">Kyselypätkä</td><td valign="top">cs-uri-query</td><td valign="top">Pyynnön kyselypätkä</td></tr><tr><td valign="top">Tila</td><td valign="top">sc-status</td><td valign="top">Palvelimen palauttama HTTP-tilakoodi</td></tr><tr><td valign="top">Viittaaja</td><td valign="top">cs(Referer)</td><td valign="top">Verkkosivu, jonka linkistä käyttäjä saapui</td></tr><tr><td valign="top">Lähetetyt tavut</td><td valign="top">cs-bytes</td><td valign="top">Palvelimen vastauksena lähetetyt tavut</td></tr><tr><td valign="top">Isäntä</td><td valign="top">cs(Host)</td><td valign="top">CloudFront-distribuution verkkotunnus</td></tr><tr><td valign="top">Protokolla</td><td valign="top">Protocol</td><td valign="top">Pyynnön protokolla</td></tr><tr><td valign="top">X forwarded for*</td><td valign="top">x-forwarded-for</td><td valign="top">Asiakaspyynnön yhdistävä IP-osoite [taulukko], jos välitettynä</td></tr><tr><td valign="top">True-Client-IP*</td><td valign="top">True-Client-IP</td><td valign="top">Luotettu lähde alkuperäiselle asiakas-IP:lle</td></tr><tr><td valign="top">Pyyntöaika</td><td valign="top">time-taken</td><td valign="top">Kokonaisaika (sekunneissa), joka CloudFrontilla kului pyynnön palvelemiseen</td></tr></tbody></table>

\* Hyödyllinen, kun välityspalvelimia on liikenteen reitillä asiakkaalta > alkuperälle

### Viimeiset vaiheet

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

* Datan vastaanoton vahvistamisen
* Tietosisällön muodon ja täydellisyyden validoinnin
* Analyysin aloittamisen, kun riittävä datamäärä on kerätty

Jos tarvitset tukea asennuksen aikana, Netaecan SE-tiimi on täällä auttamassa — älä epäröi ottaa yhteyttä.