Services Management¶
Quick Reference¶
- Create Service: Dashboard → "Add Service" button → Select type (HTTP/PING) → Configure → Save
- Edit Service: Click pencil icon on service card or "Edit Service" in details view
- Delete Service: Click trash icon → Confirm deletion (permanent action)
- Service Types: HTTP (websites/APIs), PING (network/servers)
- Organization: Group by projects, assign colors, manage from dashboard
Overview¶
This guide covers comprehensive service management operations including creating, editing, deleting, and organizing monitoring services within UptimeHunt.
Service Types¶
UptimeHunt supports multiple monitoring service types:
HTTP Monitoring¶
Monitor web endpoints, APIs, and web applications.
Use Cases: Website availability, API health checks, endpoint response tracking
Capabilities: Multiple HTTP methods, authentication, custom headers, POST data, response validation
PING Monitoring¶
Monitor network connectivity via ICMP ping.
Use Cases: Server availability, network connectivity, latency monitoring, infrastructure health
Capabilities: IPv4/IPv6 support, domain resolution, round-trip time, packet loss detection
Monitoring Type Comparison¶
| Feature | HTTP Monitoring | PING Monitoring |
|---|---|---|
| Primary Use | Websites, APIs, web applications | Servers, network devices |
| Protocol | HTTP/HTTPS | ICMP |
| Authentication | Yes (Basic, Bearer Token) | No |
| Custom Headers | Yes | N/A |
| Response Validation | Status codes, content | Reply received |
| Metrics Tracked | Response time, status code, content | Round-trip time, packet loss |
| IPv6 Support | Yes | Yes |
Creating Services¶
Service Creation Workflow¶
- Navigate to Services dashboard
- Click "Add Service" button
- Select monitoring type (HTTP or PING)
- Configure service parameters
- Save configuration
Common Configuration¶
All service types share these configuration options:
- Service Name (Required)
- Descriptive identifier for the service
- Displayed in dashboard and reports
- Maximum 128 characters
- Project (Optional)
- Project assignment for organization
- Select from existing projects or leave unassigned
- Enabled (Toggle)
- Controls whether monitoring is active
- Enabled: Service is actively monitored
- Disabled: Service configured but not monitored
- Check Interval (Required)
- Frequency of monitoring checks in minutes
- Minimum: 1 minute
- Default: 3 minutes
- Maximum: 60 minutes
Type-Specific Configuration¶
Each service type requires additional configuration:
HTTP Services
- URL endpoint
- HTTP method
- Authentication credentials
- Custom headers
- POST data
PING Services
- IP address or domain name
Refer to type-specific guides for detailed configuration instructions.
Editing Services¶
Edit Service Configuration¶
To modify an existing service:
Method 1: Quick Edit¶
- Locate service in dashboard
- Click the Edit icon (pencil)
- Modify configuration in modal
- Click "Save Changes"
Method 2: Detail Page Edit¶
- Click service name to open details
- Click "Edit Service" button
- Modify configuration in modal
- Click "Save Changes"
Editable Parameters¶
All service parameters can be modified:
- Service name
- Project assignment
- Enabled status
- Check interval
- Type-specific settings (URL, IP, authentication, etc.)
Configuration Updates
Changes take effect immediately for the next scheduled check. In-progress checks use previous configuration.
Deleting Services¶
Delete Process¶
To remove a service:
- Locate service in dashboard
- Click the Delete icon (trash)
- Confirm deletion in dialog
- Service is permanently removed
Deletion Consequences¶
Service deletion is permanent and includes:
- Service configuration removal
- Historical check data deletion
- Performance metrics removal
- Alert configurations (when implemented)
Permanent Action
Service deletion cannot be undone. Ensure you have backed up any necessary data before deletion.
Batch Deletion¶
Batch deletion is not currently supported. Services must be deleted individually.
Service Status¶
Status Indicators¶
Services display current status:
- Up (Operational)
- Service responding successfully
- Indicator: Green check mark
- Last successful check displayed
- Down (Failing)
- Service not responding or returning errors
- Indicator: Red X mark
- Error information available in details
- Pending
- First check not yet completed
- Indicator: Gray clock
- Wait for first check interval
Status Determination¶
HTTP Services
Status determined by:
- HTTP response received
- Status code 2xx or 3xx (configurable)
- Response time within timeout
- No connection errors
PING Services
Status determined by:
- ICMP echo reply received
- Packet loss below threshold
- Response time within acceptable range
Service Organization¶
Grouping by Project¶
Services are organized by project on the dashboard:
- Assigned Services
- Appear under their project section
- Inherit project color coding
- Grouped with related services
- Unassigned Services
- Appear in "Unassigned" section
- No project association
- Can be assigned to project later
Reordering Services¶
Service order within projects is currently not customizable. Services appear in creation order or alphabetically (implementation-dependent).
Service List Views¶
Dashboard View¶
The main services view displays:
- Project-grouped sections
- Service name and type
- Current status indicator
- Quick action buttons
- Collapse/expand controls per project
Service Details View¶
Individual service pages show:
- Complete configuration
- Check history table
- Performance metrics
- Probe location data
- Edit and management options
Bulk Operations¶
Currently Unavailable¶
The following bulk operations are not yet implemented:
- Bulk editing
- Bulk deletion
- Bulk enable/disable
- Bulk project assignment
- Batch export
Workarounds¶
For managing multiple services:
- Use projects for logical grouping
- Apply consistent naming conventions
- Document service purposes
- Use API for programmatic management
Service Limits¶
Account Limits¶
Service limits may apply based on account type:
Current Implementation
- No enforced limits (subject to reasonable use)
- Performance may degrade with excessive services
- Future plans may include tiered limits
Recommended Limits
For optimal performance:
- Standard accounts: Up to 100 services
- Consider performance impact of check intervals
- Balance between coverage and resource usage
Service Templates¶
Service templates are not currently implemented. Future versions may include:
- Predefined service configurations
- Template creation from existing services
- Template sharing capabilities
- Quick service deployment from templates
Import/Export¶
Current Functionality¶
Import and export features are not yet available.
Planned Features¶
Future releases may support:
- Service configuration export (JSON/YAML)
- Bulk service import
- Configuration backup
- Migration between accounts
Troubleshooting¶
Service Not Creating¶
If service creation fails:
- Verify all required fields are completed
- Check for validation errors in form
- Ensure service name is unique
- Verify URL/IP format is correct
- Review authentication credentials
Service Not Updating¶
If edits don't save:
- Check for form validation errors
- Verify you have edit permissions
- Refresh page and try again
- Check browser console for errors
Services Not Displaying¶
If services don't appear in dashboard:
- Verify you're logged into correct account
- Check that services weren't deleted
- Refresh the browser page
- Clear browser cache
- Try different browser
Status Not Updating¶
If service status seems stuck:
- Wait for next check interval
- Verify service is enabled
- Check service details for recent checks
- Ensure probers are operational
- Review check history for patterns
Best Practices¶
Naming Conventions¶
Use clear, descriptive names:
Good Examples:
- Production API - User Authentication
- Staging Website - Homepage
- Database Server - Primary (192.168.1.10)
Poor Examples:
- Service 1
- Test
- API
Configuration Management¶
Maintain consistent configurations:
- Document authentication credentials securely
- Use environment-specific projects
- Set appropriate check intervals
- Enable only necessary services
Monitoring Strategy¶
Develop effective monitoring:
- Monitor critical paths and dependencies
- Set realistic check intervals
- Balance coverage vs. resource usage
- Use appropriate monitoring types
Organization¶
Maintain clean service organization:
- Assign services to projects
- Use consistent color coding
- Remove unused services
- Document service purposes