Diagnostics Command
Usage
cmd/diagnostics.go:45-60
Command Flags
| Flag | Default | Description |
|---|---|---|
--hastebin-url | https://ptero.co | Hastebin instance URL for uploading reports |
--log-lines | 200 | Number of log lines to include |
cmd/diagnostics.go:56-57
Interactive Prompts
Configuration Questions
When running diagnostics, you’ll be prompted:cmd/diagnostics.go:70-87
Collected Information
Version Information
- Wings version
- Docker version
- Kernel version
- Operating system
cmd/diagnostics.go:98-109
Wings Configuration
- Panel location (redacted by default)
- API host and port
- SSL configuration
- SFTP configuration
- Directory paths
- System username
- Current server time
- Debug mode status
cmd/diagnostics.go:111-134
Docker Information
- Server version
- Storage driver and status
- System status
- Logging driver
- Cgroup driver
- System warnings
cmd/diagnostics.go:136-159, 210-224
Running Containers
docker ps output showing all running containers
Source: cmd/diagnostics.go:161-166
Wings Logs
--log-lines)
Location: {LogDirectory}/wings.log
Source: cmd/diagnostics.go:169-181
Sensitive Data Redaction
Redaction Function
cmd/diagnostics.go:253-258
Auto-Redaction
If endpoints are excluded, the following are automatically redacted:- Panel location
- API host
- SSL certificate path
- SSL key path
- SFTP address
cmd/diagnostics.go:183-192
Report Output
Report Format
cmd/diagnostics.go:98-181, 260-263
Uploading Reports
Hastebin Upload
- POST report content to
{hastebin}/documents - Parse JSON response for document key
- Return shareable URL:
{hastebin}/{key}
cmd/diagnostics.go:226-251
Upload Confirmation
cmd/diagnostics.go:198-207
Example Usage
Basic Diagnostics
Custom Configuration
Review Before Upload
If you choose to review:Troubleshooting Use Cases
Docker Issues
The diagnostics report helps identify:- Docker version incompatibilities
- Storage driver problems
- Cgroup driver misconfigurations
- Container networking issues
Configuration Problems
Review:- Incorrect directory paths
- SSL certificate issues
- SFTP configuration errors
- Panel connection problems
Performance Issues
Examine:- Running container count
- System resource usage
- Docker warnings
- Recent error logs
Installation Failures
Check:- Docker image pull failures
- Network connectivity
- System permissions
- Available disk space
Security Considerations
Sensitive Information
Diagnostics may contain:- Server hostnames/IPs
- File paths
- Configuration values
- Recent log entries
- Error messages with details
Best Practices
-
Review Before Sharing
- Always review output before uploading
- Redact endpoints when possible
- Remove any sensitive log entries manually
-
Exclude Logs if Necessary
- Answer “No” to include logs prompt
- Manually review log content first
- Consider sharing partial logs
-
Use Private Paste Services
- Self-hosted hastebin instances
- Password-protected pastes
- Expiring links
-
Limit Distribution
- Only share with trusted support staff
- Delete reports after issue resolution
- Use private support channels
Output Headers
Header Format
- Versions
- Wings Configuration
- Docker: Info
- Docker: Running Containers
- Latest Wings Logs
cmd/diagnostics.go:260-263