Las ubicaciones privadas son contenedores Docker que puede instalar en cualquier lugar dentro de su red privada. Puede acceder a la imagen del trabajador de ubicación privada en Docker hub. Puede ejecutarse en un sistema operativo basado en Linux o en Windows si el motor de Docker está disponible en su host y puede funcionar en modo de contenedores de Linux.*

* El uso y operación de este software está regido por el Acuerdo de Licencia de Usuario Final disponible aquí.

Las ubicaciones privadas son implementaciones de Kubernetes que puede instalar en su clúster de Kubernetes con Helm. El chart de helm puede ejecutarse en Kubernetes basado en Linux.

Nota: El uso y operación de este software está regido por el Acuerdo de Licencia de Usuario Final.

Las ubicaciones privadas son servicios de Windows que puede instalar en cualquier lugar dentro de su red privada utilizando un archivo MSI. Ejecute este archivo desde la máquina virtual o física en la que desea instalar la ubicación privada.*

* El uso y operación de este software está regido por el Acuerdo de Licencia de Usuario Final disponible aquí.

Los requisitos de esta máquina se enumeran en la tabla a continuación. La ejecución de scripts de PowerShell debe estar habilitada en la máquina en la que está instalando el trabajador de ubicación privada.

Nota: Para que las Ubicaciones Privadas de Windows ejecuten pruebas en el navegador, los navegadores (por ejemplo, Chrome, Edge o Firefox) deben estar instalados en la computadora con Windows.

Debe instalar la versión 4.7.2 o posterior de .NET en su computadora antes de usar el instalador MSI.

Habilitar el modo criptográfico FIPS 140-2:
Habilitar módulos criptográficos compatibles con FIPS para comunicaciones seguras. El host de Windows debe estar ejecutándose en modo FIPS de Windows para usar esta opción. Disponible en Ubicación Privada v1.63.0 y superior.

Ejecute este comando para iniciar su trabajador de ubicación privada montando su archivo de configuración en el contenedor. Asegúrese de que su <MY_WORKER_CONFIG_FILE_NAME>.json archivo esté en /etc/docker, no en la carpeta raíz de inicio:

docker run -d --restart unless-stopped -v $PWD/<MY_WORKER_CONFIG_FILE_NAME>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker:latest

Nota: Si ha bloqueado IPs reservadas, agregue las NET_ADMIN capacidades de Linux a su contenedor de ubicación privada.

Este comando inicia un contenedor de Docker y prepara su ubicación privada para ejecutar pruebas. Datadog recomienda ejecutar el contenedor en modo desacoplado con una política de reinicio adecuada.

1. Cree un archivo docker-compose.yml con:

   version: "3"
   services:
       synthetics-private-location-worker:
           image: datadog/synthetics-private-location-worker:latest
           volumes:
               - PATH_TO_PRIVATE_LOCATION_CONFIG_FILE:/etc/datadog/synthetics-check-runner.json
   

   Note: If you have blocked reserved IPs, add the NET_ADMIN Linux capabilities to your private location container.

2. Inicie su contenedor con:

   docker-compose -f docker-compose.yml up
   

La configuración de Podman es muy similar a Docker; sin embargo, debe establecer NET_RAW como una capacidad adicional para soportar pruebas ICMP.

1. Ejecute sysctl -w "net.ipv4.ping_group_range = 0 2147483647" desde el servidor donde se ejecuta el contenedor.

2. Ejecute este comando para iniciar su trabajador de ubicación privada montando su archivo de configuración en el contenedor. Asegúrese de que su archivo <MY_WORKER_CONFIG_FILE_NAME>.json sea accesible para montarlo en el contenedor:

   podman run --cap-add=NET_RAW --rm -it -v $PWD/<MY_WORKER_CONFIG_FILE_NAME>.json:/etc/datadog/synthetics-check-runner.json gcr.io/datadoghq/synthetics-private-location-worker:latest
   

   Si ha configurado direcciones IP reservadas bloqueadas, agregue NET_ADMIN las capacidades de Linux a su contenedor de ubicación privada.

Este comando inicia un contenedor de Podman y prepara su ubicación privada para ejecutar pruebas. Datadog recomienda ejecutar el contenedor en modo desacoplado con una política de reinicio adecuada.

Para desplegar el trabajador de ubicación privada de manera segura, configure y monte un secreto de Kubernetes en el contenedor bajo /etc/datadog/synthetics-check-runner.json.

1. Cree un secreto de Kubernetes con el archivo JSON creado previamente ejecutando lo siguiente:

   kubectl create secret generic private-location-worker-config --from-file=<MY_WORKER_CONFIG_FILE_NAME>.json
   

