Managing Components
How to register, update, and deregister status components using Chat.
While components are typically auto-discovered, you can also manage them directly through Chat. This page covers how to register new components, update existing ones, and remove components that are no longer needed.
Registering components
Add a new component to your status page when you want to track a service that has not yet been auto-discovered.
Using Chat
Chat can register components using the register_status_component
tool. Simply ask:
"Register a new status component called checkout-service"
The assistant will create the component with:
- Name: The identifier you specified
- Description: Optional description if you provide one
- First seen: The current timestamp
Via API
You can also register components programmatically through the Sazabi API. See the API reference for details.
Updating components
Modify existing components to keep your status page accurate.
Re-registration
When Chat encounters a component during an investigation, it automatically updates the lastSeenAt timestamp. This keeps track of which components are actively being used.
Updating description
Ask Chat to update a component's description:
"Update the description for checkout-service to 'Handles all payment processing and cart operations'"
Name matching
Component names must match exactly for updates. The assistant looks up components by their exact name, so "checkout-service" and "Checkout Service" are treated as different components.
Deregistering components
Remove components that are no longer part of your system.
Soft-delete
The deregister_status_component tool performs a soft-delete:
- Component is hidden from the active status page
- Historical data (issues, timeline) is preserved
- Component can be restored if needed
To deregister, ask the assistant:
"Deregister the legacy-payment-gateway component"
Preservation
Soft-deleted components:
- Do not appear on the public status page
- Retain all historical issue data
- Keep their timeline history intact
- Can be restored by re-registering with the same name
Deregistering is preferred over permanent deletion because it preserves historical data for audits and post-mortems.
Listing components
View all components in your project from the dashboard.
Dashboard view
Click Status in the sidebar to see:
- All active components
- Current status for each component
- Last seen timestamps