HubNext
Help
Help Agents

Agents: the Raccoon, a tester

The Tester (it is called the Raccoon) runs a request collection from the Development section (HTTP and SQL) by itself and tells you when the tests fail. You do not have to remember the checks: the Raccoon runs them on a schedule and every time a task moves to the status you chose.

What you need first

The Agents section and the Development mode must be turned on for the organization (the system administrator does it). In Development you need a collection of requests and a site (not prod). More in the article Development: sites and request testing.

Create a Raccoon

  1. Agents → Create agent, type Raccoon — tester, enter a Name.
  2. Open the agent card and in the Settings block choose a Collection and a Site.
  3. Turn on the runs you need (below) and click Save.
  4. Click Enable at the top of the card. A new agent is created disabled.

The Run now button executes the collection at once on your behalf and shows the result step by step: handy for checking the settings. Such a run sends no notifications and does not affect the schedule.

Run on a schedule

Tick Run on a schedule and choose How often (from 5 minutes to once a day). The Raccoon checks whether it is time every 5 minutes.

A message is sent only when the result changes: the tests started failing or pass again. If they keep failing for several runs in a row there are no repeated messages. The recipients are the agent creator and the Agent administrators, by email, Telegram and in the app. If you like, set a Report task: the same text is added there as a comment.

Run when a task changes status

Tick statuses, for example Resolved. When a task moves to such a status the Raccoon runs the collection with the code of that task (the {{task_code}} variable in requests) and writes the result into that task as a comment: the outcome, the site and the list of steps without response bodies. If you only want to run without a comment, untick Write the result as a task comment.

  • You can limit runs to projects (Only projects). If nothing is ticked, tasks of all projects match.
  • The same task is not run again within 10 minutes, and at most 3 tasks are taken at a time (the rest on the next check).
  • When you first turn on running by status, the Raccoon starts from the current moment: it does not process past status changes.

What the card shows

The Latest runs of the agent block shows the time, collection, site, task, outcome and the number of steps passed. A manager and above sees a link to the Request log for the run. Every step is recorded in the request log on behalf of the agent.

If the collection or the site is deleted, or the site becomes prod, the agent shows an error on the card and runs nothing until you fix the settings.

See also