2. Utilice despliegues para describir el estado deseado asociado con sus ubicaciones privadas. Cree el siguiente archivo private-location-worker-deployment.yaml:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: datadog-private-location-worker
     namespace: default
   spec:
     selector:
       matchLabels:
         app: private-location
     template:
       metadata:
         name: datadog-private-location-worker
         labels:
           app: private-location
       spec:
         containers:
         - name: datadog-private-location-worker
           image: datadog/synthetics-private-location-worker
           volumeMounts:
           - mountPath: /etc/datadog/synthetics-check-runner.json
             name: worker-config
             subPath: <MY_WORKER_CONFIG_FILE_NAME>
         volumes:
         - name: worker-config
           secret:
             secretName: private-location-worker-config
   

   Note: If you have blocked reserved IPs, add the NET_ADMIN Linux capabilities to your private location container.

3. Aplique la configuración:

   kubectl apply -f private-location-worker-deployment.yaml
   

Para OpenShift, ejecute la ubicación privada con el SCC anyuid. Esto es necesario para que su prueba de navegador se ejecute.

Puede establecer variables de entorno en sus parámetros de configuración que apunten a secretos que ya ha configurado. Para crear variables de entorno con secretos, consulte la documentación de Kubernetes.

Alternativamente:

1. Agregue la Ubicación Privada de Datadog Synthetics a sus repositorios de Helm:

   helm repo add datadog https://helm.datadoghq.com
   helm repo update
   

2. Instale el gráfico con el nombre de lanzamiento <RELEASE_NAME> utilizando el archivo JSON creado previamente:

   helm install <RELEASE_NAME> datadog/synthetics-private-location --set-file configFile=<MY_WORKER_CONFIG_FILE_NAME>.json
   

Nota: Si ha bloqueado IPs reservadas, agregue NET_ADMIN las capacidades de Linux a su contenedor de ubicación privada.

Cree una nueva definición de tarea EC2 que coincida con lo siguiente. Reemplace cada parámetro con el valor correspondiente encontrado en su archivo de configuración de ubicación privada generado previamente:

{
    ...
    "containerDefinitions": [
        {
            "command": [
                "--site='...'",
                "--locationID='...'",
                "--accessKey='...'",
                "--datadogApiKey='...'",
                "--secretAccessKey='...'",
                "--privateKey='-----BEGIN RSA PRIVATE KEY-----XXXXXXXX-----END RSA PRIVATE KEY-----'",
                "--publicKey.pem='-----BEGIN PUBLIC KEY-----XXXXXXXX-----END PUBLIC KEY-----'",
                "--publicKey.fingerprint='...'"
            ],
            ...
            "image": "datadog/synthetics-private-location-worker:latest",
            ...
        }
    ],
    ...
    "compatibilities": [
        "EC2"
    ],
    ...
}

Notas:

• Si ha bloqueado IPs reservadas, configure un linuxParameters para otorgar NET_ADMIN capacidades a sus contenedores de ubicación privada.
• Si utiliza las variables de entorno DATADOG_API_KEY, DATADOG_ACCESS_KEY, DATADOG_SECRET_ACCESS_KEY, DATADOG_PUBLIC_KEY_PEM y DATADOG_PRIVATE_KEY, no necesita incluirlas en la sección "command": [ ].

Cree una nueva definición de tarea Fargate que coincida con lo siguiente. Reemplace cada parámetro con el valor correspondiente encontrado en su archivo de configuración de ubicación privada generado previamente:

{
    ...
    "containerDefinitions": [
        {
            "command": [
                "--site='...'",
                "--locationID='...'",
                "--accessKey='...'",
                "--datadogApiKey='...'",
                "--secretAccessKey='...'",
                "--privateKey='-----BEGIN RSA PRIVATE KEY-----XXXXXXXX-----END RSA PRIVATE KEY-----'",
                "--publicKey.pem='-----BEGIN PUBLIC KEY-----XXXXXXXX-----END PUBLIC KEY-----'",
                "--publicKey.fingerprint='...'"
            ],
            ...
            "image": "datadog/synthetics-private-location-worker:latest",
            ...
        }
    ],
    ...
    "compatibilities": [
        "EC2",
        "FARGATE"
    ],
    ...
}

Nota: Debido a que la opción de firewall de ubicación privada no es compatible con AWS Fargate, el parámetro enableDefaultBlockedIpRanges no puede establecerse en true.

Cree un secreto en el administrador de secretos de AWS para almacenar todo o parte de la configuración de ubicación privada generada previamente. Tenga en cuenta que el publicKey no puede mantenerse tal como está en el archivo de configuración. Por ejemplo:

