Beta feature

ecs add command reference

The ecs add command collects information to add the Postman Insights Agent container to an ECS task. See Examples. For help, use -h or --help.

Usage

postman-insights-agent ecs add [flags]

Flags

  • --filter string - Match the packets going to and coming from the API service.
  • --host-allow strings - Allow only the HTTP hosts matching the regular expressions.
  • --host-exclusions strings - Remove the HTTP hosts matching the regular expressions.
  • --interfaces strings - List of network interfaces to listen on. Default: All interfaces on the host.
  • --path-allow strings - Allow only the HTTP paths matching the regular expressions.
  • --path-exclusions strings - Remove the HTTP paths matching the regular expressions.
  • --rate-limit float - Number of requests per minute to capture. Default: 1000.

Global flags

  • --cluster string - The name or ARN of the ECS cluster.
  • --dry-run - Perform a dry run: show what will be done, but don't change ECS.
  • --log-format string - Set to color, plain, or json to control the log format.
  • --profile string - Which of the AWS profiles to use to access ECS.
  • --project string - The Postman Insights project ID.
  • --proxy string - The domain name, IP address, or URL of an HTTP proxy server to use.
  • --region string - The AWS region in which the ECS cluster resides.
  • --service string - The name or ARN of the ECS service.
  • --task string - The name of the ECS task definition to change.

Examples

  • Capture traffic on port 80.

    postman-insights-agent ecs add ... --filter "port 80" ...
    
  • Capture traffic from specific network interfaces.

    postman-insights-agent ecs add ... --interfaces "lo,eth0" ...
    
  • Filter out requests fetching files with .png or .jpg extensions.

    postman-insights-agent ecs add ... --path-exclusions '.*\.png' --path-exclusions '.*\.jpg' ...
    
  • Filter out requests having host deb.debian.org.

    postman-insights-agent ecs add ... --host-exclusions 'deb\.debian\.org' ...
    
  • Only allow requests having host www.example.com.

    postman-insights-agent ecs add ... --host-allow 'www\.example\.com' ...
    
  • Only allow requests related to the admin endpoints.

    postman-insights-agent ecs add ... --path-allow '*/admin/*' ...
    

Last modified: 2025/05/30