Skip to main content

Description

Flow Logs is a feature that enables you to capture information about the IP traffic going to and from network interfaces in the organization's VPC subnets. Once a flow log is created, you can view and retrieve its data in Cloud Logging. It is recommended that Flow Logs be enabled for every business-critical VPC subnet.

Rationale

VPC networks and subnetworks not reserved for internal HTTP(S) load balancing provide logically isolated and secure network partitions where GCP resources can be launched. When Flow Logs are enabled for a subnet, VMs within that subnet start reporting on all Transmission Control Protocol (TCP) and User Datagram Protocol (UDP) flows. Each VM samples the TCP and UDP flows it sees, inbound and outbound, whether the flow is to or from another VM, a host in the on-premises datacenter, a Google service, or a host on the Internet. If two GCP VMs are communicating, and both are in subnets that have VPC Flow Logs enabled, both VMs report the flows.

Flow Logs supports the following use cases:

  • Network monitoring
  • Understanding network usage and optimizing network traffic expenses
  • Network forensics
  • Real-time security analysis

Flow Logs provide visibility into network traffic for each VM inside the subnet and can be used to detect anomalous traffic or provide insight during security workflows.

The Flow Logs must be configured such that all network traffic is logged, the interval of logging is granular to provide detailed information on the connections, no logs are filtered, and metadata to facilitate investigations are included.

Note

Subnets reserved for use by internal HTTP(S) load balancers do not support VPC flow logs.

Impact

Standard pricing for Cloud Logging, BigQuery, or Cloud Pub/Sub applies. VPC Flow Logs generation is billed as described in the reference: https://cloud.google.com/vpc/

Audit

From Google Cloud Console

  1. Go to the VPC network GCP Console visiting https://console.cloud.google.com/networking/networks/list

  2. From the list of network subnets, make sure for each subnet:

    • Flow Logs is set to On

    • Aggregation Interval is set to 5 sec

    • Include metadata checkbox is checked

    • Sample rate is set to 100%

Note

It is not possible to determine if a Log filter has been defined from the console.

From Google Cloud CLI

gcloud compute networks subnets list --format json |
jq -r '(["Subnet","Purpose","Flow_Logs","Aggregation_Interval","Flow_Sampling","Metadata","Logs_Filtered"] | (., map(length*"-"))), (.[] | [ .name, .purpose, (if has("enableFlowLogs") and .enableFlowLogs == true then "Enabled" else "Disabled" end), (if has("logConfig") then .logConfig.aggregationInterval else "N/A" end), (if has("logConfig") then .logConfig.flowSampling else "N/A" end), (if has("logConfig") then .logConfig.metadata else "N/A" end), (if has("logConfig") then (.logConfig | has("filterExpr")) else "N/A" end) ] ) | @tsv' |
column -t

The output of the above command will list:

  • each subnet
  • the subnet's purpose
  • a Enabled or Disabled value if Flow Logs are enabled
  • the value for Aggregation Interval or N/A if disabled, the value for Flow Sampling or N/A if disabled
  • the value for Metadata or N/A if disabled
  • 'true' or 'false' if a Logging Filter is configured or 'N/A' if disabled.

If the subnet's purpose is PRIVATE then Flow Logs should be Enabled. If Flow Logs is enabled then:

  • Aggregation_Interval should be INTERVAL_5_SEC
  • Flow_Sampling should be 1
  • Metadata should be INCLUDE_ALL_METADATA
  • Logs_Filtered should be false.

Default Value

By default, Flow Logs are set to Off when a new VPC network subnet is created.

References

  1. https://cloud.google.com/vpc/docs/using-flow-logs#enabling_vpc_flow_logging
  2. https://cloud.google.com/vpc/