Label management

Traceable's Label management allows you to create labels and rules to tag API endpoints and services. API labels help you by filtering and categorizing API endpoints and services for better resource management. The label management process consists of the following two parts: 

1. Create a label.
2. Optionally, create rules and associate labels with them.

Step 1 - Create labels

You can create labels in Traceable from the API Endpoints and Services page. Th process to create labels from API Endpoints and Services page is same. The following steps show creating labels from the API Endpoints page.

1. Navigate to the API Endpoints page. 
2. Select an API for which you want to apply a label. 
3. Click on Manage Label to display a list of existing labels. You can create a new label inline if the label that you want to apply does not exist in the list.

The new label that you created would now be visible in the Manage Labels drop-down list. 

Operations on labels

When you add or a select, there are a few operations that you can do with labels. You can view these options when you click on the Manage Labels drop-down list and select a label. 

• Add selected labels - This option adds all the selected labels to all the selected API endpoints. 
• Replace with selected labels - You can use this option if you wish to replace the existing labels with the one's you have selected from the drop-down list.
• Remove selected labels - You can use this option to remove the selected labels from all the selected API endpoints or services. 

View all the applied labels

To view all the labels that are applied on a API endpoint or service, click on the name of the API endpoint or service to display the API endpoint or Services details page. All the applied labels are displayed when you click on the labels drop-down list as shown in the screenshot below.

The first label that is applied to the API endpoint or Service is displayed as the title of the drop-down list. You can remove the labels from this page also. 

Step 2 - (Optional) Create rules for labels

You can optionally create rules and associate it with a label. Creating meaningful rules and associating it with a label helps in automating the label application. You can create rules from two places:

• Navigate to Administration () > API Intelligence > Label Management.
• Navigate to Endpoint traces or Spans page from Traces menu. 

Create label rule from Administration page

You can create and associate rules from the Administration page. Click on Administration () > API Intelligence > Label Management.

1. You can add multiple conditions in a rule. All these conditions follow the AND rule, that is, for a rule to trigger all the conditions must be triggered. Each rule condition has three sections: 
   • Attribute - Add the attribute on which you want to create a rule. For example in the screenshot above, the attribute value is http.method. You can view the different attributes from Endpoint traces and Spans page.
   • Operation - Operation can be any one of the following:
     • Equals - Condition is true when the attribute value for the rule condition exactly matches the value defined in the Value field
     • Matches regex - Condition is true when regex matches the attribute value
     • Exists - Condition is true when attribute exists
   • Value - The value that you configure for each of the operation
2. These rules can be either applied on an API endpoint, a service or both. In the above screenshot, the rule is applied to both, API endpoint and service. 
3. You can choose one of the existing label. If the label does not exist, you can enter the value and search bar and create a label as explained in the Create label section. You can also generate a label from the attribute value. The attribute value becomes the name of the label. 

Create label rule from traces and span attributes

You can directly create a label rule from the traces or span attributes by navigating to Traces > Endpoint Traces/Spans > Attributes as shown in the screenshot below. Click on the Create Label Rule button to display the Create Rule Label window. Fill in the values as explained earlier. Note that when you choose to apply label by generating label value from attribute value, a list of options is displayed as shown in the screenshot below.

 All the labels and rules are finally listed in the Administration () > Label Management page.

---