Beta feature
The Postman Insights Agent listens to the traffic arriving at the cluster service you want to monitor and automatically populates your Insights project with endpoints.
Estimated time: 15-minute setup, 10-minute wait
To use the Insights Agent with AWS Elastic Beanstalk, complete the following steps.
This installation is a three-part process consisting of:
.ebextensions
).systemd
.To continue onboarding your service, you'll collect your project ID and API key, download an AWS Elastic Beanstalk configuration file, and add the required environment variables to your Elastic Load Balancing (ELB) deployment.
Go to the Diagnostics tab to locate your project ID string, formatted as svc_xxxxxxxxxx. Keep it for the next steps.
Get or create a new API key. For more information, see Generate and use Postman API keys. Keep the API key for the next steps.
You can store the API key directly as part of the ELB environment configuration.
If you have security concerns, you can store the API key in other secure places, like AWS Secrets Manager.
If you use a secret manager, ensure the following:
To install the Insights Agent, do the following:
Create a folder named .ebextensions
inside your Elastic BeanStalk Application source bundle.
Download the postman-insights-agent-beanstalk.config file and store it in the .ebextensions
folder.
Deploy your application to the ELB environment using one of the following methods:
After successful deployment, continue to the next step.
Next, you'll add the required environment variables to install and start the Insights Agent in your ELB environment instances.
To add the required environment variables to your ELB environment, do the following:
Open the Elastic Beanstalk console, and select your AWS Region from the Regions list.
In the navigation pane, select Environments, then select your environment's name from the list.
Click Configuration.
In the Updates, monitoring, and logging configuration category, click Edit.
Scroll down to Environment properties and select Add environment property.
Enter the following property name and value pairs and click Apply:
ENABLE_POSTMAN_INSIGHTS: true
POSTMAN_INSIGHTS_API_KEY: <your-api-key>
POSTMAN_INSIGHTS_PROJECT_ID: <project-id>
POSTMAN_INSIGHTS_ENABLE_REPRO_MODE: true
The following is a list of all variable options.
Environment variable | Description |
---|---|
ENABLE_POSTMAN_INSIGHTS_AGENT | Install and start the Insights Agent. |
POSTMAN_INSIGHTS_API_KEY | Your Postman API Key, which will be used to send traffic data from your service. |
POSTMAN_INSIGHTS_PROJECT_ID | Your Insights project ID from the Postman app, which will be used as destination for collected witnesses (traces). |
POSTMAN_INSIGHTS_ENABLE_REPRO_MODE | Turn on Repro Mode to send request and response payloads to Postman. |
POSTMAN_INSIGHTS_ADDITIONAL_FLAGS | Additional flags to pass to postman-insights-agent apidump. Example: --host-allow ... --rate-limit .... |
Save and apply the environment properties.
This will start the environment update process in your environment. Wait for the process to complete before proceeding to the next step.
For reference, see Deploying applications to Elastic Beanstalk environments (AWS Elastic Beanstalk).
Postman uses AWS Elastic Beanstalk configuration files (.ebextensions
) to install and run the Insights Agent. .ebextensions
run during the application deployment process only.
To redeploy the existing application version, do the following:
Open the Elastic Beanstalk console, and in the Regions list, select your AWS Region.
In the navigation pane, click Applications, then select your application's name from the list.
Click Application version and select the application version to deploy.
Click Actions > Deploy.
Select the environment where you've added environment configurations, and then click Deploy.
To learn more, see Redeploying a previous version (AWS Elastic Beanstalk).
Tip: If you're not seeing your endpoints right away, traffic may be taking some time to collect. See the next section for more information.
After Insights detects traffic from the Insights Agent, you'll get automatically redirected to the Overview page. The Insights Agent needs 5-8 minutes to use AI to generate endpoints.
If you're only seeing health checks, your traffic may be affected. If you're not seeing what you expect after 10 minutes, see Diagnose and troubleshoot Insights Agent errors.
To make it possible to make API calls using real user data, you need to activate Repro Mode. Go to your Insights project and select Settings. Then, toggle on Activate Repro Mode.
Only a Workspace Admin can enable the Repro Mode.
Default data redactions. Postman Insights automatically redacts a set of sensitive values including authentication tokens. See the full list. You can also add fields to redact ahead of turning on the feature.
To remove the Insights Agent:
Remove the postman-insights-agent-beanstalk.config file from the .ebextensions
folder.
Deploy your application to the Beanstalk environment using one of the following methods:
Remove the added ELB environment configurations.
Last modified: 2025/05/30