Tâches automatisées

Concept

L'automatisation permet de réduire votre intervention dans un processus en délégant une tâche ou un ensemble de tâches à une machine.

Sur notre plateforme Vivlab, certaines tâches peuvent être automatisées afin de simplifier vos processus de tests, de veille et d'intégration. Nos serveurs testent alors automatiquement et très régulièrement vos Pages Web et API pour vérifier leur disponibilité et validité.

Plus besoin de vous connecter, les résultats, alertes et notifications vous sont directement envoyés dans votre boîte e-mails.

Vue d'ensemble

L'accès aux paramètres d'automatisation se fait en cliquant sur l'icône settings de la barre de menu du groupe. Une fois activés, ils s'appliquent à l'ensemble du groupe.

Par défaut, le reporting quotidien et les alertes par e-mail sont inactifs.

Reporting quotidien des Pages Web

Une fois le reporting quotidien activé, notre plateforme teste automatiquement les temps de chargement des pages web du groupe 24h/7j, sans interruption. Vous recevez tous les matins par e-mail une synthèse des résultats sur 24h.

Cette synthèse présente d'abord les statistiques globales du groupe :

  • Nombre de pages web dans le groupe
  • Nombre total d'exécutions
  • Nombre total d'échecs
  • Taux de réussite de tout le groupe

Les résultats de chaque page sont ensuite détaillés :

  • Nombre d'exécutions
  • Nombre d'échecs
  • Moyenne du temps de chargement
  • Temps de chargement le plus long
  • Temps de chargement le plus court
  • Temps de chargement médian

Alertes

Une fois les alertes activées, notre plateforme teste automatiquement, et à intervalle régulier, la disponibilité des pages web ou requêtes API du groupe. Si une anomalie est détectée, la plateforme enclenche le processus suivant :

  1. Vous recevez instantanément un e-mail précisant la Page Web ou Requête API impactée et le type d'erreur rencontré.
  2. De nouveaux tests sont régulièrement executés afin de vérifier si la ressource est à nouveau valide et disponible.
  3. Vous êtes notifié par e-mail dès qu'un retour à la normale est détecté.
Gestion des codes erreur HTTP

Il arrive qu'un code erreur HTTP spécifique soit la réponse attendue à votre requête API et q'une alerte ne soit donc pas nécessaire lorsqu'il est détecté.

Si vous ne souhaitez pas en être notifié, il vous suffit de créer un test Status Code avec ce code erreur. Exemple : Status Code — Valeur Egale à — 400

Déclenchement par URL

Vous pouvez intégrer Vivlab dans vos outils de build, d'intégration et de deploiement continus. Le déclenchement par URL vous permet d'exécuter tout un groupe par un simple appel d'URL, un seul appel à la fois. Vous pouvez utiliser la méthode GET ou POST.

GET POST https://apis.vivlab.com/live/:triggerId

Exemple de réponse:

{
  "pass": true,
  "total": 2,
  "success": 2,
  "fail": 0,
  "duration": 240.98,
  "type": "requests",
  "group": "gp_eEwU16vZb7",
  "data": [
    {
      "request": "rq_fXDewQje22",
      "pass": true,
      "method": "POST",
      "duration": 228.86,
      "content_length": 1201,
      "resource": "/login/signin",
      "url": "https://apis.vivlab.com/login/signin",
      "status": 200,
      "tests": [
        {
          "source": "json",
          "property": "access",
          "comparison": "store",
          "assertion": true,
          "retrieved": "_token",
          "expected": "token_session"
        }
      ],
      "executed_at": "2019-07-15T13:48:29.257Z"
    },
    {
      "request": "rq_RybgM3cecT",
      "pass": true,
      "method": "GET",
      "duration": 12.12,
      "content_length": 416,
      "resource": "/requests/rq_RybgM3cecT",
      "url": "https://apis.vivlab.com/requests/rq_RybgM3cecT",
      "status": 200,
      "tests": [],
      "executed_at": "2019-07-15T13:48:29.618Z"
    }
  ]
}

Le déclenchement par URL ne nécessite pas d'authentification, pour simplifier l'intégration dans votre écosystème. Communiquez cette adresse prudemment.

Paramètres étendus

Vous pouvez personnaliser le fonctionnement du déclencheur en spécifiant des paramètres. L'exemple ci-dessous indique à notre plateforme, lors de l'exécution, de retourner un code erreur 400 en cas d'échec et de d'arrêter l'enchaînement des requêtes API et pages web.

GET POST https://apis.vivlab.com/live/:triggerId?code_error=400&on_fail=stop

Détails des paramètres:

Paramètre
Par défaut
Détails
code_error
200
Défini le code HTTP à retourner lors d'une erreur d'exécution. La valeur doit-être comprise entre 100 et 599.
on_fail
continue
En spéficiant la valeur à stop, l'enchaînement des requêtes et pages web s'arrête à la première erreur recontrée.