Présentation
Surveillez la connectivité TCP et le délai de réponse pour n’importe quel host ou port.
Configuration
Installation
Le check TCP est inclus avec le package de l’Agent Datadog : vous n’avez donc rien d’autre à installer sur les hosts à partir desquels vous souhaitez sonder vos ports TCP. Bien qu’il soit généralement préférable d’exécuter les checks axés sur des métriques sur le même host que celui du service surveillé, ce check axé sur des statuts peut être lancé sur des hosts qui n’exécutent pas les services TCP surveillés (pour tester la connectivité à distance, par exemple).
Configuration
Host
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
Modifiez le fichier tcp_check.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent. Consultez le fichier d’exemple tcp_check.d/conf.yaml pour découvrir toutes les options de configuration disponibles :
init_config:
instances:
- name: SSH check
host: jumphost.example.com # ou une adresse IPv4/IPv6 address
port: 22
collect_response_time: true # pour recueiilir network.tcp.response_time. Défini sur false par défaut.
Options de configuration :
name (obligatoire) : le nom du service. Il sera inclus sous forme de tag : instance:<nom>. Remarque : les espaces et les tirets dans le nom du tag seront convertis en underscores.host (obligatoire) : le host à vérifier. Il sera inclus sous forme de tag : url:<host>:<port>.port (obligatoire) : le port à vérifier. Il sera inclus sous forme de tag : url:<host>:<port>.timeout (facultatif) : le délai d’expiration du check. Valeur par défaut : 10 secondes.collect_response_time (facultatif) : valeur par défaut : false. Si cette option n’est pas définie sur true, aucune métrique de délai de réponse ne sera recueillie. Si elle est définie sur true, la métrique renvoyée sera network.tcp.response_time.tags (facultatif) : les tags à attribuer à la métrique.
Redémarrez l’Agent pour commencer à envoyer vos métriques et checks de service TCP à Datadog.
Environnement conteneurisé
Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.
| Paramètre | Valeur |
|---|
<NOM_INTÉGRATION> | tcp_check |
<CONFIG_INIT> | vide ou {} |
<CONFIG_INSTANCE> | {"name": "<NOM_INSTANCE_CHECK_TCP>", "host":"%%host%%", "port":"%%port%%"} |
Validation
Lancez la sous-commande status de l’Agent et cherchez tcp_check dans la section Checks.
Données collectées
Métriques
network.tcp.response_time
(gauge) | The response time of a given host and TCP port, tagged with url, e.g. 'url:192.168.1.100:22'.
Shown as second |
network.tcp.can_connect
(gauge) | Value of 1 if the agent can successfully establish a connection to the URL, 0 otherwise |
Événements
Le check TCP n’inclut aucun événement.
Checks de service
tcp.can_connect :
Renvoie CRITICAL si l’Agent ne parvient pas à se connecter au host et au port configurés. Si ce n’est pas le cas, renvoie OK.
Pour créer des conditions d’alerte sur ce check de service dans Datadog, sélectionnez Network sur la page Create Monitor, et non Integration.
Dépannage
Besoin d’aide ? Contactez l’assistance Datadog.
