Skip to main content

Overview

IncidentFox provides 15 Docker tools for comprehensive container debugging, including logs, stats, exec, and inspection capabilities.

Tools Available

Configuration

Local Docker Socket

Remote Docker API

Example Queries

Check Container Status

Get Container Logs

Check Resource Usage

Execute Diagnostic Command

The docker_exec tool requires explicit enablement due to security implications. It’s disabled by default.

Use Cases

Container Health Investigation

When a container is unhealthy:
  1. Check container status with docker_ps
  2. Review logs with docker_logs
  3. Inspect configuration with docker_inspect
  4. Check resource usage with docker_stats

Network Debugging

For connectivity issues:
  1. List networks with docker_networks
  2. Inspect container network settings
  3. Use docker_exec to run network diagnostics

Resource Exhaustion

When containers are slow or crashing:
  1. Check docker_stats for CPU/memory usage
  2. Review docker_events for OOM kills
  3. Analyze docker_diff for unexpected file changes

Security Considerations

Principle of Least Privilege

Approval Workflow for Exec

Troubleshooting

Permission Denied

Solutions:
  1. Add the IncidentFox service user to the docker group
  2. Use TCP API with proper authentication
  3. Use sudo with proper configuration

Container Not Found

Ensure container names or IDs are correct. Use docker_ps to list available containers.

Next Steps

Kubernetes

For orchestrated containers

Log Analysis

Advanced log analysis tools