connect-debugging

Diagnose and monitor Redpanda Connect pipelines using rpk connect lint and health endpoints.

6|3|Updated May 31, 2026
One-click install
npx skills add https://github.com/redpanda-data/skills --skill connect-debugging
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: connect-debugging
Source: https://github.com/redpanda-data/skills/tree/main/skills/connect-debugging
Command: npx skills add https://github.com/redpanda-data/skills --skill connect-debugging

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Diagnoses, validates, and monitors Redpanda Connect pipelines. Use when a Redpanda Connect pipeline fails, stalls, drops messages, or won't start; when linting a config with rpk connect lint; tuning log level or format; reading Connect metrics (Prometheus, statsd, json_api) or traces (OpenTelemetry); checking /ready and /ping health endpoints; running a dry-run connection test; or diagnosing connector failures including auth errors, TLS errors, Enterprise license errors, backpressure, and checkpoint/cache issues. Covers Redpanda Connect enterprise features and their config keys: enterprise connectors including all CDC inputs (postgres_cdc, mysql_cdc, mongodb_cdc, oracledb_cdc logminer block), connector allow/deny lists, secrets management URNs, the redpanda: configuration service block, and FIPS compliance — all requiring an Enterprise license.

Core Features & Use Cases

  • Diagnoses, validates, and monitors Redpanda Connect pipelines for resilience.
  • Provides linting, dry-run validation, health checks, metrics, and tracing visibility.
  • Supports enterprise feature awareness, including license and access controls.

Quick Start

Run rpk connect lint on your pipeline YAML, then perform a dry-run to validate connections and use health and metrics endpoints to diagnose issues.

Frequently Asked Questions about connect-debugging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a stalled Redpanda Connect pipeline?▼

Diagnose Redpanda Connect pipeline stalls by running rpk connect lint for YAML validation, executing a dry-run to test connections, and checking /ready and /ping health endpoints to identify backpressure or failures.

What is the best way to validate a Redpanda Connect config before running it?▼

Validate a Redpanda Connect config by running rpk connect lint to catch syntax errors, then perform a dry-run to verify input and output connections without processing live data.

How does OpenTelemetry tracing work with Redpanda Connect pipelines?▼

OpenTelemetry tracing in Redpanda Connect pipelines exposes internal processing steps and latencies, helping you investigate connector failures, message drops, and authentication or TLS errors across input and output flows.

Do I need an Enterprise license to use CDC connectors in Redpanda Connect?▼

Yes, an Enterprise license is required for CDC connectors like postgres_cdc, mysql_cdc, and mongodb_cdc in Redpanda Connect, along with secrets management URNs, connector allow/deny lists, and FIPS compliance configurations.

Why does my Redpanda Connect pipeline drop messages during runtime?▼

Redpanda Connect pipelines may drop messages due to backpressure, checkpoint or cache issues, or TLS and authentication failures, which you can investigate using Connect metrics and OpenTelemetry traces.

Can I check Redpanda Connect health endpoints using Prometheus metrics?▼

Yes, you can monitor Redpanda Connect health using Prometheus metrics alongside /ready and /ping endpoints to track pipeline resilience, tune log levels, and diagnose connector misbehavior during runtime.