Workers (points de collecte)

Visualisez d'où partent vos vérifications et retirez un point de collecte que vous n'utilisez plus.

À quoi ça sert

Un worker est un point de collecte : c'est lui qui exécute concrètement vos vérifications et remonte leurs résultats. SecuMon répartit les exécutions entre les workers disponibles. Vous pouvez consulter la liste de vos workers pour savoir d'où partent les vérifications (emplacement, disponibilité), et retirer un worker que vous n'utilisez plus.

Le modèle d'un worker

Champ	Type	Description
`id`	string (uuid)	Identifiant unique.
`name`	string	Nom du worker.
`location`	string	Emplacement / région du point de collecte.
`status`	string	`active` ou `inactive`.
`checks_executed`	entier	Nombre de vérifications exécutées (indicatif).
`avg_latency_ms`	entier	Latence moyenne (si disponible).
`last_heartbeat`	date	Dernier signal de vie du worker.

Utilisation via le portail

La section Workers liste vos points de collecte avec leur emplacement, leur statut et leur dernier signal de vie. Vous pouvez retirer un worker depuis cette vue.

Lister : tous les rôles. Retirer : owner et admin.

Utilisation via l'API

Lister les workers

GET /api/v2/workers

curl -s https://api.secumon.secuaas.ovh/api/v2/workers \
  -H "Authorization: Bearer $SECUMON_TOKEN"

[
  {
    "id": "9a8b7c6d-1234-4abc-9def-aabbccddeeff",
    "name": "collecteur-bhs-1",
    "location": "OVH BHS",
    "status": "active",
    "checks_executed": 0,
    "last_heartbeat": "2026-06-23T12:00:30Z"
  }
]

La réponse est toujours un tableau JSON.

Retirer un worker

DELETE /api/v2/workers/:id

curl -s -X DELETE https://api.secumon.secuaas.ovh/api/v2/workers/9a8b7c6d-1234-4abc-9def-aabbccddeeff \
  -H "Authorization: Bearer $SECUMON_TOKEN"

Réponse : 204 No Content. Un identifiant inconnu renvoie 404.

Cas d'usage

Vérifier l'origine des mesures : confirmer depuis quel emplacement vos vérifications sont exécutées (utile pour des cibles sensibles à la géolocalisation).
Diagnostiquer un point de collecte muet : un last_heartbeat ancien ou un status: inactive indique un worker qui ne remonte plus de résultats.
Faire le ménage : retirer un worker mis hors service pour ne garder que les points de collecte réellement actifs.

Astuces

Avant de retirer un worker, vérifiez qu'aucune vérification critique n'en dépend exclusivement, afin d'éviter une interruption de collecte.
Le last_heartbeat est le meilleur indicateur de santé d'un worker : comparez-le à l'heure courante pour repérer un point de collecte silencieux.

Workers (points de collecte)

On this page