Documentation MoniTao

Introduction

Bienvenue dans la documentation de MoniTao ! MoniTao est une solution de monitoring simple et efficace qui vous permet de surveiller vos sites web, API, tâches planifiées et certificats SSL.

Cette documentation vous guidera à travers toutes les fonctionnalités de la plateforme, des premiers pas à la configuration avancée.

Premiers pas

1. Créer un compte

Pour commencer, créez un compte gratuit sur monitao.com/register. Aucune carte bancaire n'est requise pour l'offre gratuite.

2. Accéder au dashboard

Une fois connecté, vous accédez à votre tableau de bord où vous pouvez :

• Voir l'état de tous vos monitors en un coup d'œil
• Consulter les derniers incidents
• Accéder aux statistiques de disponibilité
• Gérer vos alertes

Créer un monitor HTTP/HTTPS

Étapes de création

Pour créer un nouveau monitor :

1. Cliquez sur "Monitors" dans le menu principal
2. Cliquez sur le bouton "Nouveau monitor"
3. Remplissez les informations requises
4. Configurez les options de vérification
5. Enregistrez

Champs obligatoires

• Nom : Un nom descriptif pour identifier votre monitor
• URL : L'adresse complète à surveiller (ex: https://monsite.com)
• Intervalle : Fréquence de vérification (5 min en Free, 1-2 min en Pro, 30s en Business)

Types de vérifications

Disponibilité (uptime)

Vérifie que votre site répond et retourne un code HTTP valide (200-299 par défaut).

Validation de contenu

Vérifie qu'un texte spécifique est présent sur la page. Utile pour :

• Vérifier qu'un paiement est bien affiché
• Contrôler qu'une version spécifique est déployée
• S'assurer qu'aucun message d'erreur n'apparaît

Exemple : Rechercher "Paiement réussi" ou "v2.3.1"

Vérification visuelle

Détectez les changements visuels inattendus sur vos pages critiques. Cette fonctionnalité permet de :

• Identifier les régressions CSS ou de mise en page
• Détecter les contenus manquants ou modifiés
• Surveiller les pages de paiement et formulaires
• Vérifier l'affichage sur différents breakpoints

Surveillance SSL

MoniTao surveille automatiquement vos certificats SSL et vous alerte :

• 30 jours avant expiration : Première alerte
• 7 jours avant expiration : Seconde alerte
• À expiration : Alerte critique

Configurer les alertes

Canaux d'alerte disponibles

Email (tous les plans)

Les alertes sont envoyées par email à l'adresse de votre compte. Vous recevez une notification :

• Quand un service tombe (DOWN)
• Quand un service se rétablit (UP)
• Avant expiration SSL/domaine

SMS (Business uniquement)

Recevez des alertes par SMS pour les incidents critiques. Inclus dans l'offre Business.

Conditions de déclenchement

MoniTao envoie une alerte dans les cas suivants :

