このドキュメントでは、 Netskope Cloud Exchangeの Log Shipper モジュールを使用してローカル エクスポートを構成する方法について説明します。 このプラグインは、ウェブ トランザクション データをローカル ストレージ内の指定された場所に配信するために使用します。
前提条件
- Netskopeテナント（または、例えば本番環境と開発／テスト環境など、複数のテナント）。
- テナントプラグインとログシッパープラグインが既に設定されているNetskope Cloud Exchangeテナント。
- Netskope Cloud Exchangeテナントには、 AWS Netskope Log StreamingまたはAzure Netskope Log Streamingプラグインが既に構成されています（Netskope Log StreamingプラグインからWebTxを取得するため）。
プラグインスコープ
このプラグインは、Web トランザクション データをNetskope Cloud Exchangeがインストールされているローカル ストレージに配信するために使用します。
ローカルエクスポートプラグインのサポート
| データ型 | サポート |
|---|---|
イベント | いいえ |
| アラート | いいえ |
WebTx Logs | はい（Netskope Log Streaming経由） |
注記
- Google Pub Sub Lite をベースにした CLS WebTX は非推奨となりました。Netskope製品のサポート終了/サポート終了に関するお知らせについては、Netskopeナレッジポータルをご覧ください。
- WebTXログをSIEM、SOAR、XDR、データレイクなどのログ配信先に取り込むには、 AWS Netskope Log StreamingまたはAzure Netskope Log Streamingプラグインを使用します。
権限
- コンテナ内に、書き込み、実行権限を持つフォルダを作成するための許可。
- Dockerファイル内でフォルダをマウントするための権限（コンテナ外にデータを配置したい場合にのみ必要）。
パフォーマンスマトリックス
注記
このプラグインはWebTxデータの取り込みを扱うため、 大容量ストレージを備えた大規模なCloud Exchangeスタックをご利用いただくことをお勧めします。
ワークフロー
- コアコンテナの外部にディレクトリをマウントします。
- ローカルエクスポートプラグインを設定します。
- ローカルエクスポートプラグインのログ配信を設定します。
- プラグインを検証してください。
再生ボタンをクリックして動画をご覧ください。
コアコンテナ外にディレクトリをマウントする
マウント機能を利用することで、コンテナ自体にアクセスすることなく、コアコンテナからデータを取得できます。さらに、コンテナがシャットダウンした場合、コンテナ内のすべてのデータは削除されます。
コンテナをフォルダ付きでマウントするには、以下の手順に従ってください。
- CEがインストールされているマシンにログインしてください。
- コンテナの外側にデータを保存したいフォルダを作成します。
- 作成したフォルダに移動し、
pwdコマンドを実行してそのフォルダのパスを取得し、そのパスをコピーしてください。マウント時に必要になります。
- Netskope CEがインストールされているフォルダに移動してください。
- Run this command to edit the docker-compose.yml file:
vi docker-compose.yml.
- docker-compose.ymlの中で、
core:に移動し、volumes:の下に、:で区切られた左側のフォルダのパスを含む新しい行を追加し、WebTx データを収集するコンテナ内のパスを入力します。
パスは/home/devuser/WebTx_Data:/opt/Local_Export.
のようになります。
- それでは、Dockerコンテナの中に入り、データを収集するための空のフォルダを作成してください。
Dockerコンテナ内に入るには、docker-compose exec -u 0 core sh.
を実行します。
- コンテナ内で、 docker-compose.yml ファイル内の使う名前(例えばLocal_Exportのフォルダ名)でフォルダを作成します。
- 使う と実行ファイルに許可を与える 使う:
chmod 777 -R Local_Export(Folder Name)。
- コンテナを終了します
exit。
- コア コンテナを再起動します
docker-compose restart core。
- プラグインの設定 コンテナ内に作成された同じディレクトリ。
ローカルエクスポートプラグインの設定
- Cloud ExchangeではSettings > Plugin Store.に移動します
- Local Export v1.0.0 (CLS)プラグインを検索して選択してください。
- 構成名を入力してください。
- Next .
をクリックしてください
- 以下のパラメータを入力してください。
- Storage Pathデータオブジェクトが保存されるストレージパス。
- Object Prefix: ストレージパスにプッシュする際のデータオブジェクト名のオブジェクトプレフィックス。オブジェクト接頭辞に「/」は使用できません。
- Maximum File Size (in MBs): ストレージパスに格納されるデータオブジェクトの最大サイズ。値は1から100の間である必要があります。
- Maximum Duration (in Seconds)データオブジェクトがストレージパスに保存される最大期間。
- Saveをクリックしてください。新しいプラグインはCloud Log Shipper > Pluginsページで利用可能になります。
ローカルエクスポートプラグインのログ配信を設定する
- Log Shipper > Log Deliveryに移動してAdd Log Delivery Configurationをクリックしてください。
- ソースプラグイン（AWS LogStreaming または Azure LogStreaming）、宛先プラグイン（ローカルエクスポート） Select 、 Saveをクリックします。
- ログ配信設定が追加されると、データはNetskopeテナントから取得され、変換され、コンテナフォルダ内に取り込まれます。
ローカルエクスポートプラグインを検証する
プッシュ通知を検証する
Cloud Exchange におけるプラグインのワークフローを検証する。
- Loggingに移動して、フィルターCLS Local Export [プラグイン名]を使用して取り込まれたイベントを検索します。
- 取り込まれたログはフィルタリングされます。
Dockerコンテナからのプッシュを検証するには、以下の手順に従ってください。
- Cloud Exchangeがインストールされているマシンにログインしてください。
- Cloud Exchangeがインストールされているフォルダに移動します。
docker-compose exec -u 0 core sh.
を実行します。
- プラグインの設定時に入力したストレージパスに移動してください。
ls.
を実行します。
- マウントされたディレクトリであれば、そのディレクトリも確認できます。
ローカルエクスポートプラグインのトラブルシューティング
フォルダにデータを取り込むための十分な権限があることを確認してください。
そうでない場合は、コンテナ内のそのフォルダにアクセス権限を与える必要があります。
- Cloud Exchangeがインストールされているマシンにログインしてください。
- Cloud Exchangeがインストールされているフォルダに移動します。
docker-compose exec -u 0 core sh.
を実行します。
- 権限を確認するには、
ls -l.
を実行してください。
- フォルダーに権限を与えるには、使う
chmod 777 -R Local_export(データを取り込みたいフォルダー)
制限事項
- このプラグインの機能はコンテナベースのデプロイメントに限定されており、 docker-compose.ymlファイルの編集を許可していないため、OVA デプロイメントでは動作しません。docker-compose.ymlファイルに必要な変更内容は、デプロイメントごとに異なります。必要な変更については、それぞれの導入ガイドを参照してください。
- このプラグインはWebTxデータをローカルに保存するため、膨大なストレージ容量を消費し、ストレージの問題を引き起こす可能性があります。