Check TCP
Rapport de recherche Datadog : Bilan sur l'adoption de l'informatique sans serveur Rapport : Bilan sur l'adoption de l'informatique sans serveur

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.

Implémentation

Installation

Le check TCP est inclus avec le paquet 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

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour en savoir plus sur les environnements conteneurisés.

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 checks de service et délais de réponse 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 DOWN si l’Agent n’est pas capable de se connecter au host et au port configurés. Si ce n’est pas le cas, renvoie UP.

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.