Intégration Speedtest.net pour Gladys Assistant
Mesurez périodiquement le débit de votre connexion via les serveurs Speedtest.net.
Publiée par guim31
- Appareils
- Version 1.0.2
- Nécessite Gladys >=4.86.0
- ★ 0
Mesurez périodiquement votre connexion internet, directement depuis Gladys, via le réseau mondial de serveurs Speedtest.net. Chaque test alimente quatre capteurs à afficher en graphique sur le tableau de bord et à exploiter dans les scènes :
| Capteur | Unité | Ce qu'il indique |
|---|---|---|
| Download | Mbit/s | La vitesse à laquelle les données arrivent chez vous |
| Upload | Mbit/s | La vitesse à laquelle les données partent de chez vous |
| Ping | ms | Le temps de réaction de la connexion (plus bas = mieux) |
| Jitter | ms | La stabilité de ce temps de réaction (plus bas = mieux) |
Usages typiques : vérifier ce que votre FAI délivre réellement, être averti par une scène quand le débit descend sous ce que vous payez, ou détecter qu'un lien de secours (bascule 4G…) a pris le relais.
Déroulement d'un test
L'intégration parle directement à l'infrastructure Speedtest.net — pas de compte, pas de clé d'API, aucun logiciel Ookla installé. Par défaut, elle sonde les serveurs les plus proches, garde le plus sain, puis mesure latence, débit descendant et débit montant (environ 25 secondes au total). Vous pouvez aussi imposer un serveur : le bouton Lister les serveurs proches donne les ID, à coller dans le champ ID du serveur.
À savoir
- Un test sature la connexion pendant qu'il tourne. Les résultats sont aussi légèrement conservateurs sur les lignes très rapides, la mesure partageant le CPU avec les limites que Gladys impose aux intégrations.
- Un test transfère de vraies données — plusieurs centaines de Mo par passage sur une ligne rapide. Si votre forfait est plafonné, espacez les tests automatiques ou désactivez-les pour ne garder que le bouton manuel.
- Les tests planifiés suivent le réglage Intervalle entre les tests (par défaut : un test par heure). Le bouton Lancer un test de débit fonctionne à tout moment.
Dépannage
- Résultats plus bas que l'application officielle : augmentez Connexions parallèles (les lignes rapides se remplissent mieux à 6–8) ou la Durée de mesure.
- Test en échec : le serveur le plus proche est peut-être en panne — imposez un autre ID de serveur, ou videz le champ pour laisser la sélection automatique écarter les serveurs défaillants.
Cette intégration est un projet communautaire indépendant, sans affiliation ni approbation d'Ookla. Speedtest® est une marque d'Ookla, LLC.
Paramètres de configuration
Voici les paramètres demandés par Speedtest.net dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Un test sature la connexion pendant environ 25 secondes et peut transférer plusieurs centaines de Mo : tenez compte de votre quota de données en choisissant l'intervalle. Les résultats alimentent quatre capteurs (débits, ping, gigue) exploitables en graphiques et dans les scènes. |
| Lancer les tests automatiquement | boolean | Non | Désactivé, les tests ne partent que via le bouton manuel ci-dessous. |
| Intervalle entre les tests (s) | number | Non | Secondes entre deux tests automatiques. 3600 = un test par heure. |
| ID du serveur (optionnel) | string | Non | Laissez vide pour choisir automatiquement le meilleur serveur proche. Le bouton « Lister les serveurs proches » donne les ID. |
| Connexions parallèles | number | Non | Connexions TCP par sens de mesure. Plus il y en a, mieux les liens rapides sont remplis. |
| Durée de mesure par sens (s) | number | Non | Une mesure plus longue est plus stable mais transfère plus de données. |
Comment installer Speedtest.net dans Gladys
- Dans Gladys, ouvrez Intégrations : Speedtest.net apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-speedtest:1.0.2), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-speedtest.
Speedtest.net nécessite Gladys >=4.86.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Speedtest.net est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation