Troubleshooting¶

Solutions for common issues with CBOM Generator.

Common Issues¶

Issue	Quick Link
Empty or minimal results	No Components Found
Access denied errors	Permission Errors
Slow scans or high memory	Performance Tuning
Different output between runs	Non-Deterministic Output

Quick Diagnostics¶

Check Version¶

./build/cbom-generator --version

Verify Installation¶

# Run help
./build/cbom-generator --help

# Quick test scan
./build/cbom-generator --output /tmp/test.json /etc/ssl/certs
cat /tmp/test.json | jq '.components | length'

View Scan Errors¶

./build/cbom-generator --error-log /tmp/errors.log --output cbom.json
cat /tmp/errors.log

Getting Help¶

Error Log Analysis¶

Run with --error-log to capture detailed error information:

./build/cbom-generator --error-log /tmp/cbom-errors.log --output cbom.json 2>&1

Verbose Output¶

Enable verbose mode for debugging:

./build/cbom-generator --output cbom.json /etc/ssl 2>&1 | tee scan.log

Check Metadata Properties¶

The CBOM includes diagnostic metadata:

cat cbom.json | jq '.metadata.properties[] | select(.name | startswith("cbom:diagnostics"))'