> ## Documentation Index
> Fetch the complete documentation index at: https://www.qovery.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Debug and resolve infrastructure issues with Qovery AI Copilot

## Overview

Qovery AI Copilot can investigate issues, analyze logs, and provide remediation steps to resolve problems in your infrastructure.

## Capability Support Matrix

| Capability                      | Example Prompt                              | Support Level      | Last Validated |
| ------------------------------- | ------------------------------------------- | ------------------ | -------------- |
| **Deployment Issues**           |                                             |                    |                |
| Investigate failed deployments  | "Why is my deployment failing?"             | ✅ Full Support     | 2025-01-15     |
| Analyze deployment logs         | "Show deployment logs for my-api"           | ✅ Full Support     | 2025-01-15     |
| Fix deployment problems         | "Fix the deployment configuration"          | 🚧 Partial Support | 2025-01-15     |
| **Application Errors**          |                                             |                    |                |
| Investigate runtime errors      | "Why is my app returning 500 errors?"       | ✅ Full Support     | 2025-01-15     |
| Analyze application logs        | "Show error logs from the last hour"        | ✅ Full Support     | 2025-01-15     |
| Identify root causes            | "What's causing these errors?"              | 🚧 Partial Support | 2025-01-15     |
| **Connectivity Issues**         |                                             |                    |                |
| Debug network problems          | "Why can't my app connect to the database?" | ✅ Full Support     | 2025-01-15     |
| Check service status            | "Is the database running?"                  | ✅ Full Support     | 2025-01-15     |
| **Resource Issues**             |                                             |                    |                |
| Investigate resource problems   | "Why is my service out of memory?"          | ✅ Full Support     | 2025-01-15     |
| Analyze resource metrics        | "Show memory usage over time"               | ✅ Full Support     | 2025-01-15     |
| **Health Check Failures**       |                                             |                    |                |
| Investigate health check issues | "Why is the health check failing?"          | ✅ Full Support     | 2025-01-15     |
| Analyze service health          | "Check service health status"               | ✅ Full Support     | 2025-01-15     |

**Support Levels:**

* ✅ **Full Support**: Feature is fully functional and tested
* 🚧 **Partial Support**: Feature works with limitations
* ⏳ **Coming Soon**: Feature is planned but not yet available

## Deployment Issues

### Investigate Failed Deployments

```
"Why is my deployment failing?"
"Debug the API deployment failure"
"Investigate staging deployment errors"
```

### Analyze Deployment Logs

```
"Show deployment logs for my-api"
"What errors occurred during the last deployment?"
"Analyze failed build logs"
```

### Fix Deployment Problems

```
"Fix the deployment configuration"
"Resolve the image pull error"
"Debug the container startup issue"
```

## Application Errors

### Investigate Runtime Errors

```
"Why is my app returning 500 errors?"
"Debug the connection timeout"
"Investigate application crashes"
```

### Analyze Application Logs

```
"Show error logs from the last hour"
"Find errors in production logs"
"Analyze exception patterns"
```

### Identify Root Causes

```
"What's causing these errors?"
"Find the root cause of the outage"
"Diagnose the performance degradation"
```

## Connectivity Issues

### Debug Network Problems

```
"Why can't my app connect to the database?"
"Debug the service-to-service connection"
"Investigate API endpoint timeout"
```

### Check Service Status

```
"Is the database running?"
"Check if all services are healthy"
"Verify network connectivity"
```

## Resource Issues

### Investigate Resource Problems

```
"Why is my service out of memory?"
"Debug high CPU usage"
"Investigate disk space issues"
```

### Analyze Resource Metrics

```
"Show memory usage over time"
"Analyze CPU spikes"
"Check resource limits"
```

## Configuration Issues

### Debug Configuration Problems

```
"Why isn't my environment variable working?"
"Debug the configuration mismatch"
"Verify database connection settings"
```

### Validate Configurations

```
"Check my application configuration"
"Verify environment setup"
"Validate security group rules"
```

## Health Check Failures

### Investigate Health Check Issues

```
"Why is the health check failing?"
"Debug readiness probe timeout"
"Investigate liveness probe failure"
```

### Analyze Service Health

```
"Check service health status"
"Show health check logs"
"Verify endpoints are accessible"
```

## Performance Problems

### Debug Performance Issues

```
"Why is my API slow?"
"Investigate high latency"
"Debug slow database queries"
```

### Analyze Performance Metrics

```
"Show response time trends"
"Analyze request patterns"
"Identify performance bottlenecks"
```

## Database Issues

### Debug Database Problems

```
"Why can't I connect to the database?"
"Debug database connection pool exhaustion"
"Investigate database timeout errors"
```

### Analyze Database Status

```
"Check database health"
"Show database connection count"
"Verify database is accessible"
```

## Build Failures

### Investigate Build Issues

```
"Why is my build failing?"
"Debug Docker build errors"
"Investigate dependency resolution failures"
```

### Analyze Build Logs

```
"Show build error logs"
"Find the failing build step"
"Analyze Docker layer cache misses"
```

## Guided Troubleshooting

### Step-by-Step Investigation

```
"Help me troubleshoot the production outage"
"Guide me through debugging this issue"
"Walk me through fixing this problem"
```

### Automated Diagnostics

```
"Run a full diagnostic check"
"Investigate all potential issues"
"Perform a health check across all services"
```

## Remediation

### Suggested Fixes

```
"How do I fix this error?"
"Suggest remediation steps"
"What should I do to resolve this?"
```

### Automated Resolution

```
"Try to fix the deployment failure"
"Automatically restart failed services"
"Apply the recommended fix"
```

## Related Capabilities

<CardGroup cols={2}>
  <Card title="Infrastructure Management" href="/copilot/capabilities/infrastructure-management">
    Manage and monitor infrastructure
  </Card>

  <Card title="Deployment Automation" href="/copilot/capabilities/deployment-automation">
    Automate deployments and recovery
  </Card>

  <Card title="Optimization" href="/copilot/capabilities/optimization">
    Optimize to prevent issues
  </Card>

  <Card title="Common Tasks" href="/copilot/examples/common-tasks">
    See troubleshooting examples
  </Card>
</CardGroup>
