### Pioreactor Logs2Discord
This is a Pioreactor plugin to post a bioreactor's logs to a Discord channel.
### Installation
This is a two part installation.
#### 1. Setting up your Discord channel
1. You probably want a dedicated channel for incoming logs, as it can get chatty. So go ahead
and create a dedicated channel in your Discord channel. I've called mine `experiment_logs`.
2. Under your server's dropdown, find "Server Settings" -> "Integrations"
3. Click "Webhooks" -> "New webhook" to create your webhook. Give it a name like `PioreactorLogs`, and choose the channel from step 1. Here's an avatar icon you can use too:
![icon](https://github.com/Pioreactor/pioreactorui_frontend/blob/main/public/logo.png)
4. Copy the webhook URL to your clipboard. We'll need this in a moment.
#### 2. Installing this plugin
1. In your Pioreactor interface, click on "Plugins". Find `pioreactor-logs2discord`, and click "Install" beside it. **Or** you can run `pio plugins install pioreactor-logs2discord`. Either way, this plugin will be installed on your leader Pioreactor.
2. After installing (should take less than a minute), click on "Configuration". At the bottom of the page will be a section called `[logs2discord]`.
```
[logs2discord]
discord_webhook_url=
log_level=INFO
```
Add your webhook URL from step 4. here. Click "Save". You can also change the level of logs to report, see [Python logging levels](https://docs.python.org/3/library/logging.html#logging-levels).
3. Power-cycle (reboot) the Pioreactor leader, or ssh into the Pioreactor leader and run `sudo systemctl restart pioreactor_startup_run@logs2discord.service`
4. In your dedicated Discord channel, you should start to see logs arrive!
Raw data
{
"_id": null,
"home_page": "https://github.com/Pioreactor/pioreactor-logs2discord",
"name": "pioreactor-logs2discord",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": null,
"author": "Pioreactor",
"author_email": "hello@pioreactor.com",
"download_url": "https://files.pythonhosted.org/packages/8c/dd/33f700353dbc80b96075d13c8ed9263ca6a49d529645ffbf672c6c29992d/pioreactor_logs2discord-0.1.2.tar.gz",
"platform": null,
"description": "### Pioreactor Logs2Discord\n\nThis is a Pioreactor plugin to post a bioreactor's logs to a Discord channel.\n\n### Installation\n\nThis is a two part installation.\n\n#### 1. Setting up your Discord channel\n\n1. You probably want a dedicated channel for incoming logs, as it can get chatty. So go ahead\nand create a dedicated channel in your Discord channel. I've called mine `experiment_logs`.\n\n2. Under your server's dropdown, find \"Server Settings\" -> \"Integrations\"\n\n3. Click \"Webhooks\" -> \"New webhook\" to create your webhook. Give it a name like `PioreactorLogs`, and choose the channel from step 1. Here's an avatar icon you can use too:\n\n![icon](https://github.com/Pioreactor/pioreactorui_frontend/blob/main/public/logo.png)\n\n4. Copy the webhook URL to your clipboard. We'll need this in a moment.\n\n#### 2. Installing this plugin\n\n1. In your Pioreactor interface, click on \"Plugins\". Find `pioreactor-logs2discord`, and click \"Install\" beside it. **Or** you can run `pio plugins install pioreactor-logs2discord`. Either way, this plugin will be installed on your leader Pioreactor.\n\n2. After installing (should take less than a minute), click on \"Configuration\". At the bottom of the page will be a section called `[logs2discord]`.\n\n```\n[logs2discord]\ndiscord_webhook_url=\nlog_level=INFO\n```\n\nAdd your webhook URL from step 4. here. Click \"Save\". You can also change the level of logs to report, see [Python logging levels](https://docs.python.org/3/library/logging.html#logging-levels).\n\n3. Power-cycle (reboot) the Pioreactor leader, or ssh into the Pioreactor leader and run `sudo systemctl restart pioreactor_startup_run@logs2discord.service`\n\n4. In your dedicated Discord channel, you should start to see logs arrive!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Push logs generated by Pioreactors to your Discord workspace",
"version": "0.1.2",
"project_urls": {
"Homepage": "https://github.com/Pioreactor/pioreactor-logs2discord"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "14cfb83d2b76438f83d8048e9e511b210d9eb92b5221ad562d740ef84260f42a",
"md5": "6afe4143fb9ce4aac1ada3d8cc9ce23d",
"sha256": "c9169c9530c5656862d02e1c52fed71220b955ce05ad6b723bc74d7a49f8bed9"
},
"downloads": -1,
"filename": "pioreactor_logs2discord-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6afe4143fb9ce4aac1ada3d8cc9ce23d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5451,
"upload_time": "2024-09-25T19:45:25",
"upload_time_iso_8601": "2024-09-25T19:45:25.470112Z",
"url": "https://files.pythonhosted.org/packages/14/cf/b83d2b76438f83d8048e9e511b210d9eb92b5221ad562d740ef84260f42a/pioreactor_logs2discord-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8cdd33f700353dbc80b96075d13c8ed9263ca6a49d529645ffbf672c6c29992d",
"md5": "75261b9d0d86c0ab6ed2120f8adc1436",
"sha256": "5f93a75c6b5fcdc09e843f8e30d6f68969ad24b5c3dcb34475813607dcce1277"
},
"downloads": -1,
"filename": "pioreactor_logs2discord-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "75261b9d0d86c0ab6ed2120f8adc1436",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4040,
"upload_time": "2024-09-25T19:45:27",
"upload_time_iso_8601": "2024-09-25T19:45:27.786034Z",
"url": "https://files.pythonhosted.org/packages/8c/dd/33f700353dbc80b96075d13c8ed9263ca6a49d529645ffbf672c6c29992d/pioreactor_logs2discord-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-25 19:45:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Pioreactor",
"github_project": "pioreactor-logs2discord",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "pioreactor-logs2discord"
}