This is a Pioreactor plugin to post a bioreactor's logs to a Slack room.
This is a two part installation.
-
You probably want a dedicated channel for incoming logs, as it can get chatty. So go ahead and create a dedicated channel in your Slack workspace. I've called mine
experiment_logs
. -
In Your Apps, click "Create New App" -> From "Scratch". Give it a name (something descriptive, like
Pioreactor Logs2Slack
), and select the workspace. -
On the next page, select "Incoming Webhooks", and turn "Activate" to
On
-
Click "Add new webhook to workspace"
-
In the next section, select the channel you made in step 1. Click "Allow".
-
On the next page, under "Webhook URL", is your new webhook URL, something like
https://hooks.slack.com/services/ABC.../124...
. Important: this is private, don't share it with untrusted people, don't commit it into Github, etc.
-
In your Pioreactor interface, click on "Plugins". Find
pioreactor-logs2slack
, and click "Install" beside it. This will install the plugin for each Pioreactor in your cluster. Or you can runpio install-plugin pioreactor-logs2slack
-
After installing (should take less than a minute), click on "Configuration". At the bottom of the page will be a section called
[logs2slack]
.
[logs2slack]
slack_webhook_url=
log_level=INFO
Add your webhook URL from step 6. here. Click "Save". You can also change the level of logs to report, see Python logging levels.
-
Power-cycle (reboot) the Pioreactor, or ssh into the Pioreactor leader and run
sudo systemctl restart pioreactor_startup_run@logs2slack.service
-
In your dedicated Slack channel, you should start to see logs arrive!