enhancement(metrics): allow disabling via config option

Signed-off-by: Erik Michelson <github@erik.michelson.eu>
This commit is contained in:
Erik Michelson 2023-06-04 20:46:59 +02:00 committed by Tilman Vatteroth
parent a349ddde56
commit 143864b8d9
6 changed files with 20 additions and 11 deletions

2
app.js
View file

@ -75,8 +75,10 @@ app.use(morgan('combined', {
}))
// Register prometheus metrics endpoint
if (config.enableStatsApi) {
app.use(apiMetrics())
metrics.setupCustomPrometheusMetrics()
}
// socket io
const io = require('socket.io')(server, { cookie: false })

View file

@ -21,7 +21,7 @@ to `config.json` before filling in your own details.
## HedgeDoc basics
| config file | environment | **default** and example value | description |
| -------------------- | ------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|----------------------|---------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| | `CMD_CONFIG_FILE` | **no default**, `/path/to/config.json` | optional override for the path to HedgeDoc's config file |
| `db` | | **`undefined`**, `{ "dialect": "sqlite", "storage": "./db.hedgedoc.sqlite" }` | set the db configs, [see more here](https://sequelize.org/v5/manual/dialects.html) |
| `db.username` | `CMD_DB_USERNAME` | **`undefined`**, `hedgedoc-db-user` | Username used to authenticate to the database (host). |
@ -41,6 +41,7 @@ to `config.json` before filling in your own details.
| `heartbeatTimeout` | | **`10000`** | socket.io heartbeat timeout |
| `documentMaxLength` | `CMD_DOCUMENT_MAX_LENGTH` | **`100000`** | note max length |
| `linkifyHeaderStyle` | | **`keep-case`**, `lower-case`, `gfm` | how is a header text converted into a link id |
| `enableStatsApi` | `CMD_ENABLE_STATS_API` | **`true`**, `false` | Enables or disables the /status and /metrics endpoint. |
## HedgeDoc paths stuff

View file

@ -179,5 +179,6 @@ module.exports = {
// Generated id: "31-good-morning-my-friend---do-you-have-5"
// 2nd appearance: "31-good-morning-my-friend---do-you-have-5-1"
// 3rd appearance: "31-good-morning-my-friend---do-you-have-5-2"
linkifyHeaderStyle: 'keep-case'
linkifyHeaderStyle: 'keep-case',
enableStatsApi: true
}

View file

@ -157,5 +157,6 @@ module.exports = {
allowEmailRegister: toBooleanConfig(process.env.CMD_ALLOW_EMAIL_REGISTER),
allowGravatar: toBooleanConfig(process.env.CMD_ALLOW_GRAVATAR),
openID: toBooleanConfig(process.env.CMD_OPENID),
linkifyHeaderStyle: process.env.CMD_LINKIFY_HEADER_STYLE
linkifyHeaderStyle: process.env.CMD_LINKIFY_HEADER_STYLE,
enableStatsApi: toBooleanConfig(process.env.CMD_ENABLE_STATS_API)
}

View file

@ -24,6 +24,9 @@ statusRouter.get('/_health', function (req, res) {
// get status
statusRouter.get('/status', function (req, res, next) {
if (!config.enableStatsApi) {
return errors.errorForbidden(res)
}
realtime.getStatus(function (data) {
res.set({
'Cache-Control': 'private', // only cache by client

View file

@ -15,6 +15,7 @@ special actions.
- Add dedicated healthcheck endpoint at /_health that is less resource intensive than /status.
- Compatibility with Node.js 18 and later
- Add support for the arm64 architecture in the docker image
- Add a config option to disable the `/status` and `/metrics` endpoints
### Bugfixes
- Fix that permission errors can break existing connections to a note, causing inconsistent note content and changes not being saved