{
    "datadogApiKey": "...",
    "id": "...",
    "site": "...",
    "accessKey": "...",
    "secretAccessKey": "...",
    "privateKey": "...",
    "pem": "...",
    "fingerprint": "..."
}

Se requieren permisos para permitir que la definición de tarea y la instancia de AWS Fargate lean del administrador de secretos. Consulte Especificar datos sensibles utilizando secretos de Secrets Manager en Amazon ECS para más información.

Cree una definición de tarea de Fargate que coincida con el siguiente ejemplo, reemplazando los valores en la lista de secretos con el ARN del secreto que creó en el paso anterior. Por ejemplo: arn:aws:secretsmanager:<region>:<account-id>:secret:<secret_arn>:<secret_key>::.

Si no guardó toda la configuración en el administrador de secretos, aún puede pasar el valor como argumentos de cadena codificados.

{
    ...
    "containerDefinitions": [
        {
            "entryPoint": [
                "/bin/bash",
                "-c"
            ],
            "command": [
                "/home/dog/scripts/entrypoint.sh --locationID=$locationID --publicKey.fingerprint=$fingerprint"
            ],
            "secrets": [
              {
                "name": "DATADOG_ACCESS_KEY",
                "valueFrom": "..."
              },
              {
                "name": "DATADOG_API_KEY",
                "valueFrom": "...",
              },
              {
                "name": "fingerprint",
                "valueFrom": "...",
              },
              {
                "name": "locationID",
                "valueFrom": "...",
              },
              {
                "name": "DATADOG_PUBLIC_KEY_PEM",
                "valueFrom": "...",
              },
              {
                "name": "DATADOG_PRIVATE_KEY",
                "valueFrom": "...",
              },
              {
                "name": "DATADOG_SECRET_ACCESS_KEY",
                "valueFrom": "...",
              },
              {
                "name": "DATADOG_SITE",
                "valueFrom": "...",
              }
            ],
            ...
            "image": "datadog/synthetics-private-location-worker:latest",
            ...
        }
    ],
    ...
    "compatibilities": [
        "EC2",
        "FARGATE"
    ],
    ...
}

Nota: Debido a que la opción de firewall de ubicación privada no es compatible con AWS Fargate, el parámetro enableDefaultBlockedIpRanges no puede establecerse en true.

Debido a que Datadog ya se integra con Kubernetes y AWS, está listo para monitorear EKS.

1. Cree un secreto de Kubernetes con el archivo JSON creado anteriormente ejecutando lo siguiente:

   kubectl create secret generic private-location-worker-config --from-file=<MY_WORKER_CONFIG_FILE_NAME>.json
   

2. Utilice despliegues para describir el estado deseado asociado con sus ubicaciones privadas. Cree el siguiente archivo private-location-worker-deployment.yaml:

   apiVersion: apps/v1
   kind: Deployment
   metadata:
     name: datadog-private-location-worker
     namespace: default
   spec:
     selector:
       matchLabels:
         app: private-location
     template:
       metadata:
         name: datadog-private-location-worker
         labels:
           app: private-location
       spec:
         containers:
         - name: datadog-private-location-worker
           image: datadog/synthetics-private-location-worker
           volumeMounts:
           - mountPath: /etc/datadog/synthetics-check-runner.json
             name: worker-config
             subPath: <MY_WORKER_CONFIG_FILE_NAME>
         volumes:
         - name: worker-config
           configMap:
             name: private-location-worker-config
   

   Note: If you have blocked reserved IPs, configure a security context to grant NET_ADMIN Linux capabilities to your private location containers.

3. Aplique la configuración:

   kubectl apply -f private-location-worker-deployment.yaml
   

1. Descargue el archivo datadog-synthetics-worker-1.73.0.amd64.msi y ejecute este archivo desde la máquina en la que desea instalar la ubicación privada.

2. Haga clic en Siguiente en la página de bienvenida, lea el EULA y acepte los términos y condiciones. Haga clic en Siguiente.

3. Modifique dónde se instalará la aplicación, o deje la configuración predeterminada. Haga clic en Siguiente.

4. Para configurar su ubicación privada de Windows, puede optar por:

   • Pegue e ingrese una configuración JSON para su Trabajador de Ubicación Privada de Datadog Synthetics. Este archivo es generado por Datadog cuando cree una ubicación privada.

   • Navegue o escriba una ruta de archivo a un archivo que contenga una configuración JSON para su Trabajador de Ubicación Privada de Datadog Synthetics.

   • Puede dejarlo en blanco y ejecutar C:\\Program Files\Datadog-Synthetics\Synthetics\synthetics-pl-worker.exe --config=<PathToYourConfiguration> en el símbolo del sistema de Windows después de que la instalación esté completa.

