batch_create_monitors
Créer plusieurs monitors en un seul appel.
Créer plusieurs monitors en un seul appel.
Destructif · Écriture de données · Appelle des systèmes externes. Cet outil peut modifier ou supprimer des données. Vérifiez les arguments avant de laisser un agent l'appeler.
Paramètres
| Champ | Type | Requis | Description |
|---|---|---|---|
active | boolean | Non | État actif par défaut pour tous les monitors (par défaut : true). L'option active par monitor prend le dessus. |
confirmed | boolean | Non | Définir à true pour soumettre le lot. NE JAMAIS définir sans approbation explicite de l'utilisateur sur l'aperçu. |
monitors | string | Oui | Tableau JSON de spécifications de monitors. Chaque spec : {"test_id": <int>, "variants": ["API:Staging"], "name": "<str>", "active": <bool>, "overrides": {"VAR": "val"}, "scheduling": {...}, "options": {...}}. test_id est requis ; variants est optionnel (les valeurs par défaut du groupe sont utilisées en cas d'absence). |
options | string | Non | Options par défaut pour tous les monitors. Les options par monitor prennent le dessus. Exemple : {"timeout_sms":30,"ignore_errors":false,"auto_retry_failed_test":0} |
product | string | Oui | Slug du produit (format : operator~product). Tous les monitors du lot appartiennent à ce produit. |
scheduling | string | Non | Planification par défaut pour tous les monitors. La planification par monitor prend le dessus. Exemple : {"type":"simple/v2","definition":{"frequency":{"every":5,"unit":"minutes"}}} |
Exemple d'arguments
Arguments illustratifs qu'un agent fournit lors de l'appel de cet outil :
{
"product": "string",
"monitors": "string"
}Description
Tous les monitors doivent appartenir au même produit.
Réduit les allers-retours de ~30 (10 appels individuels create_monitor) à 2 (un aperçu + une confirmation).
Workflow en deux étapes (OBLIGATOIRE — l'aperçu ne peut pas être ignoré) :
1. batch_create_monitors product=<slug> monitors=<json_array> → renvoie l'APERÇU DU LOT
2. Montrez l'aperçu à l'utilisateur. Obtenez son approbation explicite.
3. batch_create_monitors product=<slug> monitors=<same_array> confirmed=true → SOUMETTRE TOUT
IMPORTANT : NE JAMAIS définir confirmed=true sans avoir montré l'aperçu à l'utilisateur au préalable.
Épinglez les variants par entrée via le tableau variants (même format que create_monitor).
Les globales émettent toujours {type:"global"}. Les variables dans des groupes non épinglés utilisent le variant par défaut de ce groupe. Les variables d'entrée locales au test (sans variable produit associée) conservent leur varDef.Value. Les monitors créés avec active=false sont défensivement basculés après création pour que le planificateur de la plateforme les arrête effectivement.
Paramètre monitors — tableau JSON de spécifications de monitors :
[
{"test_id": 100, "variants": ["API:Staging"]},
{"test_id": 101, "variants": ["API:Staging", "Database:Replica"], "name": "Custom", "overrides": {"SIM_A": "069..."}},
{"test_id": 102, "active": false, "scheduling": {"type":"simple/v2","definition":{"frequency":{"every":15,"unit":"minutes"}}}}
]
Champs de chaque spécification de monitor :
test_id (requis, int) — test à surveiller
variants (array of str) — épingler un variant par groupe. Formats : "5" (ID numérique) ou "API:Staging" (groupe:variant). Répétable. Omettre pour utiliser les valeurs par défaut du groupe.
name (string) — nom du monitor (par défaut : nom du test)
active (bool) — remplacer le active de niveau supérieur (par défaut : true)
overrides (object) — remplacements de valeurs de variables : {"VAR_NAME": "value"}
scheduling (object) — remplacer la planification de niveau supérieur
options (object) — remplacer les options de niveau supérieur
Valeurs par défaut en cascade : scheduling/options/active de niveau supérieur s'appliquent à tous les monitors sauf remplacement par monitor.
Maximum 20 monitors par lot. Le produit doit avoir le monitoring activé.
Échec partiel : si certains monitors échouent, les monitors réussis sont conservés (pas de rollback).Associé
Et ensuite ?
Last updated on