Check TCP

Check TCP

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

Graphique réseau

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ètreValeur
<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.