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