AvantGuard - DNSFilter

Actions277

User Agents Actions
- User Agents Uninstall Pin
- User Agents Dequeue Uninstall
- User Agents Csv
- User Agents Index
- User Agents All
- User Agents Counts
- User Agents Show
- User Agents Update
- User Agents Destroy
- User Agents Tags
Url Filters Actions
- Url Filters Test
Users Actions
- Users Index
- Users All
- Users Show
Traffic Reports Actions
- Traffic Reports Qps Active Agents
- Traffic Reports Qps Active Users
- Traffic Reports Qps Active Collections
- Traffic Reports Top Domains
- Traffic Reports Top Categories
- Traffic Reports Top Application Categories
- Traffic Reports Top Organizations
- Traffic Reports Top Networks
- Traffic Reports Top Agents
- Traffic Reports Top Users
- Traffic Reports Top Collections
- Traffic Reports Query Logs
- Traffic Reports Total Organizations Stats
- Traffic Reports Total Domain Stats
- Traffic Reports Total Category Stats
- Traffic Reports Total Organizations Requests
- Traffic Reports Total Domain Requests
- Traffic Reports Top Organizations Requests
- Traffic Reports Total Client Stats
- Traffic Reports Total Deployments
- Traffic Reports Total Roaming Clients
- Traffic Reports Total Applications Stats
- Traffic Reports Total Applications Organizations Stats
- Traffic Reports Total Applications Networks Stats
- Traffic Reports Total Applications Agents Stats
- Traffic Reports Total Applications Users Stats
- Traffic Reports Total Applications Collections Stats
- Traffic Reports Total Requests
- Traffic Reports Total Requests Geo
- Traffic Reports Total Requests Organizations
- Traffic Reports Total Requests Agents
- Traffic Reports Total Requests Users
- Traffic Reports Total Requests Collections
- Traffic Reports Total Threats
- Traffic Reports Total Threats Organizations
- Traffic Reports Total Threats Agents
- Traffic Reports Total Threats Users
- Traffic Reports Total Threats Collections
- Traffic Reports Total Categories
- Traffic Reports Total Categories Organizations
- Traffic Reports Total Categories Agents
- Traffic Reports Total Categories Users
- Traffic Reports Total Categories Collections
- Traffic Reports Total Domains
- Traffic Reports Total Domains Organizations
- Traffic Reports Total Domains Users
- Traffic Reports Total Domains Collections
- Traffic Reports Total Collections
- Traffic Reports Total Collections Organizations
- Traffic Reports Total Collections Agents
- Traffic Reports Total Collections Users
- Traffic Reports Qps
- Traffic Reports Qps Active Organizations
Trials Actions
- Trials Create
User Agent Bulk Deletes Actions
- User Agent Bulk Deletes Create
- User Agent Bulk Deletes Show
- User Agent Bulk Deletes Counts
User Agent Bulk Updates Actions
- User Agent Bulk Updates Create
- User Agent Bulk Updates Show
- User Agent Bulk Updates Has Mixed
- User Agent Bulk Updates Counts
User Agent Cleanups Actions
- User Agent Cleanups Create
- User Agent Cleanups Show
- User Agent Cleanups Update
User Agent Csv Exports Actions
- User Agent Csv Exports Create
- User Agent Csv Exports Show
Policies Actions
- Policies Add Blacklist Category
- Policies Remove Blacklist Category
- Policies Add Allowed Application
- Policies Remove Allowed Application
- Policies Add Blocked Application
- Policies Remove Blocked Application
- Policies Get Permissive Mode
- Policies Index
- Policies Create
- Policies All
- Policies Show
- Policies Update
- Policies Destroy
- Policies Application
- Policies Application Update
- Policies Add Blacklist Domain
- Policies Remove Blacklist Domain
- Policies Add Whitelist Domain
- Policies Remove Whitelist Domain
Policies Bulk Actions Actions
- Policies Bulk Actions Add Allowlist Domains
- Policies Bulk Actions Remove Allowlist Domains
- Policies Bulk Actions Add Blocklist Domains
- Policies Bulk Actions Remove Blocklist Domains
Policy Ips Actions
- Policy Ips Show
Scheduled Policies Actions
- Scheduled Policies Index
- Scheduled Policies Create
- Scheduled Policies All
- Scheduled Policies Show
- Scheduled Policies Update
- Scheduled Policies Destroy
Scheduled Report Previews Actions
- Scheduled Report Previews Show
- Scheduled Report Previews Create
Scheduled Reports Actions
- Scheduled Reports Index
- Scheduled Reports Create
- Scheduled Reports Show
- Scheduled Reports Update
- Scheduled Reports Destroy
Networks Actions
- Networks Lookup
- Networks Show
- Networks Update
- Networks Destroy
- Networks Bulk Create
- Networks Bulk Create Status
- Networks Index
- Networks Create
- Networks All
- Networks Msp
- Networks Msp All
- Networks Bulk Update
- Networks Bulk Update Status
- Networks Bulk Destroy
- Networks Bulk Destroy Status
- Networks Generate Secret Key
- Networks Revoke Secret Key
- Networks Rotate Secret Key
Mac Addresses Actions
- Mac Addresses Show
- Mac Addresses Update
- Mac Addresses Destroy
- Mac Addresses Index
- Mac Addresses Create
- Mac Addresses All
Metrics Actions
- Metrics Organization Usage
- Metrics Organization Usage Detailed
Network Lan Ips Actions
- Network Lan Ips Index
- Network Lan Ips Show
- Network Lan Ips Update
Network Subnets Actions
- Network Subnets All
- Network Subnets Index
- Network Subnets Create
- Network Subnets Show
- Network Subnets Update
- Network Subnets Destroy
Organizations Actions
- Organizations Index
- Organizations Create
- Organizations All
- Organizations Show
- Organizations Update
- Organizations Destroy
- Organizations Settings
- Organizations Bulk Update
- Organizations Cancel
- Organizations Promote To Msp
Organization Users Actions
- Organization Users Index
- Organization Users Create
- Organization Users Show
- Organization Users Update
- Organization Users Destroy
- Organization Users Resend Invite
Distributors Actions
- Distributors Msps Cancel
- Distributors Msps Reactivate
- Distributors Organizations Index
- Distributors Organizations Create
- Distributors Organizations Show
- Distributors Organizations Update
- Distributors Organizations Cancel
- Distributors Organizations Reactivate
- Distributors Organizations Add Sku
- Distributors Organizations Remove Sku
- Distributors Users Index
- Distributors Users Create
- Distributors Users Show
- Distributors Users Add Membership
- Distributors Users Update Membership
- Distributors Users Remove Membership
- Distributors Users Send Reset Password Email
- Distributors Users Reset Password Url
- Distributors Reports Usage By Organization
- Distributors Reports Usage By Sku
- Distributors Reports Covered Users Summary By Organization
- Distributors Distributors Update
- Distributors Msps Index
- Distributors Msps Create
- Distributors Msps Show
- Distributors Msps Update
Domain Notes Actions
- Domain Notes Show
- Domain Notes Update
- Domain Notes Batch Update
- Domain Notes Destroy
- Domain Notes Batch Destroy
Domains Actions
- Domains User Lookup
- Domains Bulk Lookup
- Domains Suggest Categories
- Domains Suggest Threat
Enterprise Connections Actions
- Enterprise Connections Index
- Enterprise Connections Create
- Enterprise Connections Show
- Enterprise Connections Update
- Enterprise Connections Destroy
Invoices Actions
- Invoices Index
- Invoices Show
IP Addresses Actions
- IP Addresses Index
- IP Addresses Create
- IP Addresses All
- IP Addresses Show
- IP Addresses Update
- IP Addresses Destroy
- IP Addresses Verify
Allowed Urls Actions
- Allowed Urls Destroy
- Allowed Urls Bulk Update
- Allowed Urls Bulk Delete
- Allowed Urls Has Mixed
- Allowed Urls Count
- Allowed Urls Csv
- Allowed Urls Index
- Allowed Urls Create
- Allowed Urls Update
Api Key Actions
- Api Key Create
- Api Key Index
- Api Key Show
- Api Key Destroy
- Api Key Revoke
Application Categories Actions
- Application Categories Index
- Application Categories Show
Applications Actions
- Applications Index
- Applications All
- Applications Show
Authentication Actions
- Authentication Create
Authentication Sync Tool Actions
- Authentication Sync Tool Index
- Authentication Sync Tool Create
- Authentication Sync Tool All
- Authentication Sync Tool Show
- Authentication Sync Tool Update
- Authentication Sync Tool Destroy
Billings Actions
- Billings Show
- Billings Create
- Billings Address Show
- Billings Address Update
Blocked Urls Actions
- Blocked Urls Index
- Blocked Urls Create
- Blocked Urls Update
- Blocked Urls Destroy
- Blocked Urls Bulk Update
- Blocked Urls Bulk Delete
- Blocked Urls Has Mixed
- Blocked Urls Count
- Blocked Urls Csv
Block Pages Actions
- Block Pages Index
- Block Pages Create
- Block Pages All
- Block Pages Show
- Block Pages Update
- Block Pages Destroy
Categories Actions
- Categories Index
- Categories All
- Categories Show
Collection Users Actions
- Collection Users Index
- Collection Users Create
- Collection Users Show
- Collection Users Destroy
Agent Local User Actions
- Agent Local User Index
- Agent Local User All
- Agent Local User Show
- Agent Local User Update
- Agent Local User Destroy
Agent Local User Bulk Deletes Actions
- Agent Local User Bulk Deletes Create
- Agent Local User Bulk Deletes Show
- Agent Local User Bulk Deletes Counts