5. Puede aplicar las siguientes opciones de configuración:

   Aplique las reglas de firewall necesarias para este programa en el Firewall de Windows.

   Permita que el instalador aplique las reglas de firewall durante la instalación y las elimine al desinstalar.

   Aplique reglas para bloquear IPs reservadas en el Firewall de Windows.

   Configure reglas de bloqueo para Chrome, Firefox y Edge (si están instalados) y agregue reglas para bloquear rangos de direcciones IP reservadas salientes en el Firewall de Windows.

   Habilitar registro de archivos.

   Permita que el trabajador de ubicación privada de Synthetics registre archivos en el directorio de instalación.

   Días de rotación de registros.

   Especifica cuántos días mantener los registros antes de eliminarlos del sistema local.

   Verbosidad del registro.

   Especifica la verbosidad del registro en consola y archivos para el trabajador de ubicación privada de Synthetics.

   Habilitar modo criptográfico FIPS 140-2.

   Habilite módulos criptográficos compatibles con FIPS para comunicaciones seguras. El servidor de Windows debe estar ejecutándose en modo FIPS de Windows para usar esta opción. Disponible en Private Location v1.63.0 y superiores.

6. Haga clic en Siguiente y Instalar para iniciar el proceso de instalación.

Una vez que el proceso esté completo, haga clic en Finalizar en la página de finalización de la instalación.

1. Descargue el archivo datadog-synthetics-worker-1.73.0.amd64.msi y ejecute este archivo desde la máquina en la que desea instalar la ubicación privada.

2. Ejecute uno de los siguientes comandos dentro del directorio donde descargó el instalador:

   • En una terminal de PowerShell:

     Start-Process msiexec "/i datadog-synthetics-worker-1.73.0.amd64.msi /quiet /qn CONFIG_FILEPATH=<ruta_a_tu_archivo_de_configuración_de_trabajador>";
     

   • O en una terminal de comandos:

     msiexec /i datadog-synthetics-worker-1.73.0.amd64.msi /quiet /qn CONFIG_FILEPATH=<ruta_a_tu_archivo_de_configuración_de_trabajador>
     

Se pueden agregar parámetros adicionales:

Para habilitar el modo criptográfico FIPS 140-2, establezca la variable de entorno ENABLE_FIPS=1 antes de ejecutar el ejecutable del trabajador. El servidor de Windows debe estar ejecutándose en modo FIPS de Windows para usar esta opción. Disponible en Private Location v1.63.0 y superiores.

Ejemplo:

set ENABLE_FIPS=1 && .\synthetics-pl-worker.exe --config "<PathToYourConfiguration>"

Al iniciar sus contenedores de ubicación privada, monte los archivos de certificado relevantes .pem en /etc/datadog/certs de la misma manera que monta su archivo de configuración de ubicación privada. Estos certificados son considerados CA de confianza y se utilizan en el tiempo de ejecución de las pruebas.

Para instalar certificados raíz para ubicaciones privadas en un servicio de Windows, use los siguientes pasos:

1. Abra la aplicación del Editor del Registro.
2. Navegue a la entrada Computer\HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\synthetics-private-location.
3. Cree una clave del Registro llamada Environment con el tipo de valor Multi-string.

4. Establezca el valor NODE_EXTRA_CA_CERTS=C:\Program Files\Datadog-Synthetics\Synthetics\CACert.pem

5. Abra la aplicación de Servicios y recargue el servicio de Ubicación Privada de Monitoreo Sintético de Datadog.

Para instalar certificados raíz para ubicaciones privadas en un proceso independiente de Windows con synthetics-private-location.exe, utilice los siguientes pasos:

1. Abra su símbolo del sistema de Windows o PowerShell.

2. Establezca la variable de entorno y llame al ejecutable.

Ejemplo:

set NODE_EXTRA_CA_CERTS=C:\Program Files\Datadog-Synthetics\Synthetics\CACert.pem && .\synthetics-private-location.exe --config "C:\ProgramData\Datadog-Synthetics\Synthetics\worker-config.json"

Para habilitar el modo criptográfico FIPS 140-2, incluya ENABLE_FIPS=1:

set ENABLE_FIPS=1 && set NODE_EXTRA_CA_CERTS=C:\Program Files\Datadog-Synthetics\Synthetics\CACert.pem && .\synthetics-private-location.exe --config "C:\ProgramData\Datadog-Synthetics\Synthetics\worker-config.json"

El servidor de Windows debe estar ejecutándose en modo FIPS de Windows para usar esta opción. Disponible en Private Location v1.63.0 y superiores.