The Maintenance tracker agent analyzes your task history to identify properties with recurring repair issues. This helps you find problems that require a permanent solution rather than another temporary repair.
The agent is a read-only tool. It surfaces patterns in your task history and reports them, but doesn't create, edit, or delete any of your maintenance tasks.
Note:
Unlike the Stale Task Detector, which only looks at open tasks, the Maintenance tracker includes completed tasks as well, because a closed repair might still represent an instance of an issue.
Limitations
Keep the following in mind when using the agent:
- The analysis window is 60 days by default, but is configurable per run.
- All maintenance tasks in the window are included regardless of status, except for cancelled tasks.
- Unrelated one-off repairs don't qualify — the agent looks for a repeating fault, not simply a busy property.
Understand the Maintenance tracker agent
The Maintenance tracker agent runs automatically once a week on Mondays at 08:00. The agent can also be triggered manually.
During each run, the agent does the following:
- Scans your task history across all your properties within the configured window (60 days by default).
- Groups the tasks by property and classifies each task into one of five repair types based on the task title: AC/HVAC, plumbing, locks/access, Wi-Fi, and appliances. Routine work (such as inspections, turnovers, walkthroughs, and pre-arrival or preventive tasks) and tasks that don't match any repair type never count toward a chronic property.
- Identifies "chronic" properties: properties with three or more repair tasks in the window, where at least two of those tasks are the same repair type. Both conditions must be met.
- Generates a ranked report that lists the properties with the most recurring issues first.
Run the Maintenance tracker agent manually
In addition to the scheduled run, you can trigger the agent manually at any time from the Agents hub.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select
Agents hub. - At the top, select the Operations tab.
- Click the Maintenance tracker tile.
- Under "When it runs", click Run now.
Review the results and status of the run in the activity feed.
Review the activity feed
Follow the steps below to review your activity feed.
Step by step:
- Sign in to your Guesty account.
- In the side navigation menu, select Agents hub.
- In the left submenu, select Agent activity.
- Click the relevant row with the agent's name to review the report details in the right-side panel.
Understand the report status and details
Each run finishes with one of the following statuses:
- "Done": The run completed successfully and no chronic properties were found. Properties may still have had repair tasks in the window, but none met the criteria for a recurring issue.
- "Action needed": At least one chronic property was found. The message shows how many.
If the scan stops early, the report opens with "This list is incomplete", and the run's summary message says so too. An incomplete scan is never presented as an all-clear.
The report begins with the total number of properties that had maintenance tasks during the window, followed by two sections:
- "Chronic properties": Properties that meet the chronic criteria. Up to 20 properties are listed.
- "Other properties with repair tasks": Properties that had repair tasks in the window but didn't meet the criteria. Up to 10 properties are listed.
If a section has more properties than it can list, it ends with an "and N more" line. Properties that had only routine or unclassified tasks are summarized in a single line. Tasks not attached to any property are grouped under "Unlisted tasks".
Each property appears as a single bullet showing the property name, the number of repair tasks in the window, a breakdown by repair type, and how recent the latest task was. If the property also had routine work, the count shows both (for example, "3 repair tasks out of 5 maintenance tasks"). Each chronic property ends with its latest task in its most frequent repair type, with a link to the task. Open tasks are shown before completed ones.
Within each section, properties are ordered by repair task count (highest first), then by how recent the latest task was.
Review and act on flagged items
Use the report to identify which properties need more attention. For example, a plumbing issue fixed three times in a month may point to a larger underlying problem. Click the linked task on a chronic property to go straight to its latest repair.
The agent surfaces the pattern but doesn't suggest specific actions. After reviewing the report, you may decide to schedule a more thorough inspection or create a new task for a comprehensive repair.