Overview

This node operation fetches aggregated traffic report data showing the total number of requests broken down by geographic location. It is useful for analyzing network or service usage patterns across different regions, helping identify where most traffic originates or to monitor regional demand.

Common scenarios include:

Monitoring web or API traffic distribution by geography.
Generating reports for compliance or auditing purposes.
Identifying unusual spikes in traffic from specific locations.

For example, a user might request the total number of requests per country over the last day to understand which markets are most active.

Properties

Name	Meaning
Limit	Limits the size of the response (number of records returned).
Additional Query Parameters	Optional parameters to refine the query:
- From	UTC lower time limit for the report, format `YYYY-MM-DDThh:mm:ss` or with trailing `Z`. Defaults to current UTC minus 1 day if not set or invalid.
- Msp Id	Numeric MSP (Managed Service Provider) identifier.
- Organization Ids	Comma-separated list of organization IDs to filter the report; defaults to the user's organization ID if empty.
- To	UTC upper time limit for the report, format `YYYY-MM-DDThh:mm:ss` or with trailing `Z`. Defaults to current UTC if not set or invalid.

Output

The output JSON contains aggregated traffic data grouped by geographic locations. Each item typically includes fields such as location identifiers (e.g., country codes), and the total number of requests originating from those locations within the specified time range.

If binary data were supported, it would represent raw report files or exports, but this operation focuses on JSON data only.

Dependencies

Requires an API key credential for authenticating with the external traffic reporting service.
The node sends HTTP requests to the service's API endpoint, passing query parameters based on input properties.
Proper timezone-aware date strings must be provided for accurate filtering.

Troubleshooting

Invalid Date Format: If the From or To parameters are incorrectly formatted, the API may default to preset times or return errors. Ensure dates follow the ISO 8601 format (YYYY-MM-DDThh:mm:ss or with Z).
Empty or Zero Limit: Setting Limit to zero might result in no data returned or default limits applied by the API. Specify a positive integer to control response size.
Authorization Errors: Missing or invalid API credentials will cause authentication failures. Verify that the API key is correctly configured in n8n credentials.
No Data Returned: If filters are too restrictive (e.g., wrong organization IDs or MSP ID), the response may be empty. Adjust query parameters accordingly.

Links and References

Refer to the external traffic reporting service API documentation for detailed parameter descriptions and response schema.
ISO 8601 date format specification: https://en.wikipedia.org/wiki/ISO_8601

AvantGuard - DNSFilterInstall