@@ -7,48 +7,62 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0).
77
88## Unreleased
99
10+ Nothing.
11+
12+ ## [ 5.10.0] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/compare/v5.9.1...v5.10.0 ) / 2023-02-26
13+
14+ First release in several months. Includes new features and fixes from various
15+ contributors. Notable changes that might have an impact on existing setups is
16+ the automatic instrumentation of mounted apps and the deprecation of the
17+ lowercase ` prometheus_multiproc_dir ` environment variable.
18+
1019### Added
1120
12- - Added smart handling of mounted apps. Previously the URL handler logic did not
13- handle mounted apps and always returned the prefix in that case. This is based
14- on code from
21+ - Added smart ** handling of mounted apps** . Previously the URL handler logic did
22+ not handle mounted apps and always returned just the prefix in that case.
23+ Based on code from
1524 [ elastic/apm-agent-python] ( https://github.com/elastic/apm-agent-python )
1625 licensed under the permissive BSD-3-Clause License. Thanks to
17- [ @LordGaav ] ( https://github.com/LordGaav ) for proposing this enhancement and
18- implementing it in
26+ [ @LordGaav ] ( https://github.com/LordGaav ) for proposing this enhancement / fix
27+ and implementing it in
1928 [ #208 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/208 ) .
20- Related to
29+ Related to issues
2130 [ #31 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/31 )
2231 and
2332 [ #121 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/121 ) .
33+
2434- Added optional parameters ` metric_namespace ` and ` metric_subsystem ` to
25- ` instrument() ` method to configure namespace and subsystem for all metric
35+ ` instrument() ` method to ** configure namespace and subsystem** for all metric
2636 names. Check the [ ` README.md ` ] ( README.md#specify-namespace-and-subsystem ) for
2737 more information. Thanks to [ @phbernardes ] ( https://github.com/phbernardes ) for
2838 proposing this enhancement and implementing it in
2939 [ #193 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/193 ) .
30- - Added passthrough of body to ` info.response ` . This enables metrics that work
31- based on data in the body. Thanks to everyone who brought this up in
40+
41+ - Added ** passthrough of body** to ` info.response ` . This enables metrics that
42+ work based on data in the body. Thanks to everyone who brought this up in
3243 [ #76 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/76 )
3344 and to [ @HadilD ] ( https://github.com/HadilD ) for implementing it in
3445 [ #203 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/203 ) .
35- - Allowed passing a custom registry to be used instead of using the default one.
36- This would be useful in particular when testing multiple FastAPI apps (e.g.
37- microservices) in the same tests run. Note that there are issues with the
38- current implementation in certain corner cases. Thanks to
46+
47+ - Allowed ** passing a custom registry** to be used instead of using the default
48+ one. This would be useful in particular when testing multiple FastAPI apps
49+ (e.g. microservices) in the same tests run. Note that there are issues with
50+ the current implementation in certain corner cases. Thanks to
3951 [ @tiangolo ] ( https://github.com/tiangolo ) for for proposing this enhancement
4052 and implementing it in
4153 [ #153 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/153 ) .
54+
4255- Environment variable used by ` should_respect_env_var ` (default
43- ` ENABLE_METRICS ` ) now accepts truthy values like ` 1 ` and ` true ` and not just
44- ` True ` . Thanks to [ @chbndrhnns ] ( https://github.com/chbndrhnns ) for proposing
45- this enhancement in
56+ ` ENABLE_METRICS ` ) now ** accepts truthy values** like ` 1 ` and ` true ` and not
57+ just ` True ` . Thanks to [ @chbndrhnns ] ( https://github.com/chbndrhnns ) for
58+ proposing this enhancement in
4659 [ #27 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/27 )
4760 and implementing it in
4861 [ #28 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/28 ) .
49- - Added support for asynchronous instrumentation functions. The ` add() ` method
50- now accepts them in addition to "normal" functions and the instrumentator
51- middleware will await them appropriately. Thanks to
62+
63+ - Added support for ** asynchronous instrumentation functions** . The ` add() `
64+ method now accepts them in addition to "normal" functions and the
65+ instrumentator middleware will await them appropriately. Thanks to
5266 [ @AndreasPB ] ( https://github.com/AndreasPB ) for for proposing this enhancement
5367 and implementing it in
5468 [ #61 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/61 ) .
@@ -59,7 +73,8 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0).
5973
6074- Licensed part of the project under the BSD-3-Clause License. This is due to
6175 code being used from a repo licensed under BSD-3-Clause (see the "Added"
62- section). The default ISC License and the BSD-3-Clause License are permissive.
76+ section). The default ISC License and the BSD-3-Clause License are both
77+ permissive. So there should be no user impact.
6378
6479### Fixed
6580
@@ -71,6 +86,15 @@ and adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0).
7186 [ @blag ] ( https://github.com/blag ) for fixing it in
7287 [ #192 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/pull/192 ) .
7388
89+ - Fixed documentation in main README on how to use
90+ prometheus-fastapi-instrumentator with current versions of FastAPI. Related to
91+ issues
92+ [ #214 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/214 )
93+ and
94+ [ #80 ] ( https://github.com/trallnag/prometheus-fastapi-instrumentator/issues/80 ) .
95+ Thanks to [ @alfaro28 ] ( https://github.com/alfaro28 ) and
96+ [ @harochau ] ( https://github.com/harochau ) .
97+
7498### Deprecated
7599
76100- Deprecated environment variable ` prometheus_multiproc_dir ` and replaced it
0 commit comments