...
As of 2023 Spring, the API gateway offers endpoints to retrieve and manage metrics. E.g.For example, it is possible to dynamically calculate the binary storage used by individual tenants. This information could be useful, e.g., for billing purposes.
The following endpoints are available. The URLs contain the metric
path parameter to specify the type of metric. As of 2023 Spring, only the value storage
is accepted.
Retrieval | Reset | |
---|---|---|
metric for all tenants | GET /api/system/metrics/{metric} | DELETE /api/system/metrics/{metric} |
metric for any specified tenant | GET /api/system/tenants/{tenant}/metrics/{metric} | DELETE /api/system/tenants/{tenant}/metrics/{metric} |
metric for currently active tenant | GET /api/admin/metrics/{metric} | DELETE /api/admin/metrics/{metric} |
Storage Metric
The As of 2023 Spring, the storage metric allows to dynamically calculate the binary storage used by individual tenants, e.g., for billing purposes.
In the endpoint URLs above, use storage
as value for the metric
path parameter. E.g.For example:
Code Block |
---|
https://<host>/api/system/metrics/storage |
...
The initial calculation or triggered recalculation is a counting process via database statements over all tenants. It is managed by the AUDIT Service and its behavior (automation and fail safety) can be adjusted in the AUDIT service's configuration. During No storage metric can be retrieved during the counting process in the database, no storage metric can be retrieved. Requests to the GET endpoints listed above return an error.
After the successful counting process in the database, the result is stored in Redis and dynamically updated during any operations on binary content files via API gateway.
Object Count Metric
The As of 2023 Summer, the object count metric provides the number of DMS objects (including folder objects) within one specific tenant. AdditionallyIn addition, the number of folder objects is provided separately provided. The information might be used for billing purposes as well as for an emptiness check before removing a tenant from the system.
For the object count metric , only the tenant-specific retrieval endpoints GET /api/system/tenants/{tenant}/metrics/{metric} and GET /api/admin/metrics/{metric} are available. In the endpoint URLs above, use objectCount
as value for the metric
path parameter. E.g.For example:
Code Block |
---|
https://<host>/api/system/metrics/objectCount |
...