cdviz-collector

Configure and debug cdviz-collector TOML event pipelines for SDLC and CI/CD telemetry.

2|2|Updated Dec 12, 2024
One-click install
npx skills add https://github.com/cdviz-dev/cdviz-collector --skill cdviz-collector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cdviz-collector
Source: https://github.com/cdviz-dev/cdviz-collector/tree/main/skill
Command: npx skills add https://github.com/cdviz-dev/cdviz-collector --skill cdviz-collector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

cdviz-collector removes the manual effort of gathering fragmented SDLC and CI/CD signals, normalizing them into consistent CDEvents for downstream systems and dashboards.

Core Features & Use Cases

  • Multi-source collection: Ingest events from webhooks, SSE, Kafka, NATS, file systems, S3, and HTTP polling.
  • Flexible delivery: Dispatch normalized events to HTTP, SSE, file, Kafka, NATS, PostgreSQL, and ClickHouse sinks.
  • VRL transformation: Reshape, enrich, filter, and split events before dispatch with deterministic transformer logic.
  • Use Case: Use it to capture GitHub Actions or Jenkins activity, map it into standardized CDEvents, and feed observability pipelines or CDviz dashboards.

Quick Start

Ask the assistant to help you build, validate, and debug a cdviz-collector TOML config and VRL transformer for your event source and target sink.

Frequently Asked Questions about cdviz-collector

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

FAQPage Schema
How do I normalize CI/CD telemetry into CDEvents from multiple sources?

You can normalize CI/CD telemetry into CDEvents by configuring a collector pipeline that ingests events from webhooks, Kafka, NATS, S3, or HTTP polling, and maps them into the standardized CDEvents format for downstream observability systems.

How do I write VRL transformers to filter and enrich SDLC events?

VRL transformers allow you to reshape, enrich, filter, and split SDLC events with deterministic logic before dispatch. You author VRL scripts within the collector configuration to manipulate event payloads and map them to CDEvents schemas.

Can I send normalized CDEvents to PostgreSQL and ClickHouse sinks?

Yes, normalized CDEvents can be dispatched to multiple sinks including PostgreSQL and ClickHouse, alongside HTTP, SSE, file, Kafka, and NATS delivery targets, enabling flexible downstream storage and dashboard integration.

How do I validate a TOML configuration for an event collection pipeline?

You validate a TOML configuration for an event collection pipeline by using the collector CLI mode, which checks source, sink, and transformer workflows for correctness, ensuring proper CDEvents mapping, deterministic timestamps, and valid VRL transformer logic.

What is the best way to capture GitHub Actions activity for observability dashboards?

The best way to capture GitHub Actions activity is to ingest webhook events from GitHub Actions, normalize them into CDEvents using a TOML-configured collector pipeline, and dispatch the mapped telemetry to observability sinks or dashboards.

Why are my pipeline event timestamps inconsistent across different sources?

Inconsistent pipeline event timestamps occur when sources lack deterministic timestamp normalization. The collector addresses this by enforcing deterministic timestamps during the VRL transformation and CDEvents mapping phases within your TOML configuration.