Usage of cdviz-collector

cdviz-collector help

A service & cli to collect SDLC/CI/CD events and to dispatch as cdevents.

Usage: cdviz-collector [OPTIONS] <COMMAND>

Commands:
  connect    Launch collector as a server to connect sources to sinks
  send       Send JSON data directly to a sink for testing and scripting
  transform  Transform local JSON files using configured transformers
  help       Print this message or the help of the given subcommand(s)

Options:
      --disable-otel           Disable OpenTelemetry initialization and use minimal tracing setup
  -C, --directory <DIRECTORY>  Change working directory before executing the command
  -v, --verbose...             Increase logging verbosity
  -q, --quiet...               Decrease logging verbosity
  -h, --help                   Print help
  -V, --version                Print version

Subcommands

• connect - Launch collector as a server to connect sources to sinks.
• send - Send JSON data directly to a sink for testing and scripting.
• transform - Transform local JSON files using configured transformers or test transformer.

Common Usage Patterns

Development and Testing

# Start development server
cdviz-collector connect --config dev-config.toml --verbose

# Test webhook endpoint
cdviz-collector send --data '{"test": "event"}' --url http://localhost:8080/webhook

# Transform test files
cdviz-collector transform --input ./test-events --output ./transformed --verbose

Production Deployment

# Production server with specific config
cdviz-collector connect --config /etc/cdviz/config.toml --directory /opt/cdviz

# Batch process files in production
cdviz-collector transform \
  --input /data/input \
  --output /data/output \
  --config /etc/cdviz/config.toml \
  --mode overwrite

Scripting and Automation

# Send events from scripts
cdviz-collector send --data @event.json --url "$WEBHOOK_URL"

# Pipeline for processing files
find /events -name "*.json" | while read file; do
  cdviz-collector send --data "@$file" --url "$WEBHOOK_URL"
done