Empezando con las localizaciones privadas

Docs > Empezando > Empezando con la monitorización Synthetic > Empezando con las localizaciones privadas

Información general

Las localizaciones privadas te permiten monitorizar aplicaciones internas o direcciones URL privadas que no son accesibles a través de la red pública de Internet.

Diagrama de arquitectura que muestra cómo funciona una localización privada durante la monitorización de Synthetic

También puedes utilizar las localizaciones privadas para:

Crear localizaciones personalizadas en áreas consideradas críticas para el desarrollo de tu negocio.
Verificar el rendimiento de la aplicación en tu entorno de testeo interno antes de lanzar nuevas funciones a la fase de producción con tests Synthetic en tus pipelines de integración/distribución continuas (CI/CD).
Comparar el rendimiento de la aplicación desde dentro y fuera de tu red interna.

Los localizaciones privadas son contenedores de servicios de Docker o Windows que puedes instalar en cualquier lugar de tu red privada. Recupera la imagen Docker en Google Container Registry o descarga el instalador de Windows.

Una vez que hayas creado e instalado tu localización privada, puedes asignar tests Synthetic a tu localización privada igual que harías con una localización gestionada.

Los resultados de los tests de las localizaciones privadas se muestran de forma idéntica a los resultados de los tests de la localización gestionada.

Asignar un test Synthetic a localizaciones privadas

Crea tu localización privada

En el sitio de Datadog, pasa el cursor sobre UX Monitoring (Monitorizar la experiencia de uso) y selecciona Settings* > Private Locations (Configuración > Localizaciones privadas).
Haz clic en Add Private Location (Añadir localización privada).
Rellena los datos de tu localización privada. Solo los campos Name y API key son obligatorios.
Haz clic en Save Location and Generate Configuration File (Guardar localización y generar archivo de configuración) para generar el archivo de configuración asociado a tu localización privada en tu worker.
Dependiendo de dónde hayas instalado tu localización privada, es posible que tengas que introducir parámetros adicionales en el archivo de configuración:
- Si utilizas un proxy, introduce la URL del siguiente modo: http://<YOUR_USER>:<YOUR_PWD>@<YOUR_IP>:<YOUR_PORT>.
- Si quieres bloquear direcciones IP reservadas, activa Block reserved IPs (Bloquear IP reservadas) e introduce los rangos de IP.
Para obtener más información, consulta las opciones de configuración de las localizaciones privadas y cómo realizar tests Synthetic desde localizaciones privadas.
Copia y pega el archivo de configuración de tu localización privada en tu directorio de trabajo.
Nota: El archivo de configuración contiene secretos para autenticar la localización privada, descifrar la configuración del test y cifrar sus resultados. Datadog no almacena estos secretos, así que guárdalos en una unidad local antes de salir del formulario de creación de localizaciones privadas. Para poder añadir más workers a tu localización privada, es necesario que puedas volver a consultar estos secretos.
Cuando lo tengas todo listo, haz clic en View Installation Instructions (Ver instrucciones de instalación).
Sigue las instrucciones de instalación en función del entorno en el que quieras ejecutar el worker de la localización privada.
Si utilizas Docker, lanza tu worker como un contenedor autónomo utilizando el comando Docker run y tu archivo de configuración:
```
docker run --rm -v $PWD/worker-config-<LOCATION_ID>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker
```
Este comando inicia un contenedor Docker y prepara tu localización privada para ejecutar pruebas. Datadog recomienda ejecutar el contenedor en modo separado con la política de reinicio adecuada.
Puedes utilizar otro tiempo de ejecución de contenedor, como por ejemplo Podman. Para obtener más información, consulta la documentación sobre localizaciones privadas.
Si utiliza Windows, ejecuta el instalador de localizaciones privadas de Synthetics con una GUI]12 o ejecuta el comando msiexec en la línea de comandos, dentro del directorio donde has descargado el instalador:
```
msiexec /i datadog-synthetics-worker-1.53.0.amd64.msi
```
Si tu localización privada envía información correctamente a Datadog, aparecerá un OK en Private Location Status (Estado de la localización privada) y en la lista de Private Locations (Localizaciones privadas) de la página Settings (Configuración):
Además, puedes ver los logs de una localización privada en tu terminal:
```
2022-02-28 16:20:03 [info]: Fetching 10 messages from queue - 10 slots available
2022-02-28 16:20:03 [info]: Fetching 10 messages from queue - 10 slots available
2022-02-28 16:20:04 [info]: Fetching 10 messages from queue - 10 slots available
```
Una vez que hayas terminado con todos los tests de tu endpoint interno, haz clic en OK.

Ejecuta tests Synthetic con tu localización privada

Utiliza tu nueva localización privada como si fuese una localización gestionada en tus test de Synthetic.

Crea un test de API, un test de API multipaso o un test de navegador en cualquier endpoint interno o aplicación que quieras monitorizar.
En la sección Private Locations, selecciona tu nueva localización privada:
¡Continúa rellenando el test!