# ユニバーサルログ転送

## Netacea ユニバーサルオフライン POV ガイド

リアルタイムストリーミングやプラットフォーム連携が実現できない場合、ログデータを Netacea に送信して分析するために、**AWS Command Line Interface (CLI)** を使用して、セキュアな Netacea ホスティングの Amazon S3 バケットに一回限りのアップロードを行うことができます。以下は、AWS CLI をインストールして安全な転送を実行するために必要な手順を文書化したものです。

### 前提条件

Netacea へのオフラインログ転送を正常に完了するには、以下を確認してください：

* **AWS CLI** がインストールされ、お使いのマシンで動作することを確認済みであること。
* Netacea から必要な S3 バケットの詳細（バケット名と ARN）を受け取っていること。これらは[こちら](https://netacea.gitbook.io/portal-docs/user-guides-and-videos/portal-setup-and-log-shipping-guide)で確認できます。
* 実際のデータを転送する前に接続を検証するために使用できる**テストファイル**を作成済みであること。
* 以下の条件を満たすマシンを使用していること：
  * **コマンドラインアクセス**が可能
  * **CLI ツールのインストールと実行の権限**がある
  * アップロード対象の**ログファイルへのアクセス**が可能

{% hint style="info" %}
S3 バケットのインフラストラクチャや関連する認証情報をプロビジョニングする必要はありません。これらは提供されます。
{% endhint %}

#### ステップ 1：AWS CLI のインストール

お使いのオペレーティングシステムに基づいて、公式ソースから AWS CLI をダウンロードします：

* **Windows（64 ビット）**
* **macOS（PKG インストーラー）**
* **Linux（インストーラー）**
* **Amazon Linux（AMI）**

👉 [AWS CLI ダウンロードリンク](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html)

ダウンロード後、インストーラーを実行し、画面の指示に従ってください。

インストールが正常に完了したことを確認するには、ターミナルまたはコマンドプロンプトで次のコマンドを実行します：

```
aws --version
```

#### **ステップ 2：AWS CLI の設定**

提供された認証情報を使用して環境を設定します：

```
aws configure
```

その後、追加の詳細を入力するよう求められます。以下の表は、入力が必要な情報とその取得場所を説明しています：

<table><thead><tr><th width="245">名前</th><th>値</th></tr></thead><tbody><tr><td>AWS_ACCESS_KEY_ID</td><td>Netacea <a href="https://portal.netacea.com/">管理ポータル</a>から取得</td></tr><tr><td>AWS_SECRET_ACCESS_KEY</td><td>Netacea <a href="https://portal.netacea.com/">管理ポータル</a>から取得</td></tr><tr><td>AWS_DEFAULT_REGION</td><td>eu-west-1</td></tr></tbody></table>

#### **ステップ 3：サンプルファイルでアクセスをテスト**

アクセスを確認するために、小さなテストファイル（空でも可）を作成済みであることを確認してください：

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

* `/full/path/to/testfile.txt` をテストファイルの実際のパスに置き換えてください
* `<bucket-name>` を Netacea から提供された S3 バケット名に置き換えてください

アップロード後、**Netacea ソリューションエンジニアリングチーム**に連絡し、ファイルが正常に受信されたことを確認してください。

#### **ステップ 4：ログデータのアップロード**

Netacea からの確認後、同じコマンドを使用して完全なログファイルのアップロードに進むことができます：

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

以下を確認してください：

* `/full/path/to/logfile.log` をログファイルの実際のパスに置き換える
* 提供されたものと同じバケット名を使用する
* アップロードがエラーなく完了することを確認する

### Netacea 最小データセット

Proof of Value（PoV）を正常に実行するには、アップロードするログファイルに以下のフィールドが含まれている必要があります：

<table><thead><tr><th width="215">必須フィールド</th><th>説明</th></tr></thead><tbody><tr><td>Timestamp</td><td>リクエストが受信された時刻</td></tr><tr><td>IP Address</td><td>リクエストが行われた IP アドレス</td></tr><tr><td>User Agent</td><td>クライアントによってヘッダーで送信されたユーザーエージェント文字列</td></tr><tr><td>Method</td><td>リクエストの HTTP メソッド</td></tr><tr><td>Path</td><td>リクエストされたリソースのパス</td></tr><tr><td>Query</td><td>リクエストのクエリ文字列</td></tr><tr><td>Status</td><td>サーバーが返した HTTP ステータスコード</td></tr><tr><td>Referrer</td><td>ユーザーがリンクをたどってきた Web ページ</td></tr><tr><td>Bytes Sent</td><td>サーバーのレスポンスの一部として送信されたバイト数</td></tr><tr><td>Client JA3</td><td>クライアントの JA3 フィンガープリント（利用可能な場合）</td></tr><tr><td>X-Forwarded-For*</td><td>プロキシされている場合のクライアントリクエストの接続 IP アドレス [配列]</td></tr><tr><td>True Client IP*</td><td>オリジナルのクライアント IP の信頼できるソース</td></tr><tr><td>Host</td><td>リクエストの宛先ホスト</td></tr><tr><td>Protocol</td><td>リクエストのプロトコル</td></tr><tr><td>Request Time</td><td>リクエストの処理にかかった合計時間</td></tr></tbody></table>

\* クライアントからオリジンへのトラフィック経路にプロキシが存在する場合に有用です。

### 最終ステップ

ログ配信が有効になったら、**Netacea ソリューションエンジニアにご連絡ください**。これにより、以下が可能になります：

* データの受信を確認
* データセットのフォーマットと完全性を検証
* 十分な量のデータが収集された時点で分析を開始

セットアップ中にサポートが必要な場合は、Netacea SE チームがお手伝いいたします。お気軽にお問い合わせください。