Usage Report

Digital Distributed containers automatically report their presence and basic information to the Digital Enterprise Suite to facilitate the management of Digital Distributed Container (DDC) Tokens.

A Digital Distributed Container (DDC) Token is required for each deployment in production. The number of available tokens is established in your Trisotech Contract.

Production deployments

A Digital Distributed Container (DDC) deployment for production consumes a token. A deployment is defined as one or more identical DDC container running in the same data center (scaling a deployment counts as a single token). Each data center running the same DDC container requires an additional token.

Test and Development deployments

A Digital Distributed Container (DDC) deployment for testing or development is never consuming a token.

Configuring Meta-Data

By configuring the metadata of the Digital Distributed Container (DDC), it will facilitate the tracking of DDC in production and provide transparency on the consumed number of tokens.

Each deployment is identified as follows.

Identifier

Default value

Variable

Hostname (pod name)

Reported from the operating system

Namespace

Kubernetes Namespace

NAMSESPACE_NAME

Deployment Name

Helm application name (<DDC_NAME>)

DEPLOYMENT_NAME

Cluster Name

Issuer of the pod service account

CLUSTER_NAME

Tags (comma separated)

TAGS

Production flag

Execution environment production flag used to build the DDC (true or false)

PRODUCTION

In the reporting, multiple DDCs with the same cluster name, deployment name and namespace are considered to be scaling of a single deployment and consume a single token.

To override the default value of one of the identifier, set the helm value with the prefix ddc..

For example, to set a cluster name.

helm upgrade des des-<VERSION>.tgz \
  --namespace des \
  --reuse-values \
  --set ddc.CLUSTER_NAME="My Cluster"

It is not possible to overload the hostname

Helm does not love commas in its value, escape commas with a \ character: --set ddc.TAGS="tag1\,tag2\,tag3"

Disabling Reporting

If there is no network route between your Digital Distributed Container (DDC) and the Digital Enterprise Suite (DES), you can disable the reporting functionality and keep a manual tally of your deployments.

To disable the reporting.

helm upgrade des des-<VERSION>.tgz \
  --namespace des \
  --reuse-values \
  --set ddc.DDC_REPORTING_DISABLED=true

Accessing Usage Report

The usage report is available in the Digital Distributed Containers page of the Digital Enterprise Suite administration interface.