Netskope Transaction Events

You will need a subscription endpoint URL and subscription key to access the streamed events.

To retrieve the subscription key and path:

Transaction events are stored in Google PubSubLite by Netskope ingestion services. Once the transaction events feature is enabled in your account, you can consume the data using the subscription endpoint URL and subscription key retrieved using the token/transaction_events API. This enables you to query metrics once your account is configured to receive the transaction events.

API returns data for the following PubSubLite metrics:

subscription/backlog_message_count: Number of messages that have been sent to a PubSubLite subscription but have not yet been acknowledged by any consumer configured by customers.

subscription/oldest_unacked_message_age: The age of the oldest unacknowledged message in a PubSubLite subscription e.g., How long the oldest unacknowledged message has remained unacknowledged.

The API returns hourly buckets equivalent to hours parameter value. The default value is 24 Hours and the maximum value is one week: 168 Hours. Time Series buckets maintain the ascending order e.g., the latest hour data is the last data point.

Follow the steps below to retrieve transaction events metrics for your account.

1. Navigate to Settings > Tools > REST API v2 > New Token. The Crest REST API Token window displays.

2. Click the Add Endpoint dropdown and select the /api/v2/events/metrics/transactionevents endpoint to create the API token.

   

3. Select the Read radio button in the Privilege column.

4. Click Save. A confirmation box displays stating the token creation is successful.

   

5. Click Copy Token to save it for later use in your API requests and add it to the Netskope API token header.

6. Go 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 Authorize, the Available Authorizations pop-up opens, paste the saved token in the Value field and click Authorize.

   

7. From the Swagger UI tab, under to the Events section, navigate to the /api/v2/events/metrics/transactionevents endpoint and click the line. The details display, click Try it out. Select Parameters section > type a number in the query field > click Execute.

   

8. Upon successful execution, the response will carry the transaction events metrics details.

Once the transaction events feature is enabled in your account, you’ll be able to consume the data from the subscription endpoint.

To receive the events from the subscription, refer to the Receiving messages from Lite subscriptions link .

The Netskope SDK also provides an example of using the REST API v2 token as authentication which provides the subscription endpoint URL and subscription key internally to use the Google SDK.

In addition, you can receive messages with various Client libraries. Netskope retains transaction events for seven days by default if not consumed.

There are different access methods for transaction events:

The enhanced transaction events streaming is delivered through a streaming mechanism. 

The transaction event near real-time subscription messages have the following format:

Attributes

Data

Refer to the sample code to receive and decode the transaction events.

The Netskope App (Add-on) for Splunk has dashboards for visualization of Events, Alerts, and Web Transaction details. This information is populated on the dashboard.

Users can get  information related to data collected in addition to transforming and parsing data with the Add-on app available from splunkbase.

Click the following links to set up the Netskope Splunk Integration:

Netskope Cloud Exchange is available for download on GitHub and accompanying installation documentation is available:

Transaction Events are retained in the streaming service for up to seven days for admins to pull, for error recovery on the customer client side. The data is kept in a series of files by the streaming service. The garbage collection service will remove all files older than seven days, with the exception of the most recent data file.

For most customers during normal operational load, there will be numerous data files in a given hour. However, for some customers with a small data volume, (e.g. who have not implemented Netskope widely or in an active proof of concept phase), the most recent data file might accumulate events for more than seven days resulting in a longer data retention period.