現在 トランザクションイベントストリーミングをご利用のお客様には、 Netskope Log Streaming, への移行をお願いしております。 はNetskopeの 統合ログ配信ソリューションであり、柔軟性の向上、イベントのカバレッジの拡大、下流システムとの統合の簡素化を実現します。
HTTPトランザクションイベントは、企業がクラウド製品を採用していく上で、より詳細な可視性を確保するために不可欠です。Netskopeは既に、ページやアプリのイベントなどを集約・要約することで、「ノイズの多い」ウェブトラフィックを回避する機能を提供しています。ロールアップビューは管理者にとって非常に便利であり、さらにトランザクションイベントはユーザーがアクセスしたウェブサイトに関する詳細な情報を提供します。
トランザクションイベントの設定
ストリーミング イベントにアクセスするには、サブスクリプション エンドポイント URL とサブスクリプション キーが必要です。
サブスクリプションキーとパスを取得するには：
- Settings > Tools > REST API v2 > New Tokenに移動します。「REST APIトークンの作成」ウィンドウが表示されます。
- Click the Add Endpoint dropdown and select the /api/v2/events/token/transaction_events endpoint to create the API token.
- 「権限」列で「 ReadラジオボタンSelect 。
- Saveをクリックしてください。トークンの作成が成功したことを示す確認ボックスが表示されます。
- Copy Tokenをクリックして保存してください APIリクエストで使用し、 Netskope APIトークンヘッダーに追加してください。
- Navigate to REST API v2 > API Documentation. A new Swagger UI tab will open. You can access the API Documentation from the Create REST API Token window as well. Click
, the Available Authorizations pop-up opens, paste the saved token in the Value field and click Authorize.
- Swagger UI タブのEventsセクションから、 /api/v2/events/token/transaction_eventsエンドポイントに移動して、その行をクリックします。詳細を表示するには、 Try it outをクリックしてください。ドロップダウンメニューでdecodeセクション> true Select 、 Executeをクリックします。
正常に実行されると、レスポンスにはサブスクリプションキーとサブスクリプションパスが含まれます。
クエリトランザクションイベントメトリクス
トランザクションイベントは、Netskopeの取り込みサービスによってGoogle PubSubLiteに保存されます。アカウントでトランザクション イベント機能が有効になると、サブスクリプション エンドポイント URL を使用してデータを使用し、 token/transaction_events API を使用して取得したサブスクリプション キーを使用できるようになります。 アカウントがトランザクションイベントを受信するように設定されると、これによりメトリクスを照会できるようになります。
APIは、以下のPubSubLiteメトリクスのデータを返します。
subscription/backlog_message_count: PubSubLiteサブスクリプションに送信されたものの、顧客によって設定されたコンシューマーによってまだ確認応答されていないメッセージの数。
subscription/oldest_unacked_message_age: PubSubLite サブスクリプション内の未確認の最も古いメッセージの経過時間。例: 最も古い未確認のメッセージが未確認のままになっている期間。
APIは、hoursパラメータの値に対応する時間単位のデータを返します。デフォルト値は24時間で、最大値は1週間（168時間）です。時系列バケットは昇順を維持します。例えば、最新の1時間分のデータは最後のデータポイントになります。
アカウントの取引イベント指標を取得するには、以下の手順に従ってください。
-
Settings > Tools > REST API v2 > New Tokenへ移動してください。「REST APIトークンの作成」ウィンドウが表示されます。
-
Click the Add Endpoint dropdown and select the /api/v2/events/metrics/transactionevents endpoint to create the API token.
-
「権限」列で「 ReadラジオボタンSelect 。
-
Saveをクリックしてください。トークンの作成が成功したことを示す確認ボックスが表示されます。
-
Copy Tokenをクリックして保存してください APIリクエストで使用し、 Netskope APIトークンヘッダーに追加してください。
-
REST API v2 > API Documentationへ移動してください。新しい Swagger UI タブが開きます。 APIドキュメントは、「REST APIトークンの作成」ウィンドウからもアクセスできます。Authorizeクリックすると、「利用可能な認証」ポップアップが開きます。 Valueフィールドに保存したトークンを貼り付けて、 Authorizeをクリックします。
-
Swagger UIタブのEventsセクションから/api/v2/events/metrics/transactioneventsエンドポイントに移動し、ラインをクリックします。詳細を表示するには、 Try it outをクリックしてください。SelectParametersセクション>クエリ欄に数字を入力し>クリックExecute。
-
処理が正常に完了すると、レスポンスにはトランザクションイベントのメトリクス詳細が含まれます。
サブスクリプションエンドポイントを生成する別の方法
Netskope UIにログインしてSettings > Tools > Event Streamingに移動してください。サブスクリプションのエンドポイントをコピーし、イベントストリーミングページからダウンロードキーを生成してください。
古い購読パスとキーの有効期限が切れました。新しいサブスクリプション パスを使用すると、イベント ストリーミングは保持期間の開始日 (デフォルトでは 7 日前) から新たに開始されます。
トランザクションイベントの消費
アカウントでトランザクションイベント機能が有効になると、サブスクリプションエンドポイントからデータを利用できるようになります。
サブスクリプションからイベントを受信するには、 「Liteサブスクリプションからのメッセージの受信」リンクを参照してください。
Netskope SDK は、 Google SDKを使用するためにサブスクリプション エンドポイント URL とサブスクリプション キーを内部的に提供する認証として REST API v2 トークンを使用する例も提供します。
さらに、さまざまなクライアントライブラリを使用してメッセージを受信できます。Netskopeは、トランザクションイベントが消費されない場合、デフォルトで7日間保持します。
トランザクションイベントには、さまざまなアクセス方法があります。
- Google SDK
- NetskopeとSplunkの連携
- Netskope Cloud Exchange
Google SDK
強化されたトランザクションイベントのストリーミングは、ストリーミングメカニズムを通じて配信されます。
トランザクションイベントのニアリアルタイム購読メッセージは、以下の形式をとります。
Attributes
- コンテンツエンコーディング。gzip – 現在利用可能な唯一の値
- Log-Count – メッセージデータに含まれるイベントの数
- フィールド – 各トランザクションイベントのトランザクションイベントフィールド
Data
- メッセージデータには、gzipで圧縮されたトランザクションイベントが含まれています。
トランザクションイベントを受信してデコードする方法については、サンプルコードを参照してください。
NetskopeとSplunkの連携
Splunk 用のNetskopeアプリ (アドオン) には、イベント、アラート、およびウェブ トランザクションの詳細を視覚化するためのダッシュボードがあります。 この情報はダッシュボードに表示されます。
ユーザーは、splunkbaseから入手できるアドオンアプリを使用することで、データの変換や解析に加えて、収集したデータに関連する情報を取得できます。
NetskopeとSplunkの連携を設定するには、以下のリンクをクリックしてください。
- Netskope Splunkアプリのインストールと設定ガイド
- Netskope 用 Splunk アドオン:
重要
2.X チェーン内でのアップグレードがサポートされています。バージョン1.Xから移行する場合は、バージョン2.Xをインストールする前に1.Xをアンインストールしてください。
- Splunk Netskope ダッシュボードはsplunkbaseから入手可能(任意):ここからダウンロード
Netskope Cloud Exchange
Netskope Cloud ExchangeはGitHubからダウンロード可能で、インストール手順書も入手できます。
トランザクションイベントストリーミングサービスのデータ保持ポリシー
トランザクションイベントは、管理者が顧客クライアント側でのエラー回復のために取得できるよう、ストリーミングサービスに最大7日間保持されます。データはストリーミングサービスによって一連のファイルに保存される。ガベージコレクションサービスは、最新のデータファイルを除き、7日以上前のすべてのファイルを削除します。
ほとんどの顧客にとって、通常の運用負荷時には、1時間あたりに多数のデータファイルが生成されます。ただし、データ量が少ない一部の顧客（例えば、Netskopeを広く導入していない、または概念実証段階にある顧客）の場合、最新のデータファイルには7日以上のイベントが蓄積される可能性があり、その結果、データ保持期間が長くなることがあります。