• Erreur HTTP (codes 4xx et 5xx) - Codes 400, 401, 403, 404, 500, 502, 503, etc. Ces codes indiquent un problème sur votre service.
• Erreur de connexion - Timeout, DNS non résolu, connexion refusée, certificat SSL invalide.
• Changement de code HTTP - Par exemple, passage de 200 à 403 ou de 200 à 500 (si l'option est activée).
• Changement de contenu - Texte attendu non trouvé sur la page (si la validation de contenu est activée).
• Expiration SSL - Certificat expirant dans moins de 30, 7 ou 0 jours.

Qu'est-ce qu'un heartbeat ?

Les heartbeats permettent de surveiller l'exécution de vos tâches planifiées (crons, backups, scripts).

Principe de fonctionnement

Au lieu de vérifier une URL, MoniTao attend que votre script lui envoie un "ping" :

• Votre script démarre : Il envoie un ping "start"
• Votre script se termine avec succès : Il envoie un ping "success"
• Votre script échoue : Il envoie un ping "fail"
• Pas de ping reçu : MoniTao vous alerte

Configuration d'un heartbeat

1. Créer un heartbeat job

1. Allez dans "Heartbeat" → "Nouveau heartbeat"
2. Donnez un nom descriptif (ex: "Backup quotidien")
3. Définissez l'intervalle attendu (ex: "24 heures")
4. Définissez le timeout max (ex: "1 heure")
5. MoniTao génère une URL de ping unique

2. Intégrer dans votre script

Ajoutez les appels API dans votre script :

Bash

#!/bin/bash

# Signal le début
curl -X POST https://monitao.com/api/heartbeat/start/YOUR_TOKEN

# Votre script
./backup.sh

# Signal le succès
if [ $? -eq 0 ]; then
    curl -X POST https://monitao.com/api/heartbeat/success/YOUR_TOKEN
else
    curl -X POST https://monitao.com/api/heartbeat/fail/YOUR_TOKEN
fi

Python

import requests

# Signal le début
requests.post('https://monitao.com/api/heartbeat/start/YOUR_TOKEN')

try:
    # Votre code
    do_backup()

    # Signal le succès
    requests.post('https://monitao.com/api/heartbeat/success/YOUR_TOKEN')
except Exception as e:
    # Signal l'échec
    requests.post('https://monitao.com/api/heartbeat/fail/YOUR_TOKEN')

PHP

<?php

// # Signal le début
file_get_contents('https://monitao.com/api/heartbeat/start/YOUR_TOKEN');

try {
    // # Votre code
    doBackup();

    // # Signal le succès
    file_get_contents('https://monitao.com/api/heartbeat/success/YOUR_TOKEN');
} catch (Exception $e) {
    // # Signal l'échec
    file_get_contents('https://monitao.com/api/heartbeat/fail/YOUR_TOKEN');
}

API Heartbeat

Endpoints disponibles

POST /api/heartbeat/start/{token}

Signal le début d'exécution du job.

POST /api/heartbeat/ping/{token}

Signal que le job est toujours en cours (alias de success).

POST /api/heartbeat/success/{token}

Signal la fin réussie du job.

POST /api/heartbeat/fail/{token}

Signal l'échec du job avec message d'erreur optionnel.

FAQ

Quelle est la différence entre un monitor et un heartbeat ?

Monitor : MoniTao interroge votre service (pull). Idéal pour surveiller des sites web, API, endpoints publics.

Heartbeat : Votre script signale son exécution à MoniTao (push). Idéal pour surveiller des crons, backups, scripts internes.

Combien de temps avant d'être alerté en cas de panne ?

Cela dépend de votre plan et de l'intervalle configuré :

• Free : 5 minutes (1 vérification ratée)
• Pro : 1-2 minutes (1 vérification ratée)
• Business : 30 secondes à 1 minute (1 vérification ratée)

Puis-je surveiller des services internes (localhost, réseau privé) ?

Non, pour des raisons de sécurité (protection SSRF), MoniTao ne peut surveiller que des URLs publiques. Les adresses localhost, 192.168.x.x, 10.x.x.x, etc. sont bloquées.

Comment éviter les fausses alertes ?

MoniTao attend 1 échec avant d'envoyer une alerte. Vous pouvez également :

• Utiliser les "Silence Periods" pour ignorer les alertes pendant une maintenance
• Augmenter le timeout si votre service met du temps à répondre
• Vérifier que votre firewall n'autorise pas les IPs de MoniTao

Combien de temps MoniTao garde-t-il l'historique ?

• Free : 24 heures
• Pro : 30 jours
• Business : 90 jours

Puis-je changer de plan à tout moment ?

Oui ! Vous pouvez upgrader ou downgrader à tout moment. Le changement est effectif immédiatement.

Comment résilier mon abonnement ?

Depuis "Paramètres" → "Abonnement" → "Résilier". Vous gardez l'accès jusqu'à la fin de votre période payée.

Besoin d'aide ?

Si vous ne trouvez pas de réponse à votre question dans cette documentation, n'hésitez pas à nous contacter :

• Email : [email protected]
• Support client : Créer un ticket (connecté ou en tant qu'invité)
• Formulaire de contact : Contactez-nous

Nous répondons sous 24h ouvrées (Pro) ou en priorité (Business).