> ## Documentation Index
> Fetch the complete documentation index at: https://qovery-docs-agent-console-2026-09-29.mintlify.site/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>
