Hub
Network

Network Traffic (Continent-Level Geo)

Network traffic events enriched with continent-level geographic information. Models cross-continent and same-continent flows for both inbound and outbound directions, with realistic allow/deny outcomes based on geographic policy.

Quick Start

uv tool install eventum-generator
git clone https://github.com/eventum-generator/content-packs.git
cd content-packs
eventum generate \
  --path generators/network-continent/generator.yml \
  --id network-continent \
  --live-mode true

Event Types

Event IDDescriptionFrequencyCategory
cross-continent-outbound-allowOutbound traffic to a different continent — allowed~25%network
same-continent-outbound-allowOutbound traffic within the same continent — allowed~30%network
cross-continent-inbound-allowInbound traffic from a different continent — allowed~15%network
same-continent-inbound-allowInbound traffic from the same continent — allowed~15%network
cross-continent-inbound-deniedInbound traffic from a different continent — denied by geo policy~10%network
same-continent-inbound-deniedInbound traffic from the same continent — denied~5%network

Realism Features

  • Continent-level geolocation — source and destination enriched with continent codes (NA, EU, AS, SA, AF, OC)
  • Cross-continent vs same-continent traffic split reflects real-world routing patterns
  • Direction-aware policies — outbound traffic predominantly allowed; inbound subject to geo-based filtering
  • Denied traffic skewed toward cross-continent inbound, modeling geographic access restrictions
  • ECS geo fields — source.geo.continent_name and destination.geo.continent_name populated on every event

Sample Output

{
    "@timestamp": "2026-03-07T10:15:32.456789+00:00",
    "event": {
        "action": "allow",
        "category": ["network"],
        "dataset": "network.continent",
        "outcome": "success",
        "type": ["connection", "allowed"]
    },
    "source": {
        "ip": "10.1.1.45",
        "port": 49821,
        "geo": { "continent_name": "North America" }
    },
    "destination": {
        "ip": "203.0.113.80",
        "port": 443,
        "geo": { "continent_name": "Europe" }
    },
    "network": {
        "direction": "outbound",
        "transport": "tcp"
    },
    "observer": { "hostname": "gw-01", "type": "firewall", "vendor": "Generic" }
}

Parameters

ParameterDefaultDescription
hostnamegw-01Gateway hostname
domainexample.comDomain for FQDN
agent_ida1b2c3d4-...Filebeat agent ID
agent_version8.17.0Filebeat version

Related Generators