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/*' ...