Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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.

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

...