Datasette plugin for configuring Sentry
Project description
datasette-sentry
Datasette plugin for configuring Sentry for error reporting
Installation
pip install datasette-sentry
Usage
This plugin only takes effect if your metadata.json
file contains relevant top-level plugin configuration in a "datasette-sentry"
configuration key.
You will need a Sentry DSN - see their Getting Started instructions.
Add it to metadata.json
like this:
{
"plugins": {
"datasette-sentry": {
"dsn": "https://KEY@sentry.io/PROJECTID"
}
}
}
Settings in metadata.json
are visible to anyone who visits the /-/metadata
URL so this is a good place to take advantage of Datasette's secret configuration values, in which case your configuration will look more like this:
{
"plugins": {
"datasette-sentry": {
"dsn": {
"$env": "SENTRY_DSN"
}
}
}
}
Then make a SENTRY_DSN
environment variable available to Datasette.
Configuration
In addition to the dsn
setting, you can also configure the Sentry sample rate by setting sample_rate
to a floating point number between 0 and 1.
For example, to capture 25% of errors you would do this:
{
"plugins": {
"datasette-sentry": {
"dsn": {
"$env": "SENTRY_DSN"
},
"sample_rate": 0.25
}
}
}
Performance monitoring
Sentry Performance Monitoring records full traces of page for further analysis, in addition to tracking errors.
You can enable that by adding "enable_tracing" to your plugin configuration:
{
"plugins": {
"datasette-sentry": {
"dsn": {
"$env": "SENTRY_DSN"
},
"enable_tracing": true
}
}
}
The default sample rate if you do this will be 1.0
, meaning every response will be traced. This can get expensive - you can adjust the tracing rate using traces_sample_rate
. Set that to 0.1
to sample 10% of requests, for example:
{
"plugins": {
"datasette-sentry": {
"dsn": {
"$env": "SENTRY_DSN"
},
"enable_tracing": true,
"traces_sample_rate": 0.1
}
}
}
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for datasette_sentry-0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9dc7276039d7c5688b904416e3ceeb94773c23dcb0b20a450e2ea282b201f8ca |
|
MD5 | 866766484848de887b99c6cfd6bdba22 |
|
BLAKE2b-256 | ab2f46a300bb5fdee640481692547e1e10746bc2a8defce3bf64898bcf06ab77 |