{
  "id": "redis-di-trace",
  "title": "redis-di trace",
  "url": "https://redis.io/docs/latest/integrate/redis-data-integration/reference/cli/redis-di-trace/",
  "summary": "Starts a trace session for troubleshooting data transformation",
  "tags": [
    "redis-di"
  ],
  "last_updated": "2026-04-01T08:10:08-05:00",
  "page_type": "content",
  "content_hash": "50447adbb1334f882ecde05eb9eae62a4db050444434fb29732b3b9a2f602762",
  "sections": [
    {
      "id": "usage",
      "title": "Usage",
      "role": "syntax",
      "text": "[code example]"
    },
    {
      "id": "options",
      "title": "Options",
      "role": "parameters",
      "text": "- `log_level`:\n  - Type: Choice(['TRACE', 'DEBUG', 'INFO', 'WARNING', 'ERROR', 'CRITICAL'])\n  - Default: `info`\n  - Usage: `--log-level\n-l`\n\n- `rdi_host` (REQUIRED):\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-host`\n\n  Host/IP of RDI Database\n\n- `rdi_port` (REQUIRED):\n  - Type: <IntRange 1<=x<=65535>\n  - Default: `none`\n  - Usage: `--rdi-port`\n\n  Port of RDI Database\n\n- `rdi_user`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-user`\n\n  RDI Database Username\n\n- `rdi_password`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-password`\n\n  RDI Database Password\n\n- `rdi_key`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-key`\n\n  Private key file to authenticate with\n\n- `rdi_cert`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-cert`\n\n  Client certificate file to authenticate with\n\n- `rdi_cacert`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-cacert`\n\n  CA certificate file to verify with\n\n- `rdi_key_password`:\n  - Type: STRING\n  - Default: `none`\n  - Usage: `--rdi-key-password`\n\n  Password for unlocking an encrypted private key\n\n- `max_change_records`:\n  - Type: <IntRange x>=1>\n  - Default: `10`\n  - Usage: `--max-change-records`\n\n  Maximum traced change records\n\n- `timeout` (REQUIRED):\n  - Type: <IntRange 1<=x<=600>\n  - Default: `20`\n  - Usage: `--timeout`\n\n  Stops the trace after exceeding this timeout (in seconds)\n\n- `trace_only_rejected`:\n  - Type: BOOL\n  - Default: `false`\n  - Usage: `--trace-only-rejected`\n\n  Trace only rejected change records\n\n- `help`:\n  - Type: BOOL\n  - Default: `false`\n  - Usage: `--help`\n\n  Show this message and exit."
    },
    {
      "id": "cli-help",
      "title": "CLI help",
      "role": "content",
      "text": "[code example]"
    }
  ],
  "examples": [
    {
      "id": "usage-ex0",
      "language": "plaintext",
      "code": "Usage: redis-di trace [OPTIONS]",
      "section_id": "usage"
    },
    {
      "id": "cli-help-ex0",
      "language": "plaintext",
      "code": "Usage: redis-di trace [OPTIONS]\n\n  Starts a trace session for troubleshooting data transformation\n\nOptions:\n  -l, --log-level [TRACE|DEBUG|INFO|WARNING|ERROR|CRITICAL]\n                                  [default: INFO]\n  --rdi-host TEXT                 Host/IP of RDI Database  [required]\n  --rdi-port INTEGER RANGE        Port of RDI Database  [1<=x<=65535;\n                                  required]\n  --rdi-user TEXT                 RDI Database Username\n  --rdi-password TEXT             RDI Database Password\n  --rdi-key TEXT                  Private key file to authenticate with\n  --rdi-cert TEXT                 Client certificate file to authenticate with\n  --rdi-cacert TEXT               CA certificate file to verify with\n  --rdi-key-password TEXT         Password for unlocking an encrypted private\n                                  key\n  --max-change-records INTEGER RANGE\n                                  Maximum traced change records  [x>=1]\n  --timeout INTEGER RANGE         Stops the trace after exceeding this timeout\n                                  (in seconds)  [default: 20; 1<=x<=600;\n                                  required]\n  --trace-only-rejected           Trace only rejected change records\n  --help                          Show this message and exit.",
      "section_id": "cli-help"
    }
  ]
}