Les tests ICMP vous permettent de surveiller la disponibilité de vos hosts et de diagnostiquer les problèmes de communication réseau. En appliquant des assertions sur les valeurs d’un ou de plusieurs pings ICMP vers votre endpoint, Datadog peut vous aider à détecter les problèmes de connectivité, les durées d’aller-retour qui dépassent la limite de latence, ainsi que les changements inattendus de configuration du pare-feu de sécurité. Les tests peuvent également surveiller le nombre de hops réseau (TTL) requis pour se connecter à votre host et afficher les résultats du traceroute, afin de visualiser les détails de chaque hop réseau durant l’itinéraire.
Les tests ICMP peuvent être exécutés depuis des emplacements gérés et des emplacements privés, selon que vous souhaitez déclencher vos pings ICMP vers vos endpoints depuis l’extérieur ou au sein de votre réseau. L’exécution des tests ICMP peut être planifiée, peut s’effectuer à la demande ou peut être lancée directement depuis vos pipelines de CI/CD.
Après avoir choisi de créer un test ICMP, définissez la requête de votre test.
env et tout autre tag de votre choix à votre test ICMP. Vous pourrez par la suite utiliser ces tags pour filtrer rapidement vos tests Synthetic depuis la page d’accueil de la surveillance Synthetic.Cliquez sur Test URL pour essayer la configuration de requête. Un aperçu de la réponse s’affiche sur le côté droit de votre écran.
Les assertions définissent un résultat de test escompté. Cliquez sur Test URL pour ajouter les assertions de base pour latency, packet loss et packet received. Vous devez définir au moins une assertion à surveiller pour votre test.
| Type | Agrégation | Opérateur | Type de valeur |
|---|---|---|---|
| latency | avg, max, min ou stddev (à savoir jitter) | is less than, is less than or equal,is, is more than, is more than or equal | Nombre entier (ms) |
| packet loss | - | is less than, is less than or equal, is, is more than, is more than or equal | Pourcentage (%) |
| packet received | - | is less than, is less than or equal, is, is more than, is more than or equal | Nombre entier |
| network hops | - | is less than, is less than or equal, is, is more than, is more than or equal | Nombre entier |
Vous pouvez créer jusqu’à 20 assertions par test API en cliquant sur New Assertion ou en sélectionnant directement l’aperçu de la réponse :
Si un test ne contient pas d’assertion sur le corps de la réponse, la charge utile du corps est abandonnée et le temps de réponse associé à la requête est renvoyé, dans la limite du délai d’expiration défini par le worker Synthetic.
Si un test contient une assertion sur le corps de la réponse et que le délai d’expiration est atteint, une erreur Assertions on the body/response cannot be run beyond this limit apparaît.
Sélectionnez les emplacements à partir desquels vous souhaitez exécuter votre test ICMP. Les tests ICMP peuvent être exécutés depuis des emplacements gérés et des emplacements privés, selon que vous souhaitez déclencher vos pings ICMP à l’extérieur ou au sein de votre réseau.
Datadog’s out-of-the-box managed locations allow you to test public-facing websites and endpoints from regions where your customers are located.
| Americas | APAC | EMEA |
|---|---|---|
| Canada Central (AWS) | Hong Kong (AWS) | Cape Town (AWS) |
| Northern California (AWS) | Mumbai (AWS) | Frankfurt (AWS) |
| Northern Virginia (AWS) | Seoul (AWS) | Ireland (AWS) |
| Ohio (AWS) | Singapore (AWS) | London (AWS) |
| Oregon (AWS) | Sydney (AWS) | Paris (AWS) |
| São Paulo (AWS) | Tokyo (AWS) | Stockholm (AWS) |
| Virginia (Azure) | Osaka (AWS) | Milan (AWS) |
| Jakarta (AWS) | Bahrain (AWS) |
The Datadog for Government site (US1-FED) uses the following managed location:
| Americas |
|---|
| US-West |
Les tests ICMP peuvent être exécutés :
Vous pouvez définir des conditions d’alerte afin de spécifier les circonstances dans lesquelles vous souhaitez qu’un test échoue et déclenche une alerte.
Lorsque vous définissez les conditions d’alerte sur An alert is triggered if your test fails for X minutes from any n of N locations, une alerte se déclenche uniquement si les deux conditions suivantes se vérifient :
Votre test peut déclencher X nouvelles tentatives après Y ms en cas d’échec. Cet intervalle peut être personnalisé en fonction de vos préférences en matière d’alertes.
La disponibilité d’un emplacement est calculée pour chaque évaluation (quels que soient les résultats du dernier test avant l’évaluation). La disponibilité totale est calculée selon les conditions d’alerte configurées. Les notifications envoyées se basent sur la disponibilité totale.
Votre test envoie une notification selon les conditions d’alerte définies au préalable. Cette section vous permet de définir les conditions et le message à envoyer à vos équipes.
Tout comme pour les monitors, sélectionnez les utilisateurs et/ou services qui doivent recevoir des notifications. Pour ce faire, ajoutez @notification au message, ou cherchez des membres d’équipe ou des intégrations connectées à l’aide de la liste déroulante.
Saisissez un message de notification pour le test. Ce champ accepte le format de mise en forme Markdown standard ainsi que les variables conditionnelles suivantes :
| Variable conditionnelle | Description |
|---|---|
{{#is_alert}} | S’affiche lorsque le test envoie une alerte. |
{{^is_alert}} | S’affiche lorsque le test n’envoie pas d’alerte. |
{{#is_recovery}} | S’affiche lorsque le test est rétabli depuis un état d’alerte. |
{{^is_recovery}} | S’affiche lorsque le test n’est pas rétabli depuis un état d’alerte. |
{{#is_renotify}} | S’affiche lorsque le monitor renvoie des notifications. |
{{^is_renotify}} | S’affiche lorsque le monitor ne renvoie pas de notification. |
{{#is_priority}} | S’affiche lorsque le monitor correspond à la priorité (P1 à P5). |
{{^is_priority}} | S’affiche lorsque le monitor ne correspond pas à la priorité (P1 à P5). |
Indiquez une fréquence de renvoi du message de notification en cas d’échec d’un test. Si vous ne souhaitez pas renvoyer de notification en cas d’échec, définissez l’option sur Never renotify if the monitor has not been resolved.
Cliquez sur Create pour enregistrer la configuration de votre test et votre monitor.
Pour en savoir plus, consultez la section Utiliser les monitors de test Synthetic.
Pour créer une variable locale, cliquez sur Create Local Variable en haut à droite de l’interface. Vous pouvez sélectionner l’un des builtins suivants :
{{ numeric(n) }}n chiffres.{{ alphabetic(n) }}n lettres.{{ alphanumeric(n) }}n caractères.{{ uuid }}{{ date(n unit, format) }}n unités.{{ timestamp(n, unit) }}n unités.Pour obfusquer les valeurs des variables locales dans les résultats des tests, sélectionnez Hide and obfuscate variable value. Une fois la chaîne de la variable définie, cliquez sur Add Variable.
Les variables globales définies sur la page Settings peuvent être utilisées dans l’URL et les assertions de vos tests ICMP.
Pour afficher votre liste de variables, tapez {{ dans le champ souhaité :
Un test est considéré comme FAILED s’il ne répond pas à une ou plusieurs de ses assertions ou si la requête a échoué prématurément. Dans certains cas, le test peut en effet échouer sans que les assertions n’aient pu être comparées à l’endpoint.
Voici la liste des erreurs concernées :
DNSPar défaut, seuls les utilisateurs disposant des rôles Admin ou Standard Datadog peuvent créer, modifier et supprimer des tests ICMP Synthetic. Pour que votre utilisateur puisse effectuer ces opérations, vous devez donc lui accorder l’un de ces deux rôles par défaut.
Si vous utilisez des rôles personnalisés, ajoutez votre utilisateur à un rôle personnalisé disposant des autorisations synthetics_read et synthetics_write.
Les clients qui ont configuré des rôles personnalisés sur leur compte peuvent utiliser la fonctionnalité de restriction d’accès.
Vous pouvez faire en sorte que certains rôles au sein de votre organisation ne puissent pas accéder à un test ICMP. Lors de la création du test ICMP, choisissez les rôles (en plus des utilisateurs) auxquels vous souhaitez attribuer des autorisations de lecture/écriture pour votre test.
Documentation, liens et articles supplémentaires utiles:
| |
