For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Postman
PricingEnterprise
Contact SalesSign InSign Up for Free
HomeDocs
HomeDocs
      • Overview
      • Debug with Insights
      • Customize Insights
      • Uninstall Insights Agent
        • Overview
          • Overview
          • API Catalog deployment modes
          • apidump
          • kube inject
          • kube helm-fragment
          • kube tf-fragment
          • ecs add
          • ecs task-def
          • ecs cf-fragment
          • completion
      • FAQ
Postman API Platform

Product

  • Postman Overview
  • Enterprise
  • Spec Hub
  • Flows
  • Agent Mode
  • API Catalog
  • Fern
  • Postman CLI
  • Integrations
  • Workspaces
  • Plans and pricing

API Network

  • App Security
  • Artificial Intelligence
  • Communication
  • Data Analytics
  • Database
  • Developer Productivity
  • DevOps
  • Ecommerce
  • eSignature
  • Financial Services
  • Payments
  • Travel

Resources

  • Postman Docs
  • Academy
  • Community
  • Templates
  • Intergalactic
  • Videos
  • MCP Servers

Legal and Security

  • Legal Terms Hub
  • Terms of Service
  • Postman Product Terms
  • Security
  • Website Terms of Use

Company

  • About
  • Careers and culture
  • Contact us
  • Partner program
  • Customer stories
  • Student programs
  • Press and media
Twitter iconLinkedIn iconGithub iconYouTube iconInstagram iconDiscord icon
Download Postman
Privacy Policy

© 2026 Postman, Inc.

On this page
  • Usage
  • Flags
  • Global flags
  • Examples
Postman InsightsReferenceInsights agent

ecs add command reference

||View as Markdown|
Was this page helpful?
Previous

kube helm-fragment command reference

Next

ecs task-def command reference

Built with

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