Install Synthetics for Dual Stack using Podman

This guide covers the configuration and deployment of the New Relic Synthetics job manager to support Dual Stack (IPv4 and IPv6) testing in your private location environment using Podman.

Prerequisites

Before you begin, ensure you have the following:

Podman: Podman must be installed and running on your host instance
slirp4netns: Required for IPv6 support in rootless containers (version 1.0.0 or higher, typically installed with Podman)
Permissions: You must have appropriate access to run rootless containers
Public images: Dual Stack support requires the following image versions or later, available on Docker Hub:
- Job manager 519 or later: newrelic/synthetics-job-manager
- Ping runtime 1.65.0 or later: newrelic/synthetics-ping-runtime
- Node API runtime rc1.15 or later: newrelic/synthetics-node-api-runtime
- Node browser runtime rc1.15 or later: newrelic/synthetics-node-browser-runtime

Validate your infrastructure

Before proceeding, verify that your host machine and network are configured for Dual Stack networking.

Test IPv6 connectivity by running ping6 ipv6.google.com or ping -6 ipv6.google.com, or the equivalent command for your machine.

Importante

If the test fails, ensure your VPC, subnet, and security groups are configured to allow IPv6 traffic before continuing with this installation. Your environment must support both IPv4 and IPv6 for Dual Stack operation.

Set up the Podman environment

Set up the Podman environment by following the Podman Dependencies Guide.

Create a Podman pod

Create a pod with your host machine IP address:

bash

$podman pod create --network slirp4netns --name SYNTHETICS --add-host=podman.service:IP_ADDRESS

Replace IP_ADDRESS with your host machine's IP address.

Launch the Synthetics job manager

Sugerencia

Replace <YOUR_PRIVATE_LOCATION_KEY> with your actual private location key from the New Relic UI.

bash

$podman run \
>  -e PRIVATE_LOCATION_KEY=<YOUR_PRIVATE_LOCATION_KEY> \
>  --pod SYNTHETICS \
>  -d \
>  --restart unless-stopped \
>  -e "CONTAINER_ENGINE=PODMAN" \
>  -e "PODMAN_API_SERVICE_PORT=8000" \
>  -e "PODMAN_POD_NAME=SYNTHETICS" \
>  newrelic/synthetics-job-manager

The Synthetics job manager will now be running with Dual Stack support enabled, allowing your monitors to test both IPv4 and IPv6 endpoints.

Verify installation

To confirm your Synthetics job manager is running correctly:

View the job manager logs:
bash
```
$podman logs -f YOUR_CONTAINER_ID
```
In the New Relic UI, go to one.newrelic.com > All capabilities > Synthetic monitoring > Private locations and verify your private location shows as healthy.

What's next?

After setting up your Dual Stack-enabled private location, you can:

Create synthetic monitors that test both IPv4 and IPv6 endpoints using your private location
Configure job manager settings for advanced options
Monitor your private location health and performance