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.