Maintenance Mode

Maintenance Mode allows you to temporarily exclude managed agents from health monitoring and alerting when performing planned maintenance activities. This feature helps prevent false alerts during scheduled maintenance windows while ensuring monitoring is automatically restored after the maintenance period. You maintain full control to disable maintenance mode at any time. The Kargo applications continue to work and promote normally.

Enabling Maintenance Mode

To enable maintenance mode for a managed agent:

1. Navigate to your Kargo instance → Agents tab.

2. Find the agent you want to put into maintenance mode.

3. Under the Actions column, click on the three-dot button.

4. Locate the Enable Maintenance Mode section.

   

5. Enter the expiration day and time for maintenance mode. This is the date and time when maintenance mode will automatically expire and monitoring will be restored.

6. Click Save to apply the changes.

   

Once enabled, the agent will be excluded from health monitoring and alerting. The 🔧 icon indicates that the agent is in maintenance mode.

Disabling Maintenance Mode

Maintenance mode can be disabled in the following ways:

Automatic Expiration

Maintenance mode will be automatically disabled after the expiration time that you set to ensure monitoring is restored. If maintenance activities require more time, you will need to manually re-enable maintenance mode.

Manual Disabling

To manually disable maintenance mode before the expiration time:

1. Navigate to the agent actions as described above.

2. Locate the Disable Maintenance Mode section.

3. Click Disable to apply the changes.