Netskope Source
The Netskope Source collects alert and event data from a Netskope tenant. Cribl Stream pulls the records on a schedule through the Netskope REST API v2.
Type: Pull | TLS Support: Yes | Event Breaker Support: No
TLS is enabled through HTTPS on the Netskope API.
Prerequisites
This Source needs an active Leader for job management.
Configure a Netskope Source
- On the top bar, select Products, and then select Cribl Stream. Under Worker Groups, select a Worker Group. Next, you have two options:
- To configure via QuickConnect, navigate to Routing > QuickConnect. Select Add Source and select Netskope from the list, choosing either Select Existing or Add New.
- To configure via the Routes, select Data > Sources. Select Netskope. Next, select Add Source.
- In the New Source modal, configure the following under General Settings:
- Input ID: Enter a unique name to identify this Netskope Source definition. If you clone this Source, Cribl Stream adds
-CLONEto the original Input ID. - Description: Optionally, enter a description.
- API token (text secret): Select or create a stored text secret that contains the Netskope V2 API token.
- Netskope tenant URL: Enter the tenant base URL, such as
https://mycompany.goskope.com. Omit trailing slashes and API paths. - Tags: Metadata tags used for categorization and filtering in the Cribl Stream UI. These tags aren’t added to processed events. Use a tab or hard return between tag names.
- Input ID: Enter a unique name to identify this Netskope Source definition. If you clone this Source, Cribl Stream adds
- Under Content Types, configure Alerts and Events.
- Optionally, you can adjust the Processing, Retries, and Advanced settings, or Connected Destinations.
- Select Save, then Commit & Deploy.
Content Types
The Source collects two content types. You can change the schedule for each one. The cursor index is prefilled. Change it when you need a separate export cursor.
| Content type | What it collects | Default cron | Default job timeout |
|---|---|---|---|
| Alerts | DLP, malware, policy, quarantine, and related alerts | */15 * * * * | 300 seconds |
| Events | Application, audit, network, infrastructure, and related events | */5 * * * * | 300 seconds |
Processing Settings
Fields
In this section, you can define new fields or modify existing ones using JavaScript expressions, similar to the Eval function.
- The Field Name can either be a new field (unique within the event) or an existing field name to modify its value.
- The Value is a JavaScript expression (enclosed in quotes or backticks) to compute the field’s value (can be a constant). Select this field’s advanced mode icon (far right) if you’d like to open a modal where you can work with sample data and iterate on results.
This flexibility means you can:
- Add new fields to enrich the event.
- Modify existing fields by overwriting their values.
- Compute logic or transformations using JavaScript expressions.
Pre-Processing
Auto parse: Toggle on to detect each event’s Datatype and extract top-level fields from _raw before Source Fields and before the pre-processing Pipeline or Pack. The toggle is off by default. Because Fields runs after automatic parsing, values you add there take precedence over same-named fields extracted from _raw. For Datatypes that automatic parsing can detect, see the List of Stock v2 Datatypes. For field behavior, prevention of duplicate parsing, and performance considerations, see Automatic Parsing.
Pipeline: Select an existing Pipeline or Pack to process data from this Source before routing.
Retries
Adjust how failed HTTP requests are retried.
Retry type: Defaults to Backoff.
Initial retry interval (ms): Time between the failed request and the first retry. Defaults to 1000. Maximum 20000.
Retry limit: Maximum number of retries for a failed request. Defaults to 5.
Backoff multiplier: Defaults to 2.
Retry HTTP codes: Defaults to 429, 500, and 503.
Honor Retry-After header: Defaults to toggled on. Cribl Stream caps the delay at 20 seconds.
Retry connection timeout: Toggle on to retry once after a connection timeout (ETIMEDOUT). Defaults to toggled off.
Retry connection reset: Toggle on to retry after a connection reset (ECONNRESET). Defaults to toggled off.
Advanced Settings
Request timeout (seconds): HTTP inactivity timeout. Defaults to 60. Enter 0 to disable the timeout.
Time to live: How long to keep the job’s artifacts on disk after the job finishes. This also controls how long the job stays in Job Inspector. Defaults to 4h.
Environment: If you’re using GitOps, optionally use this field to specify a single Git branch on which to enable this configuration. If empty, the configuration is enabled everywhere.
Connected Destinations
Select Send to Routes to enable conditional routing, filtering, and cloning of this Source’s data via the Routing table.
Select QuickConnect to send this Source’s data to one or more Destinations via independent, direct connections.
Troubleshooting
The Source’s configuration modal has helpful tabs for troubleshooting:
Live Data: Try capturing live data to see real-time events as they are ingested. On the Live Data tab, click Start Capture to begin viewing real-time data.
Logs: Review and search the logs that provide detailed information about the ingestion process, including any errors or warnings that may have occurred.
You can also view the Monitoring page that provides a comprehensive overview of data volume and rate, helping you identify ingestion issues. Analyze the graphs showing events and bytes in/out over time.