{
  "schema_version": 2,
  "id": "develop/tools/insight/debugging",
  "title": "Redis Insight debugging information",
  "url": "https://redis.io/docs/latest/develop/tools/insight/debugging/",
  "summary": "Redis Insight debugging information",
  "aliases": [
    "/develop/connect/insight/debugging"
  ],
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2025-09-03T08:26:45-07:00",
  "page_type": "content",
  "content_hash": "2e27c2ae5227813d8778c55e93f8abdc5f69dab3cd3bf901ce278db723e553af",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "If you are experiencing errors or other issues when using Redis Insight, follow the steps below to learn more about the errors and to identify root cause."
    },
    {
      "id": "connection-issues",
      "title": "Connection issues",
      "role": "content",
      "text": "If you experience connection issues, try these steps."
    },
    {
      "id": "1-launch-redis-insight-in-debug-mode",
      "title": "1. Launch Redis Insight in debug mode",
      "role": "content",
      "text": "Run the following command to launch Redis Insight in debug mode to investigate connection issues:\n\n* **Windows**:\n\n    `cmd /C \"set DEBUG=ioredis* && \".\\Redis Insight.exe\"\"`\n\n* **macOS** (from the Applications folder):\n\n    `DEBUG=ioredis* open \"Redis Insight.app\"`\n\n* **Linux**:\n\n    `DEBUG=ioredis* \"redis insight\"`"
    },
    {
      "id": "2-investigate-logs",
      "title": "2. Investigate logs",
      "role": "content",
      "text": "You can review the Redis Insight log files (files with a `.log` extension) to get detailed information about system issues.\nThese are the locations on supported platforms:\n\n- **Docker**: In the `/data/logs` directory *inside the container*.\n- **macOS**: In the `/Users/<your-username>/.redis-insight` directory.\n- **Windows**: In the `C:\\Users\\<your-username>\\.redis-insight` directory.\n- **Linux**: In the `/home/<your-username>/.redis-insight` directory."
    },
    {
      "id": "other-issues",
      "title": "Other issues",
      "role": "content",
      "text": ""
    },
    {
      "id": "to-debug-issues-other-than-connectivity",
      "title": "To debug issues other than connectivity",
      "role": "content",
      "text": "* **Windows**:\n\n    `cmd /C \"set DEBUG=* && \".\\Redis Insight.exe\"\"`\n\n* **macOS** (from the Applications folder):\n\n    `DEBUG=* open \"Redis Insight.app\"`\n\n* **Linux**:\n\n    `DEBUG=* \"redis insight\"`"
    },
    {
      "id": "get-detailed-redis-insight-logs",
      "title": "Get detailed Redis Insight logs",
      "role": "content",
      "text": "* **Windows**:\n\n    `cmd /C \"set STDOUT_LOGGER=true && set LOG_LEVEL=debug && set LOGGER_OMIT_DATA=false && \".\\Redis Insight.exe\"\"`\n\n* **macOS** (from the Applications folder):\n\n    `LOG_LEVEL=debug LOGGER_OMIT_DATA=false open \"Redis Insight.app\"`\n\n* **Linux**:\n\n    `LOG_LEVEL=debug LOGGER_OMIT_DATA=false \"redis insight\"`\n\n    Note: if you use LOGGER_OMIT_DATA=false, logs may contain sensitive data."
    },
    {
      "id": "to-log-everything",
      "title": "To log everything",
      "role": "content",
      "text": "* **Windows**:\n\n    `cmd /C \"set STDOUT_LOGGER=true && set LOG_LEVEL=debug && set LOGGER_OMIT_DATA=false && set DEBUG=* && \".\\Redis Insight.exe\"\"`\n\n* **macOS** (from the Applications folder):\n\n    `LOG_LEVEL=debug LOGGER_OMIT_DATA=false DEBUG=* open \"Redis Insight.app\"`\n\n* **Linux**:\n\n    `LOG_LEVEL=debug LOGGER_OMIT_DATA=false DEBUG=* \"redis insight\"`\n\n    Note: if you use LOGGER_OMIT_DATA=false or DEBUG=*, logs may contain sensitive data."
    }
  ],
  "examples": []
}
