Skip to content

Conversation

@jdewinne
Copy link
Member

@jdewinne jdewinne commented Dec 2, 2025

Get a network report showing detailed network activity for a specified network.

The report shows individual network events including source/destination IPs, ports, protocols,
pods, processes, and DNS queries. Reports must be enabled with 'replicated network update <network-id> --collect-report'.

Output formats:
  - Default: Full event details in JSON format
  - --summary: Aggregated statistics with top domains and destinations
  - --watch: Continuous stream of new events in JSON Lines format


Usage:
  replicated network report [network-id] [flags]

Example:
  # Get full network traffic report (external traffic only)
  replicated network report <network-id>

  # Get aggregated summary with statistics. Only available for networks that have been terminated.
  replicated network report <network-id> --summary

  # Watch for new network events in real-time
  replicated network report <network-id> --watch

Flags:
  -h, --help        help for report
      --id string   Network ID to get report for
      --summary     Get aggregated report summary with statistics instead of individual events
  -w, --watch       Watch for new network events in real-time (polls every 2 seconds)

Global Flags:
      --app string       The app slug or app id to use in all calls
      --debug            Enable debug output
      --profile string   The authentication profile to use for this command
      --token string     The API token to use to access your app in the Vendor API


cmd.Flags().BoolVarP(&r.args.networkReportWatch, "watch", "w", false, "Watch for new network events in real-time (polls every 2 seconds)")
cmd.Flags().BoolVar(&r.args.networkReportSummary, "summary", false, "Get aggregated report summary with statistics instead of individual events")
cmd.Flags().BoolVar(&r.args.networkReportShowExternalOnly, "show-external-only", true, "Show only external network traffic")
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

i wonder if we want to leave this flag added but hidden, so if vendors have this in their CI scripts it won't fail. optionally we can display a deprecated warning as well if the hidden flag is supplied

@jdewinne jdewinne merged commit 027edae into main Dec 3, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants