Débuter avec les emplacements privés

Docs > Getting Started > Débuter avec la surveillance Synthetic > Débuter avec les emplacements privés

L'accès à cette fonctionnalité est restreint. Si vous n'êtes pas autorisé à y accéder, contactez l'assistance Datadog.

Présentation

Les emplacements privés vous permettent de surveiller des applications internes ou des URL privées qui ne sont pas accessibles sur l’Internet public.

Vous pouvez également les utiliser pour effectuer les actions suivantes :

Créer des emplacements privés dans des zones stratégiques de votre entreprise.
Vérifier les performances des applications dans votre environnement de test interne avant de mettre en production de nouvelles fonctionnalités avec les tests Synthetic dans vos pipelines de CI/CD.
Comparer les performances des applications à l’intérieur et à l’extérieur de votre réseau interne.

Les emplacements privés sont des conteneurs Docker que vous pouvez installer où vous voulez à l’intérieur de votre réseau privé. Vous pouvez accéder à l’image du worker d’emplacement privé dans Google Container Registry.

Une fois votre emplacement privé créé et installé, vous pouvez lui assigner des tests Synthetic tout comme avec un emplacement géré. Les résultats des tests de vos emplacements privés s’affichent de la même façon que ceux de vos emplacements gérés.

Assigner un test Synthetic à des emplacements privés

Créer votre emplacement privé

Installez Docker sur une machine. Pour gagner du temps, vous pouvez installer Docker sur une machine virtuelle telle que Vagrant Ubuntu 16.04.
Sur le site Datadog, passez votre curseur sur UX Monitoring et sélectionnez Settings > Private Locations.
Cliquez sur Add Private Location.
Renseignez les détails de votre emplacement privé (seuls les champs Name et API key sont obligatoires). Vous devrez peut-être configurer des paramètres supplémentaires en fonction de l’endroit où vous avez installé votre emplacement privé (par exemple, derrière un proxy). Pour en savoir plus, consultez la section sur les options de configuration des emplacements privés.
Cliquez sur Save Location and Generate Configuration File pour générer le fichier de configuration associé à votre emplacement privé sur votre worker.
Copiez et collez le fichier de configuration de votre emplacement privé dans votre répertoire de travail.
Remarque : le fichier de configuration contient des secrets pour l’authentification de l’emplacement privé, le déchiffrement de la configuration de test et le chiffrement des résultats de test. Comme Datadog ne conserve pas les secrets, veillez à les stocker localement avant de quitter la page Private Locations. Vous aurez à nouveau besoin de ces secrets pour ajouter d’autres workers à votre emplacement privé.

Lancez votre worker en tant que conteneur autonome à l’aide de la commande run Docker et du fichier de configuration précédemment créé :

docker run --rm -v $PWD/worker-config-<LOCATION_ID>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker

Si votre emplacement privé communique normalement avec Datadog, le statut de santé OK s’affiche dans votre liste Private Locations sous Settings :

Vous devriez également recevoir des logs d’emplacements privés sur votre terminal :

2019-12-17 13:05:03 [info]: Fetching 10 messages from queue - 10 slots available
2019-12-17 13:05:03 [info]: Fetching 10 messages from queue - 10 slots available
2019-12-17 13:05:04 [info]: Fetching 10 messages from queue - 10 slots available

Vous pouvez utiliser votre nouvel emplacement privé de la même manière qu’un emplacement géré pour exécuter vos tests Synthetic.

Exécuter des tests Synthetic à partir d’un emplacement privé

Créez un test API, un test API à plusieurs étapes ou un test Browser pour n’importe quel endpoint interne ou n’importe quelle application interne que vous souhaitez surveiller.
Sous Private Locations, sélectionnez votre nouvel emplacement privé :
Continuez en renseignant les informations relatives à votre test.