Las localizaciones privadas son contenedores Docker que puedes instalar en cualquier lugar de tu red privada. Puedes acceder a la imagen del worker de la localización privada en el hub Docker. Puede ejecutarse en un sistema operativo basado en Linux o un sistema operativo Windows, si el motor Docker está disponible en tu host y puede ejecutarse en modo de contenedor Linux.*

* El uso y el funcionamiento de este software se rigen por el Acuerdo de licencia del usuario final, disponible aquí.

Las localizaciones privadas son despliegues de Kubernetes que puedes instalar en tu clúster Kubernetes utilizando Helm. El Helm Chart puede ejecutarse en Kubernetes basado en Linux.

Nota: El uso y el funcionamiento de este software se rigen por el [Acuerdo de licencia del usuario final103.

Las localizaciones privadas son servicios de Windows que puedes instalar en cualquier lugar de tu red privada utilizando un archivo MSI. Ejecuta este archivo desde la máquina virtual o física en la que quieres instalar la localización privada.*

* El uso y el funcionamiento de este software se rigen por el Acuerdo de licencia del usuario final, disponible aquí.

Los requisitos de esta máquina se enumeran en la tabla siguiente. Los scripts de PowerShell deben estar habilitados en el equipo en el que instalas el worker de la localización privada.

Nota: Para que las localizaciones privadas de Windows ejecuten tests de navegador, los navegadores (por ejemplo, Chrome, Edge o Firefox) deben estar instalados en el ordenador Windows.

Debes instalar .NET versión 4.7.2 o posterior en tu ordenador antes de utilizar el instalador de MSI.

Ejecuta este comando para iniciar el worker de la localización privada montando tu archivo de configuración en el contenedor. Asegúrate de que tu archivo <MY_WORKER_CONFIG_FILE_NAME>.json está en /etc/docker y no la carpeta de inicio raíz:

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 tienes direcciones IP bloqueadas reservadas, añade [funcionalidades de Linux] NET_ADMIN1 a tu contenedor de localización privada.

Este comando inicia un contenedor Docker y prepara tu localización privada para realizar tests. Datadog recomienda ejecutar el contenedor en modo independiente con la política de reinicio adecuada.

Certificados raíz

Puedes cargar certificados raíz personalizados en tus localizaciones privadas para que tus tests de API y de navegador realicen el enlace SSL utilizando tus propios archivos .pem.

Cuando pongas en marcha tus contenedores de localizaciones privadas, monta los archivos de certificado .pem relevantes en /etc/datadog/certs/<filename>.pem del mismo modo que montarías un archivo de configuración de localización privada. Estos certificados se consideran CA de confianza y se utilizan en tiempo de ejecución de tests. Nota: Si combinas todos tus archivos .pem en un único archivo, el orden en el que se colocan los certificados es importante. Es necesario que el certificado intermedio preceda al certificado raíz para establecer correctamente una cadena de confianza.

Para obtener más información sobre parámetros de localizaciones privadas para administradores, consulta Configuración.

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

   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
   

   Nota: Si tienes IPs reservadas bloqueadas, añade las funcionalidades de Linux NET_ADMIN a tu contenedor de localización privada.

2. Empieza tu contenedor con:

   docker-compose -f docker-compose.yml up
   

Certificados raíz

Puedes cargar certificados raíz personalizados en tus localizaciones privadas para que tus tests de API y de navegador realicen el enlace SSL utilizando tus propios archivos .pem.

Cuando pongas en marcha tus contenedores de localizaciones privadas, monta los archivos de certificado .pem relevantes en /etc/datadog/certs del mismo modo que montarías un archivo de configuración de localización privada. Estos certificados se consideran CA de confianza y se utilizan en tiempo de ejecución de tests. Nota: Si combinas todos tus archivos .pem en un único archivo, el orden en el que se colocan los certificados es importante. Es necesario que el certificado intermedio preceda al certificado raíz para establecer correctamente una cadena de confianza.

Para obtener más información sobre parámetros de localizaciones privadas para administradores, consulta Configuración.

La configuración de Podman es muy similar a la de Docker, aunque necesitas definir NET_RAW como funcionalidad adicional para tener compatibilidad con los tests ICMP.

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

2. Ejecuta este comando para iniciar el worker de la localización privada montando tu archivo de configuración en el contenedor. Asegúrate de que tu archivo <MY_WORKER_CONFIG_FILE_NAME>.json esté accesible para montarlo en el contendor:

   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 tienes direcciones IP reservadas bloqueadas configuradas, añade las funcionalidades de Linux NET_ADMIN a tu contenedor de localización privada.

Este comando inicia un contenedor Podman y prepara tu localización privada para realizar tests. Datadog recomienda ejecutar el contenedor en modo independiente con la política de reinicio adecuada.

Para desplegar el worker de localizaciones privadas de forma segura, configura y monta un recurso de secreto de Kubernetes en el contenedor en /etc/datadog/synthetics-check-runner.json.

1. Crea 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. Utiliza despliegues para describir el estado deseado asociado a tus localizaciones privadas. Crea 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
   

   Nota: Si tienes IPs reservadas bloqueadas, añade las funcionalidades de Linux NET_ADMIN a tu contenedor de localización privada.

3. Aplica la configuración:

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

Para OpenShift, ejecuta la localización privada con el SCC anyuid. Esto es necesario para que se ejecute tu test de navegador.

Puedes configurar variables de entorno en tus parámetros de configuración que apunten a secretos ya configurados. Para crear variables de entorno con secretos, consulta la documentación de Kubernetes.

También puedes hacer lo siguiente:

1. Añade la localización privada Synthetics de Datadog a tus repositorios Helm:

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

2. Instala el chart con el nombre de la versión <RELEASE_NAME> utilizando el archivo JSON creado anteriormente:

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

Nota: Si tienes direcciones IP bloqueadas reservadas, añade [funcionalidades de Linux] NET_ADMIN2 a tu contenedor de localización privada.

Crea una nueva definición de tarea de EC2 que coincida con lo siguiente. Sustituye cada parámetro con el valor correspondiente de tu archivo de configuración de localización privada generado anteriormente:

{
    ...
    "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 tienes direcciones IP reservadas bloqueadas, configura un parámetro de Linux para conceder funcionalidades NET_ADMIN a tus contenedores de localización privada.
• Si utilizas las variables de entorno DATADOG_API_KEY, DATADOG_ACCESS_KEY, DATADOG_SECRET_ACCESS_KEY, DATADOG_PUBLIC_KEY_PEM y DATADOG_PRIVATE_KEY, no es necesario incluirlas en la sección "command": [ ].

Si deseas almacenar la configuración en AWS Secret Manager, consulta la pestaña Fargate con AWS Secret Manager.

Crea una nueva definición de tarea de Fargate que coincida con lo siguiente. Sustituye cada parámetro con el valor correspondiente de tu archivo de configuración de localización privada generado anteriormente:

{
    ...
    "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: Como la opción de firewall de localización privada no es compatible con AWS Fargate, no es posible configurar el parámetro enableDefaultBlockedIpRanges como true.

Crea un secreto en AWS Secret Manager para almacenar toda o parte de la configuración de localización privada generada anteriormente. Ten en cuenta que la publicKey no puede guardarse tal cual 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 en Secret Manager. Consulta [Especificación de datos confidenciales mediante secretos de Secret Manager en Amazon ECS][25] para obtener más información.

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

Si no guardaste toda la configuración en Secret Manager, todavía puedes pasar el valor como argumentos de cadena codificados, consulta la [pestaña de Fargate]./?tab=fargate#install-your-private-location) y haz una mezcla.

{
    ...
    "containerDefinitions": [
        {
            "entryPoint": [
                "/bin/bash",
                "-c"
            ],
            "command": [
                "/home/dog/scripts/entrypoint.sh --locationID=$locationID --publicKey.fingerprint=$fingerprint"
            ],
            "secret": [
              {
                "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: Como la opción de firewall de localización privada no es compatible con AWS Fargate, no es posible configurar el parámetro enableDefaultBlockedIpRanges como true.

Como Datadog ya se integra con Kubernetes y AWS, está preparado para monitorizar EKS.

1. Crea 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. Utiliza despliegues para describir el estado deseado asociado a tus localizaciones privadas. Crea 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
   

   Nota: Si tienes direcciones IP reservadas bloqueadas, configura un contexto de seguridad para conceder funcionalidades de Linux NET_ADMIN a tus contenedores de localización privada.

3. Aplica la configuración:

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

1. Descarga el archivo datadog-synthetics-worker-1.55.0.amd64.msi y ejecútalo desde la máquina en la que deseas instalar la localización privada.

2. Haz clic en Next (Siguiente) en la página de bienvenida, lee el EULA y acepta los términos y condiciones. Luego, haz clic en Next (Siguiente).

3. Modifica dónde se instalará la aplicación o deja la configuración predeterminada. Haz clic en Next (Siguiente).

4. Para configurar tu localización Windows privada, puedes:

   • Pegar e introducir una configuración JSON para tu worker de la localización privada Synthetics de Datadog. Este archivo es generado por Datadog cuando creas una localización privada.

   • Busca o escribe una ruta de acceso a un archivo que contenga una configuración JSON para tu worker de la localización privada Synthetics de Datadog.

   • Una vez finalizada la instalación, puedes dejarla en blanco y ejecutar C:\\Program Files\Datadog-Synthetics\Synthetics\synthetics-pl-worker.exe --config=<PathToYourConfiguration> en la línea de comandos Windows.

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

   Aplica las reglas de firewall que necesita este programa a Windows Firewall

   Permite que el instalador aplique reglas de firewall durante la instalación y las elimine durante la desinstalación.

   Aplica reglas para bloquear direcciones IP reservadas en Windows Firewall

   Configura reglas de bloqueo para Chrome, Firefox y Edge (si están instalados) y añade reglas para bloquear rangos de direcciones IP reservadas salientes en Windows Firewall.

   Habilita el registro de archivos

   Permite que el worker de la localización privada Synthetics registre archivos en el directorio de instalación.

   Días de rotación de logs

   Especifica cuántos días conservar logs antes de eliminarlos del sistema local.

   Verbosidad del registro

   Especifica la verbosidad de la consola y el registro de archivos para el el worker de la localización privada Synthetics.

6. Haz clic en Next (Siguiente) e Install (Instalar) para iniciar el proceso de instalación.

Una vez completado el proceso, haz clic en Finish (Finalizar) en la página de finalización de la instalación.

1. Descarga el archivo datadog-synthetics-worker-1.55.0.amd64.msi y ejecútalo desde la máquina en la que deseas instalar la localización privada.

2. Ejecuta uno de los siguientes comandos dentro del directorio en el que descargaste el instalador.

   • En un terminal PowerShell:

     Start-Process msiexec "/i datadog-synthetics-worker-1.55.0.amd64.msi /quiet /qn WORKERCONFIG_FILEPATH=C:\ProgramData\Datadog-Synthetics\worker-config.json";
     

   • O en un terminal de comandos:

     msiexec /i datadog-synthetics-worker-1.55.0.amd64.msi /quiet /qn WORKERCONFIG_FILEPATH=C:\ProgramData\Datadog-Synthetics\worker-config.json
     

Se pueden añadir parámetros adicionales: