---
title: "Annotations and labels"
slug: "annotations-and-labels"
tags: ["annotations", "labels", "pod"]
updated: 2024-06-20T03:45:47Z
published: 2024-06-20T03:45:47Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://traceabledocs.document360.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Annotations and labels

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&nbsp;`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`&nbsp;true` - When you set the value to`&nbsp;true`, then by default injection is enabled. If you **do not want** injection at the **pod level**, set`&nbsp;agent.traceable.ai/inject: false.&nbsp;` - Value set to`&nbsp;false&nbsp;`- 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&nbsp;`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&nbsp;`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 leve**l, 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&nbsp;`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`&nbsp;true`, then by default injection is enabled. If you **do not want** injection at the **pod leve**l, set `java.traceable.ai/inject: false`. - Value set to`&nbsp;false` - When you set the value to`&nbsp;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`&nbsp;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&nbsp;`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. |
