Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/astrolabsoftware/fink-alert-simulator

Simulate alert streams for the Fink broker
https://github.com/astrolabsoftware/fink-alert-simulator

apache-avro apache-kafka astronomy streaming

Last synced: 3 days ago
JSON representation

Simulate alert streams for the Fink broker

Awesome Lists containing this project

README

        

# Fink alert simulator

`fink-alert-simulator` is a package to inject alert data to Apache Kafka to feed brokers listening to Kafka streams. The main purposes are testing the broker and replaying historical alert data. This package belongs to the [fink broker](https://github.com/astrolabsoftware/fink-broker) ecosystem.

## Installation

Fork and/or clone the repo, and update your `PYTHONPATH` and `PATH` to use the tools:

```bash
# in your ~/.bash_profile
export FINK_ALERT_SIMULATOR=/path/to/fink-alert-simulator
export PYTHONPATH=$FINK_ALERT_SIMULATOR:$PYTHONPATH
export PATH=$FINK_ALERT_SIMULATOR/bin:$PATH
```

## Usage

Simply use

```bash
fink_simulator [options] [-h]
```

Note that you would need to have access to a Kafka cluster to publish alerts, otherwise you can use the docker version for local tests (you would need docker-compose installed). Learn more on how to use fink-alert-simulator by following the dedicated [tutorial](https://fink-broker.readthedocs.io/en/latest/tutorials/simulator/).