Hub
Cloud

AWS VPC Flow Logs

AWS VPC Flow Logs (v5) — network traffic records across multiple accounts, VPCs, and subnets. TCP/UDP/ICMP flows with ACCEPT/REJECT actions, NAT gateway traffic, and realistic byte/packet distributions.

Quick Start

uv tool install eventum-generator
git clone https://github.com/eventum-generator/content-packs.git
cd content-packs
eventum generate \
  --path generators/cloud-aws-vpc-flow/generator.yml \
  --id vpcflow \
  --live-mode true

Event Types

Event IDDescriptionFrequencyCategory
accepted-tcpTCP ACCEPT — web, SSH, database traffic~53%network
accepted-udpUDP ACCEPT — DNS, NTP, syslog~16%network
accepted-tcp-bulkHigh-volume TCP transfers (S3, API)~11%network
rejected-tcpSecurity group denies, port scans~8%network
nodataNo traffic on interface during interval~5%network
rejected-udpBlocked DNS probes, SNMP scans~3%network
accepted-icmpPing, traceroute, path MTU discovery~2%network
rejected-icmpBlocked external pings, ICMP probes~1%network
skipdataInternal capacity skip during aggregation~1%network

Realism Features

  • Weighted port distributions — HTTPS dominates at ~35%, followed by DNS, HTTP, SSH, and 17 other services
  • Lognormal traffic volumes — packets and bytes follow lognormal distributions; bulk transfers produce 10KB–500MB flows
  • Network direction detection — classifies flows as inbound, outbound, internal, or external based on RFC 1918 analysis
  • Multi-account environment — 3 AWS accounts (production, staging, development) across 5 regions
  • 15 network interfaces spanning 3 VPCs with EC2, NAT gateway, ALB, Lambda, and ECS task ENI types
  • Raw log preservation — event.original contains the v2 space-delimited format matching CloudWatch/S3 delivery

Sample Output

{
  "@timestamp": "2026-03-04T14:22:31+00:00",
  "cloud": {
    "account": {
      "id": "123456789012",
      "name": "acme-production"
    },
    "availability_zone": "use1-az2",
    "provider": "aws",
    "region": "us-east-1"
  },
  "event": {
    "action": "accept",
    "category": [
      "network"
    ],
    "dataset": "aws.vpcflow",
    "outcome": "success",
    "type": [
      "connection",
      "allowed"
    ]
  },
  "network": {
    "bytes": 18560,
    "direction": "outbound",
    "iana_number": "6",
    "transport": "tcp"
  },
  "source": {
    "ip": "10.0.1.47",
    "port": 49832
  },
  "destination": {
    "ip": "52.94.233.17",
    "port": 443
  }
}

Parameters

ParameterDefaultDescription
agent_idc4d5e6f7-...Filebeat agent UUID
agent_version8.17.0Elastic Agent version

Related Generators