Parse AWS VPC Flow Log

Stack

The parse_aws_vpc_flow_log processor decodes AWS VPC Flow log messages.

Below is an example configuration that decodes the message field using the default version 2 VPC flow log format.

		processors:
  - parse_aws_vpc_flow_log:
      format: version account-id interface-id srcaddr dstaddr srcport dstport protocol packets bytes start end action log-status
      field: message
		
	

The parse_aws_vpc_flow_log processor has the following configuration settings.

Name	Required	Default	Description
`field`	no	`message`	Source field containing the VPC flow log message.
`target_field`	no	`aws.vpcflow`	Target field for the VPC flow log object. This applies only to the original VPC flow log fields. ECS fields are written to the standard location.
`format`	yes		VPC flow log format. This supports VPC flow log fields from: • Stack Planned Versions 2 through 8 • Stack 9.0.0 Versions 2 through 5 It will accept a string or a list of strings. Each format must have a unique number of fields to enable matching it to a flow log message.
`mode`	no	`ecs`	Mode controls what fields are generated. The available options are `original`, `ecs`, and `ecs_and_original`. `original` generates the fields specified in the format string. `ecs` maps the original fields to ECS and removes the original fields that are mapped to ECS. `ecs_and_original` maps the original fields to ECS and retains all the original fields.
`ignore_missing`	no	false	Ignore missing source field.
`ignore_failure`	no	false	Ignore failures while parsing and transforming the flow log message.
`id`	no		Instance ID for debugging purposes.

This mode returns the same fields found in the format string. It will drop any fields whose value a dash (-). It converts the strings into the appropriate data types. These are the known field names and their data types.

Note

The AWS VPC flow field names use underscores instead of dashes within Filebeat. You may configure the format using field names that contain either.

VPC Flow Log Field	Data Type
account_id	string
action	string
az_id	string
bytes	long
dstaddr	ip
dstport	integer
ecs_cluster_name Stack Planned	string
ecs_container_id Stack Planned	string
ecs_container_instance_arn Stack Planned	string
ecs_container_instance_id Stack Planned	string
ecs_second_container_id Stack Planned	string
ecs_service_name Stack Planned	string
ecs_task_arn Stack Planned	string
ecs_task_definition_arn Stack Planned	string
ecs_task_id Stack Planned	string
end	timestamp
flow_direction	string
instance_id	string
interface_id	string
log_status	string
packets	long
packets_lost_blackhole Stack Planned	long
packets_lost_mtu_exceeded Stack Planned	long
packets_lost_no_route Stack Planned	long
packets_lost_ttl_expired Stack Planned	long
pkt_dst_aws_service	string
pkt_dstaddr	ip
pkt_src_aws_service	string
pkt_srcaddr	ip
protocol	integer
region	string
reject_reason Stack Planned	string
resource_type Stack Planned	string
srcaddr	ip
srcport	integer
start	timestamp
sublocation_id	string
sublocation_type	string
subnet_id	string
tcp_flags	integer
tcp_flags_array*	integer
tgw_attachment_id Stack Planned	string
tgw_dst_az_id Stack Planned	string
tgw_dst_eni Stack Planned	string
tgw_dst_subnet_id Stack Planned	string
tgw_dst_vpc_account_id Stack Planned	string
tgw_dst_vpc_id Stack Planned	string
tgw_id Stack Planned	string
tgw_pair_attachment_id Stack Planned	string
tgw_src_az_id Stack Planned	string
tgw_src_eni Stack Planned	string
tgw_src_subnet_id Stack Planned	string
tgw_src_vpc_account_id Stack Planned	string
tgw_src_vpc_id Stack Planned	string
traffic_path	integer
type	string
version	integer
vpc_id	string

ECS

This mode maps the original VPC flow log fields into their associated Elastic Common Schema (ECS) fields. It removes the original fields that were mapped to ECS to reduced duplication. These are the field associations. There may be some transformations applied to derive the ECS field.

