AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter
Join our community

Actions277

Overview

This node operation, Traffic Reports Total Applications Collections Stats, retrieves aggregated traffic report statistics related to applications and collections within a network environment. It is designed to query detailed traffic data filtered by various parameters such as agents, applications, networks, users, and time ranges.

Typical use cases include:

  • Network administrators analyzing application usage and traffic patterns.
  • Security teams monitoring allowed or blocked traffic for threat assessment.
  • IT managers generating reports on network resource consumption over specific periods.

For example, you could use this node to get statistics on all blocked traffic from certain user agents during the last 24 hours or to analyze traffic from specific application categories across selected networks.

Properties

Name Meaning
Additional Query Parameters A collection of optional filters to refine the traffic report query. These include:
- Agent Ids: Comma-separated list of user agent UUIDs (default all).
- Agent Types: Comma-separated list of user agent types.
- Application Category Ids: Comma-separated list of application category IDs.
- Application Ids: Comma-separated list of application IDs.
- Collection Ids: Comma-separated list of collection IDs.
- From: UTC lower limit datetime for the report (format YYYY-MM-DDThh:mm:ss or with Z). Defaults to current UTC minus 1 day.
- Mac Addresses: Comma-separated MAC addresses without colons.
- Name: Filter local users whose name contains this value.
- Nat Ips: Comma-separated NAT IPs (valid integers 101 to 106).
- Network Ids: Comma-separated list of network IDs.
- Organization Ids: Comma-separated list of organization IDs; defaults to user's organization.
- Private Ip: Specific private LAN IP.
- Private Ip From / To: Range for private LAN IPs.
- Security Report: Boolean to filter threats report (true/false), if empty includes both.
- Source: Traffic source filter with options: All, Networks, Agents, Proxies.
- To: UTC upper limit datetime for the report.
- Type: Type of report with options: All, Allowed, Blocked.
- User Ids: Comma-separated list of local user IDs.

Output

The node outputs JSON data containing the aggregated traffic report statistics based on the applied filters. The structure typically includes counts and metrics related to total applications and collections traffic, segmented by the specified criteria (e.g., allowed vs blocked traffic, sources, agents).

If binary data output is supported, it would represent raw report files or downloadable content, but this operation primarily returns structured JSON data summarizing traffic stats.

Dependencies

  • Requires an API key credential for authenticating requests to the external traffic reporting service.
  • The node uses a base URL endpoint https://api.dnsfilter.com for making HTTP requests.
  • Proper configuration of credentials in n8n is necessary to access the API.
  • The node depends on the bundled OpenAPI specification (openapi.json) for request construction.

Troubleshooting

  • Invalid Date Format: If the from or to date parameters are not in the correct ISO format, the API may return errors or default to fallback dates. Ensure dates follow YYYY-MM-DDThh:mm:ss or YYYY-MM-DDThh:mm:ssZ.
  • Authentication Errors: Missing or invalid API keys will cause authentication failures. Verify that the API key credential is correctly set up in n8n.
  • Empty or No Data Returned: Applying overly restrictive filters (e.g., very specific agent IDs or date ranges) might result in no data. Try broadening the query parameters.
  • Network Issues: Connectivity problems to the API endpoint can cause request failures. Check network access and proxy settings if applicable.

Links and References

Discussion