...
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
As of 2023 Summer, the object count metric provides the number of DMS objects (including folder objects) within one specific tenant. In addition, the number of folder objects is provided separately. 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. For example:
| Code Block |
|---|
https://<host>/api/system/metrics/objectCount |
The count includes all current versions of DMS objects regardless of role-based access permissions. Moreover, it includes invisible objects (flagged with OBJECT_FLAGGED_FOR _DELETION in the search index) as well.
| Info | |||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||
Read on
|
...