VPC Flow Log Field	ECS Field
account_id	cloud.account.id
action	event.action
action Stack Planned	event.outcome
action	event.type
az_id	cloud.availability_zone
bytes	network.bytes
bytes	source.bytes
dstaddr	destination.address
dstaddr	destination.ip
dstport	destination.port
ecs_cluster_arn Stack Planned	orchestrator.cluster.id
ecs_cluster_name Stack Planned	orchestrator.cluster.name
ecs_container_id Stack Planned	container.id
ecs_container_instance_arn Stack Planned	orchestrator.resource.name
ecs_container_instance_id Stack Planned	orchestrator.resource.id
ecs_second_container_id Stack Planned	-
ecs_service_name Stack Planned	service.name
ecs_task_arn Stack Planned	-
ecs_task_definition_arn Stack Planned	-
ecs_task_id Stack Planned	-
end	@timestamp
end	event.end
flow_direction	network.direction
instance_id	cloud.instance.id
interface_id Stack Planned	-
log_status Stack Planned	-
packets	network.packets
packets	source.packets
packets_lost_blackhole Stack Planned	-
packets_lost_mtu_exceeded Stack Planned	-
packets_lost_no_route Stack Planned	-
packets_lost_ttl_expired Stack Planned	-
pkt_dst_aws_service Stack Planned	-
pkt_dstaddr Stack Planned	-
pkt_src_aws_service Stack Planned	-
pkt_srcaddr Stack Planned	-
protocol	network.iana_number
protocol	network.transport
region	cloud.region
reject_reason Stack Planned	event.reason
resource_type Stack Planned	-
srcaddr	network.type
srcaddr	source.address
srcaddr	source.ip
srcport	source.port
start	event.start
sublocation_id Stack Planned	-
sublocation_type Stack Planned	-
subnet_id Stack Planned	-
tcp_flags Stack Planned	-
tgw_attachment_id Stack Planned	-
tgw_dst_az_id Stack Planned	-
tgw_dst_eni Stack Planned	-
tgw_dst_subnet_id Stack Planned	-
tgw_dst_vpc_account_id Stack Planned	-
tgw_dst_vpc_id Stack Planned	-
tgw_id Stack Planned	-
tgw_pair_attachment_id Stack Planned	-
tgw_src_az_id Stack Planned	-
tgw_src_eni Stack Planned	-
tgw_src_subnet_id Stack Planned	-
tgw_src_vpc_account_id Stack Planned	-
tgw_src_vpc_id Stack Planned	-
traffic_path Stack Planned	-
type Stack Planned	-
version Stack Planned	-
vpc_id Stack Planned	-

ECS and Original

This mode maps the fields into ECS and retains all the original fields. Below is an example document produced using ecs_and_orignal mode.

		{
  "@timestamp": "2021-03-26T03:29:09Z",
  "aws": {
    "vpcflow": {
      "account_id": "64111117617",
      "action": "REJECT",
      "az_id": "use1-az5",
      "bytes": 1,
      "dstaddr": "10.200.0.0",
      "dstport": 33004,
      "end": "2021-03-26T03:29:09Z",
      "flow_direction": "ingress",
      "instance_id": "i-0axxxxxx1ad77",
      "interface_id": "eni-069xxxxxb7a490",
      "log_status": "OK",
      "packets": 52,
      "pkt_dst_aws_service": "CLOUDFRONT",
      "pkt_dstaddr": "10.200.0.80",
      "pkt_src_aws_service": "AMAZON",
      "pkt_srcaddr": "89.160.20.156",
      "protocol": 17,
      "region": "us-east-1",
      "srcaddr": "89.160.20.156",
      "srcport": 50041,
      "start": "2021-03-26T03:28:12Z",
      "sublocation_id": "fake-id",
      "sublocation_type": "wavelength",
      "subnet_id": "subnet-02d645xxxxxxxdbc0",
      "tcp_flags": 1,
      "tcp_flags_array": [
        "fin"
      ],
      "traffic_path": 1,
      "type": "IPv4",
      "version": 5,
      "vpc_id": "vpc-09676f97xxxxxb8a7"
    }
  },
  "cloud": {
    "account": {
      "id": "64111117617"
    },
    "availability_zone": "use1-az5",
    "instance": {
      "id": "i-0axxxxxx1ad77"
    },
    "region": "us-east-1"
  },
  "destination": {
    "address": "10.200.0.0",
    "ip": "10.200.0.0",
    "port": 33004
  },
  "event": {
    "action": "reject",
    "end": "2021-03-26T03:29:09Z",
    "outcome": "failure",
    "start": "2021-03-26T03:28:12Z",
    "type": [
      "connection",
      "denied"
    ]
  },
  "message": "5 64111117617 eni-069xxxxxb7a490 89.160.20.156 10.200.0.0 50041 33004 17 52 1 1616729292 1616729349 REJECT OK vpc-09676f97xxxxxb8a7 subnet-02d645xxxxxxxdbc0 i-0axxxxxx1ad77 1 IPv4 89.160.20.156 10.200.0.80 us-east-1 use1-az5 wavelength fake-id AMAZON CLOUDFRONT ingress 1",
  "network": {
    "bytes": 1,
    "direction": "ingress",
    "iana_number": "17",
    "packets": 52,
    "transport": "udp",
    "type": "ipv4"
  },
  "related": {
    "ip": [
      "89.160.20.156",
      "10.200.0.0",
      "10.200.0.80"
    ]
  },
  "source": {
    "address": "89.160.20.156",
    "bytes": 1,
    "ip": "89.160.20.156",
    "packets": 52,
    "port": 50041
  }
}
		
	

Parse AWS VPC Flow Log

Modes

Original

ECS

ECS and Original