Annotations and labels
  • 20 Jun 2024
  • 3 Minutes to read
  • Dark
    Light
  • PDF

Annotations and labels

  • Dark
    Light
  • PDF

Article summary

The topic describes the various annotations that are available for traceable-agent


Traceable module extension (tme)

The following tables describe labels and annotations for namespace and pod. 

Namespace

The following table describes annotations and labels for the namespace.

Label

Label

Description

traceableai-inject-tme

Set this value to enabled for the namespace where you want to inject Traceable module extension

 Annotations

Annotation

Description

tme.traceable.ai/defaultInject

This annotation defines the default injection behavior on pods in a namespace, that is, whether you want to inject or do not want to inject. 

  • Value set to true - When you set the value to true, then by default injection is enabled. If you do not want injection at the pod level, set agent.traceable.ai/inject: false. 

  • Value set to false - When you set the value to false, then by default injection is disabled. In this case, if you want injection at the pod level, set agent.traceable.ai/inject: true

When this annotation is not set, the default behavior is similar to when the value is set to false.

Pod

Labels

There are no labels for the pod for Traceable platform agent.

Annotations

Annotations

Description

tme.traceable.ai/inject

Set the value to true to enable injection and false to disable injection. The default behavior, when this annotation is not specified, depends on the behavior of the namespace. See, tme.traceable.ai/defaultInject annotation in the namespace section above.

tme.traceable.ai/port

Defines the port to be used for tme sidecar GRPC endpoint. The default value is 5441.

tme.traceable.ai/restPort

Defines the port to be used for tme REST endpoint. The default value is 5442.

tme.traceable.ai/blocking

The annotation is used to define request blocking in the injected tme. Set the value to true to enable blocking and false to disable blocking. The default behavior is to enable blocking.


Mirroring

The following tables describe labels and annotations for namespace and pod. 

Label

Label

Description

traceableai-inject-tme

Set this value to enabled for the target namespace.

Namespace

Annotations

Annotation

Description

mirror.traceable.ai/defaultInject

This annotation defines the default injection behavior on pods in a namespace, that is, whether you want to inject or do not want to inject. 

  • Value set to true - When you set the value to true, then by default injection is enabled. If you do not want injection at the pod level, set the pod annotation mirror.traceable.ai/inject: false

  • Value set to false - When you set the value to false, then by default injection is disabled. In this case, if you want injection at the pod level, set the pod annotation mirror.traceable.ai/inject: true

When this annotation is not set, the default behavior is similar to when the value is set to false.

Pod

The following table describes annotations and labels for the pod.

Labels

There are no labels for the pod for mirroring.

Annotations

Annotation

Description

mirror.traceable.ai/inject

Set the value to true to enable injection of the Traceable Mirroring Module(tmm) along with the Traceable Module Extension(tme) and false to disable injection. 
The default behavior, when this annotation is not specified, depends on the behavior of the namespace. See, mirror.traceable.ai/defaultInject annotation in the namespace section above.

Note

Other annotations prefixed with tme.traceable.ai also work alongside.


Java agent

The following tables describe labels and annotations for namespace and pod. 

Namespace

The following table describes annotations and labels for the namespace.

Label

Label

Description

traceableai-inject-java

Set the value to enabled for the namespace where you would like to inject the Java agent.

Annotation

Annotation

Description

java.traceable.ai/defaultInject

This annotation defines the default injection behavior on pods in a namespace, that is, whether you want to inject or do not want to inject. 

  • Value set to true - When you set the value to true, then by default injection is enabled. If you do not want injection at the pod level, set java.traceable.ai/inject: false

  • Value set to false - When you set the value to false, then by default injection is disabled. In this case, if you want injection at the pod level, set java.traceable.ai/inject: true

When this annotation is not set, the default behavior is similar to when the value is set to false.

Pod

The following table describes annotations and labels for the pod.

Labels

There are no labels for the pod for Java agent.

Annotation

Annotation

Description

java.traceable.ai/inject

Set the value to true to enable injection and false to disable injection. The default behavior, when this annotation is not specified, depends on the behavior of the namespace. See, java.traceable.ai/defaultInject annotation above.

java.traceable.ai/configmap

Defines the configmap that contains the Java agent configuration. The default value when this annotation is not specified is an empty string.

java.traceable.ai/configmapNamespace

Defines the namespace that contains the configmap defined above. The default value when this annotation is not specified is an empty string.

java.traceable.ai/blocking

The annotation is used to define request blocking in the injected Java agent. Set the value to true to enable blocking and false to disable blocking. The default behavior is to enable blocking.


Was this article helpful?