Skip to content

About

Creates or replays logs and open-telemetry signals to allow configuration pipelines to be easily tested

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SignalGenerator Python

SignalGenerator replays log events and Prometheus metric snapshots from deterministic source files. The project is an enhanced Python successor to mp3monster/LogGenerator.

The CLI supports configuration validation, effective-configuration output, legacy property conversion, log replay, scrape-driven metric replay, and scheduled Pushgateway delivery. See the design index, metrics operations, and the startup script guide.

Start with the task-oriented user guide. Contributors should use the separate development setup.

signal-generator validate --config examples/logs/basic/config.json
signal-generator run --config examples/logs/basic/config.json
signal-generator validate --config examples/metrics/config.json
signal-generator run --config examples/metrics/config.json

The metric example exposes /metrics, /healthz, /readyz, and / on http://127.0.0.1:9108. Each /metrics scrape consumes the next JSONL frame; lifecycle routes do not move the cursor.

Containers and OpAMP simulator integration

Phase 5 Compose profiles provide real Prometheus and Pushgateway interoperability plus the unified single-process Quart deployment:

docker compose -f tests/test-containers/phase5/compose.yaml --profile pull up --build -d
python tests/test-containers/phase5/verify.py pull

docker compose -f tests/test-containers/phase5/compose.yaml --profile push up --build -d
python tests/test-containers/phase5/verify.py push

docker compose -f tests/test-containers/phase5/compose.yaml --profile unified up --build -d
python tests/test-containers/phase5/verify.py unified

Run docker compose ... down --remove-orphans between profiles. Pull mode exposes SignalGenerator on 19108 and Prometheus on 19090; push mode exposes Pushgateway on 19091; unified mode exposes the shared Quart listener on 19110 and its Prometheus on 19092.

The separately built adapter is documented in integrations/opamp-simulator/README.md. Unified mode requires APP_ENABLE_DEV_FEATURES=true and runs simulated OpAMP clients and replay runtimes in one worker, process, listener, and event loop without a SignalGenerator subprocess.

Quality and release evidence

Run the complete core and adapter gate, performance benchmark, and release-manifest generator with:

python scripts/security_checks.py
python scripts/benchmark_replay.py --output test-results/performance.json
python scripts/release_artifacts.py dist/phase5-6 dist/phase5-6-adapter --output dist/evidence

See performance limits, security hardening, the compatibility matrix, and the signed-tag release process. The implementation verification records delivered evidence and the roadmap is the single register for planned enhancements.

About

Creates or replays logs and open-telemetry signals to allow configuration pipelines to be easily tested

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages