Funkční kontroly
Konfigurace toho, co a jak care na webu pravidelně testuje (odeslání formuláře, doručení e-mailu).
Funkční kontrola je pravidelný (typicky denní) test primární funkce webu. Kontrolu zakládá operátor care v adminu; agent ji pak spouští podle configu. Tuhle stránku potřebuješ hlavně proto, abys věděl, jaké hodnoty po úpravě formuláře vrátit.
Druhy kontrol
kind je jeden z:
form: ověří, že formulář odešle a vrátí úspěch.email_roundtrip: navíc ověří, že dorazí e-mail.
Konfigurace
Config kontroly (config) má tento tvar:
{
"url": "https://web.cz/kontakt",
"method": "POST",
"contentType": "form",
"fields": {
"name": "codebros care test",
"email": "probe@check.care.codebros.cz",
"message": "automatická kontrola"
},
"testMarker": { "field": "care_test", "value": "TAJNY_TOKEN" },
"success": { "status": 200, "containsText": "Děkujeme" },
"email": {
"verify": false,
"tokenIn": "field",
"field": "email",
"probeAddress": "probe@check.care.codebros.cz"
}
}Pole
| Pole | Typ | Výchozí | Význam |
|---|---|---|---|
url | string (URL) | povinné | Kam se submit posílá. |
method | POST | GET | POST | HTTP metoda. |
contentType | form | json | form | form = urlencoded. |
fields | objekt string:string | {} | Pole formuláře. |
testMarker | { field, value } | null | null | Skryté testovací pole. Agent ho vždy přidá do fields před odesláním. Typicky { "field": "care_test", "value": "<token>" }. |
success.status | číslo 100..599 | volitelné | Očekávaný HTTP kód. Přesměrování 3xx na děkovací stránku se bere jako úspěch. |
success.containsText | string | volitelné | Text, který musí být v odpovědi (děkovací hláška). |
email.verify | bool | false | Zapíná roundtrip. |
email.tokenIn | field | plusAddress | field | Kam agent vloží unikátní token. |
email.field | string | volitelné | Pole s e-mailem odesílatele. |
email.probeAddress | string | volitelné | Probe adresa, typicky probe@check.care.codebros.cz. |
Když je nastaven jen success.status nebo jen success.containsText, stačí splnit ten jeden.
Jak to běží
Agent dostane config, vždy přidá testMarker do fields, odešle http_post na url a vyhodnotí success. U email.verify navíc vygeneruje unikátní token, vloží ho podle tokenIn a po odeslání počká na doručení. Detail viz pipeline agentů a nástroje agentů.
Když kontrola selže, care otevře incident (v portálu se u webu ukáže, že formulář nefunguje) a upozorní tým.