To setup Prodfiler on ECS two scripts should be run on a Linux/Mac (respect the order):
prodfiler-ecs-auth.sh: configures credentials to pull the
optimyze/pf-host-agentimage and IAM resources to consume the secret
prodfiler-ecs-task.sh: deploys a
DAEMONtask in an already-existing ECS cluster
Before installing Prodfiler, verify that your nodes meet the requirements. So far, the default Linux AMI 2 ships with an unsupported Linux kernel version (4.14); check the Amazon Linux 2 AMI release notes to verify support for the current kernel version.
Currently Prodfiler is available only on ECS clusters with EC2 launch type.
Fargate launch type does not allow deploying
DEAMON tasks and thus is not an option at the moment.
To run this script we suggest to use AWS credentials with the following policies attached:
Both scripts are not idempotent so they should be executed from AWS credentials with the proper authorizations to manage the impacted resources. If the script fails during the execution, the resources created so far will have to be deleted manually for the script to succeed on the next run.
Scripts use AWS CLI v2, refer to the official documentation to set it up.
To see the help message, execute the scripts with
Pass the provided credentials as arguments to this script in order to access the private Docker image.
<PASSWORD> placeholder content with the token released to you by your Optimyze contact.
Run this command from the root of the
./prodfiler-ecs-auth.sh --username optimyzeprodfilerbeta --password <PASSWORD>
It will create the secrets used by the ECS DAEMON task using AWS Secret Manager.
secretToken values visible in the Prodfiler web UI
when creating a new project.
The values are defined as environment variables in the deployment command visible in the UI,
they are called
Run the script:
./prodfiler-ecs-task.sh --cluster-arn <YOUR_CLUSTER_ARN> \ --collection-agent "data.try.prodfiler.com:443" \ --project-id <YOUR_PROJECT_ID> --version "release-1.0.2" --tracers "all" --secret-token <YOUR_SECRET_TOKEN>
At this point Prodfiler Host Agent should be running in your ECS cluster and you should start seeing data in the UI.