Why are we doing this?
AWS periodically deprecates Lambda runtime versions, and Operata has updated its CloudFormation templates to stay current.
This update moves your stacks to Python 3.13 running on Amazon Linux 2023 — the latest supported runtime environment.
What you need to know before starting:
⏱ The update takes approximately 5–10 minutes per stack
⚠️ If the update fails or is applied incorrectly, it will break your Operata integration — follow the steps carefully
📊 This update does change the data being collected — you may notice changes in your Operata dashboards after the update is applied
How to update
You'll need to update up to three stacks depending on your Operata configuration. Complete each applicable stack update in sequence.
1. Contact Trace Records (CTR)
Use this template URL when updating your CTR stack:
2. Contact Lens Data
Use this template URL when updating your Contact Lens stack:
https://s3.ap-southeast-2.amazonaws.com/operata-customer-assets/cloud-collector-v3-contact-lens-data.yaml
⚠️ Additional step required before updating this stack
The Contact Lens Data stack creates ENI (Elastic Network Interface) resources that must be manually deleted during the update can complete successfully. Skipping this step may cause the stack update to stall or fail.
To find and delete ENI resources:
In the AWS Management Console, navigate to EC2 → Network Interfaces (under Network & Security)
Click the Search bar at the top of the list
Select Security group name from the dropdown filter options
Type the partial name — e.g.
operata-contactlens— and hit Enter
This will show all ENIs associated with that SG. Copy the ENI IDs from the results, update the list below, then run via CloudShell or Git Bash:
bash
for ENI_ID in \ eni-0a1b2c3d4e5f67890 \ eni-0b2c3d4e5f6a78901 \ eni-0c3d4e5f6a7b89012; do echo "=== Processing $ENI_ID ===" aws ec2 describe-network-interfaces \ --network-interface-ids $ENI_ID \ --query "NetworkInterfaces[0].{Status:Status,AttachID:Attachment.AttachmentId}" \ --output table \ --region ap-southeast-2 ATTACH_ID=$(aws ec2 describe-network-interfaces \ --network-interface-ids $ENI_ID \ --query "NetworkInterfaces[0].Attachment.AttachmentId" \ --output text --region ap-southeast-2) if [ "$ATTACH_ID" != "None" ] && [ -n "$ATTACH_ID" ]; then echo "Detaching $ATTACH_ID..." aws ec2 detach-network-interface \ --attachment-id $ATTACH_ID \ --force \ --region ap-southeast-2 sleep 5 fi echo "Deleting $ENI_ID..." aws ec2 delete-network-interface \ --network-interface-id $ENI_ID \ --region ap-southeast-2 done3. Contact Lens Rules
Use this template URL when updating your Contact Lens Rules stack:
To apply each update:
Log in to the AWS Management Console and navigate to CloudFormation
Select the relevant stack from the list
Click Update stack (top right) → select Make a direct update
Under Prepare template, select Replace existing template
Under Specify template, select Amazon S3 URL
Paste the template URL for that stack into the Amazon S3 URL field and click Next
Step through the remaining prompts (Steps 2–4), leaving parameters as-is unless advised otherwise
Submit the update and monitor the Events tab until the stack shows
UPDATE_COMPLETE
Need help?
If you run into any issues or aren't sure which stacks apply to your setup, we're here to help.
📧 Email us at help@operata.com
💬 Or send a message directly from within the Operata application