Dashboard filters

Customize the traffic dashboard display using a variety of filter options. Filter groups can be added enabling you to refine data by categories such as API resources, status codes, request paths, tags, headers, and more. Additionally, filters can be tailored by timeframes and saved for future use, providing a comprehensive approach to data management and analysis.

The following filter types are available:

• Resource: API, APP, Log Source, Request
• Request IP Address, Execution Time, Domain Name, Path, Resource Path, Tags, Method, URI, Header, Path Parameter, Query String, OAuth Sub ID, Log ID
• ‍Metrics: Header Size (Request/Response), Payload Size (Request/Response), GraphQL Field Count, GraphQL Max Depth, GraphQL Total Complexity
• ‍Response: Status Code, Header
• ‍User Agent: Browser Name, Browser Version, Device Name, Operating System Name, Operating System Version
• ‍Location: AS Number, AS Full Name, City, Continent, Continent Code, Country, Country Code, Currency, District, Hosting Provider, Proxy IP, Mobile ISP, Latitude, Longitude, Timezone, ASN Organization, ZIP Code

Create a filter

1. Click Add Filter Group.
2. Select the required element from the Type dropdown.
3. Choose the appropriate Operator.
4. Enter a Value, or select a value from the dropdown.
5. Click Submit.
6. Select Include or Exclude (Include is selected by default) to determine if the requests displayed in the dashboard must include or exclude the conditions defined in the filter.

To add any further conditions to this filter, click Add. To add any additional filters click Add filter group and enter the values for the condition.

Modify a filter

• To edit a condition:
  • Click the condition, make changes to Type, Operator, or Value, then click Submit.
• To delete a condition:
  • Click the condition, then Delete, and confirm.
• To reset all filters:
  • Click Reset.

Alerts

Alerts can be created directly from the Dashboard. When creating an alert with a filter applied, the alert will include the selected filter’s conditions. To receive an alert, first create a notification integration. Click Create Alert on the Dashboard to create a static alert. Follow the prompts to set up an alert. Learn more about how to create an alert.

Save and load filters

To save a filter for future use:

1. Create your filters.
2. Click Save.

3. Enter a name in the Filter Name field.

4. Click Save.

To load a saved filter:

1. Click Load filters.
2. Use the filter view toggle to select between:
   • My Filters: Displays only the filters you have personally created.
   • All Filters: Displays all filters created by any user in your organization, allowing you to leverage shared filters for broader insights or team collaboration.
3. Select the filter you want to apply.
4. Click Load.

Tags

Tags are labels automatically applied to requests to help classify, detect, and analyze traffic based on content, security risks, authentication, language, and more. Tags can be used as filters on the traffic dashboard to include or exclude requests with specific characteristics. You can view the complete list of all available tags on the Tags reference page.

Example: Adding a filter for PII and sensitive data

If you want to monitor all requests that contain Personally Identifiable Information (PII) such as email addresses and also those requests that include sensitive API keys or tokens. You can create a filter group targeting those tags

1. Click on Add Filter Group on the dashboard.
2. From the Type dropdown, select Tags.
3. In the Operator dropdown, choose is one of (to include multiple tag options).
4. In the Value dropdown, select the following tags related to PII and sensitive data:
   
   • PII: Email address present
   • PII: Email address present in input
   • PII: Email address present in output
   • Request contains an AWS Secret Access Key
   • Request contains a JWT Token
   • Request contains a Google OAuth Access Token
   • Request contains a Stripe API Key
   • Add any other sensitive data tags you want to monitor
5. Click Submit.

Additional filter examples

Example 1: Create a filter that excludes 404 response codes on the dashboard.

1. Click Add filter group.
2. Select Status Code from the Type dropdown.
3. Choose is not one of from the Operator dropdown.
4. Select 404 as the Value.
5. Click Submit.

Example 2: Create a filter to only display requests with a 200 response code but exclude any of those responses that have a request path of /health.

1. Click Add filter group.
2. Select Status Code from the Type dropdown.
3. Choose is from the Operator dropdown.
4. Select 200 as the Value.
5. Click Submit.
6. Click Add condition.
7. Select Path from the Type dropdown.
8. Choose is not from the Operator dropdown.
9. Enter /health as the Value.
10. Click Submit.

Filter by time

The dashboard can be filtered by a timeframe selected from the Duration selector dropdown:

• Last 7 days
• Last 3 days
• Last day
• Custom: Enter a specific Start and End date

Polling interval

The Polling Interval controls how often the dashboard reloads data from the API (in minutes). Select the desired interval from the dropdown to keep the display updated at your preferred frequency.