datasette-sentry

用于配置Sentry的错误报告的Datasette插件

安装

pip install datasette-sentry

用法

此插件仅在您的metadata.json文件包含相关顶级插件配置，配置键为"datasette-sentry"时才生效。

您需要一个Sentry DSN - 请参阅他们的 入门说明。

将其添加到metadata.json中，如下所示

{
    "plugins": {
        "datasette-sentry": {
            "dsn": "https://KEY@sentry.io/PROJECTID"
        }
    }
}

metadata.json中的设置对于访问/-/metadata URL的任何人都是可见的，因此这是利用Datasette的 秘密配置值的好地方，在这种情况下，您的配置将看起来更像是这样

{
    "plugins": {
        "datasette-sentry": {
            "dsn": {
                "$env": "SENTRY_DSN"
            }
        }
    }
}

然后使SENTRY_DSN环境变量对Datasette可用。

配置

除了dsn设置外，您还可以通过将sample_rate设置为一个介于0和1之间的浮点数来配置Sentry的采样率。

例如，要捕获25%的错误，您将这样做

{
    "plugins": {
        "datasette-sentry": {
            "dsn": {
                "$env": "SENTRY_DSN"
            },
            "sample_rate": 0.25
        }
    }
}

性能监控

Sentry的性能监控记录页面的完整跟踪以进行进一步分析，除了跟踪错误。

您可以通过将“enable_tracing”添加到插件配置中来实现这一点

{
    "plugins": {
        "datasette-sentry": {
            "dsn": {
                "$env": "SENTRY_DSN"
            },
            "enable_tracing": true
        }
    }
}

如果这样做，默认采样率将是1.0，这意味着每个响应都将被跟踪。这可能很昂贵 - 您可以使用traces_sample_rate调整跟踪率。例如，将其设置为0.1以采样10%的请求

{
    "plugins": {
        "datasette-sentry": {
            "dsn": {
                "$env": "SENTRY_DSN"
            },
            "enable_tracing": true,
            "traces_sample_rate": 0.1
        }
    }
}