# Universelle Log-Übertragung

## Netacea Universal Offline POV Guide

Um Protokolldaten zur Analyse an Netacea zu senden, wenn Echtzeit-Streaming oder Plattformintegrationen nicht praktikabel sind, können Sie die **AWS Command Line Interface (CLI)** verwenden, um einen einmaligen Upload in einen sicheren, von Netacea gehosteten Amazon S3-Bucket durchzuführen. Nachfolgend finden Sie die dokumentierten Schritte zur Installation und Verwendung der AWS CLI für eine sichere Datenübertragung.

### Voraussetzungen

Um eine Offline-Protokollübertragung an Netacea erfolgreich abzuschließen, stellen Sie bitte Folgendes sicher:

* Die **AWS CLI** ist installiert und funktioniert nachweislich auf Ihrem Rechner.
* Sie haben die erforderlichen S3-Bucket-Details (Bucket-Name und ARN) von Netacea erhalten. Diese finden Sie [hier](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide).
* Sie haben eine **Testdatei** erstellt, mit der die Verbindung vor der Übertragung der eigentlichen Daten validiert werden kann.
* Sie verwenden einen Rechner, der:
  * **Befehlszeilenzugriff** ermöglicht
  * Die **Berechtigung zur Installation und Ausführung von CLI-Tools** hat
  * **Zugriff auf die Protokolldatei(en)** hat, die hochgeladen werden sollen

{% hint style="info" %}
Sie müssen keine S3-Bucket-Infrastruktur oder zugehörige Anmeldedaten bereitstellen, da diese Ihnen zur Verfügung gestellt werden.
{% endhint %}

#### Schritt 1: AWS CLI installieren

Laden Sie die AWS CLI von der offiziellen Quelle basierend auf Ihrem Betriebssystem herunter:

* **Windows (64-Bit)**
* **macOS (PKG-Installationsprogramm)**
* **Linux (Installationsprogramm)**
* **Amazon Linux (AMI)**

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

Führen Sie nach dem Download das Installationsprogramm aus und folgen Sie den Anweisungen auf dem Bildschirm.

Um die erfolgreiche Installation zu bestätigen, führen Sie den folgenden Befehl in Ihrem Terminal oder Ihrer Eingabeaufforderung aus:

```
aws --version
```

#### **Schritt 2: AWS CLI konfigurieren**

Verwenden Sie die bereitgestellten Anmeldedaten, um Ihre Umgebung einzurichten:

```
aws configure
```

Anschließend werden Sie aufgefordert, einige zusätzliche Details einzugeben. Die folgende Tabelle erläutert, welche Informationen benötigt werden und wo diese zu finden sind:

<table><thead><tr><th width="245">Name</th><th>Wert</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Wird vom Netacea <a href="https://portal.netacea.com/">Admin-Portal</a> bereitgestellt</td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Wird vom Netacea <a href="https://portal.netacea.com/">Admin-Portal</a> bereitgestellt</td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **Schritt 3: Zugriff mit einer Beispieldatei testen**

Stellen Sie sicher, dass Sie eine kleine Testdatei erstellt haben (diese kann leer sein), um den Zugriff zu überprüfen:

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

* Ersetzen Sie `/full/path/to/testfile.txt` durch den tatsächlichen Pfad zu Ihrer Testdatei
* Ersetzen Sie `<bucket-name>` durch den von Netacea bereitgestellten S3-Bucket-Namen

Kontaktieren Sie nach dem Upload das **Netacea Solutions Engineering Team**, um zu bestätigen, dass die Datei erfolgreich empfangen wurde.

#### **Schritt 4: Protokolldaten hochladen**

Nach der Bestätigung von Netacea können Sie mit dem Upload Ihrer vollständigen Protokolldatei mit demselben Befehl fortfahren:

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

Stellen Sie sicher, dass Sie:

* `/full/path/to/logfile.log` durch den tatsächlichen Pfad zu Ihrer Protokolldatei ersetzen
* Denselben Bucket-Namen wie bereitgestellt verwenden
* Sicherstellen, dass der Upload ohne Fehler abgeschlossen wird.

### Netacea Mindestdatensatz

Um einen erfolgreichen Proof of Value (PoV) durchzuführen, müssen die von Ihnen hochgeladenen Protokolldatei(en) die folgenden Felder enthalten:

<table><thead><tr><th width="215">Erforderliche Felder</th><th>Beschreibung</th></tr></thead><tbody><tr><td>Timestamp</td><td>Der Zeitpunkt, zu dem die Anfrage empfangen wurde</td></tr><tr><td>IP Address</td><td>Die IP-Adresse, von der die Anfrage gestellt wurde</td></tr><tr><td>User Agent</td><td>Der vom Client im Header gesendete User-Agent-String</td></tr><tr><td>Method</td><td>Die HTTP-Methode der Anfrage</td></tr><tr><td>Path</td><td>Der Pfad der angeforderten Ressource</td></tr><tr><td>Query</td><td>Der Query-String der Anfrage</td></tr><tr><td>Status</td><td>Der vom Server zurückgegebene HTTP-Statuscode</td></tr><tr><td>Referrer</td><td>Die Webseite, von der der Benutzer einem Link gefolgt ist</td></tr><tr><td>Bytes Sent</td><td>Die als Teil der Serverantwort gesendeten Bytes</td></tr><tr><td>Client JA3</td><td>JA3-Fingerabdruck des Clients (falls verfügbar)</td></tr><tr><td>X-Forwarded-For*</td><td>Verbindende IP-Adresse [Array] einer Client-Anfrage, falls über Proxy geleitet</td></tr><tr><td>True Client IP*</td><td>Die vertrauenswürdige Quelle der ursprünglichen Client-IP</td></tr><tr><td>Host</td><td>Der Ziel-Host der Anfrage</td></tr><tr><td>Protocol</td><td>Das Protokoll der Anfrage</td></tr><tr><td>Request Time</td><td>Die gesamte Zeit, die für die Verarbeitung der Anfrage benötigt wurde</td></tr></tbody></table>

\* Nützlich, wenn sich Proxys im Datenverkehrspfad zwischen Client und Origin befinden.

### Abschließende Schritte

Sobald die Protokollübermittlung aktiv ist, **benachrichtigen Sie Ihren Netacea Solutions Engineer**. Dies ermöglicht uns:

* Den Datenempfang zu bestätigen
* Das Datensatzformat und die Vollständigkeit zu validieren
* Mit der Analyse zu beginnen, sobald ein ausreichendes Datenvolumen gesammelt wurde

Wenn Sie während der Einrichtung Unterstützung benötigen, steht Ihnen das Netacea SE-Team gerne zur Verfügung — zögern Sie nicht, uns zu kontaktieren.