Tag Definitions
the tag definitions empowers administrators to create and manage consistent, pre defined tag keys and the necessary constraints for tag values tag definitions are a powerful tool in they streamline the management of similar tag keys, eliminate duplication, save time and make your tag management more efficient by using tag definitions, you can be more productive in your tag management tasks access tag definitions access tag definitions to view and manage existing tag definitions, create new tags and maintain consistent tagging across from the main menu , go to administration → tag management → bridge tag management the tag definitions page displays, providing a centralized view of all existing tag definitions and available actions for managing them tag definitions page tag definitions page provides a centralized view of all tag definitions available in kyndryl bridge from this page, administrators can search, filter, create and import tag definitions to support consistent resource classification, governance and reporting across services the tag definitions page includes the following components search key search for a specific tag definition by tag key name filter refine the list of tag definitions based on defined criteria create definition create a new tag definition import definition import one or more tag definitions from a supported file tag definitions table provides a centralized workspace for managing tag definitions and supporting tagging governance across the table displays all available tag definitions, including tag key the unique name of the tag definition tag category the category assigned to the tag definition value type indicates the type of values allowed for the tag status shows whether the tag definition is active or inactive tag definitions categories select a category to classify the tag definition according to its functional or operational domain categories help organize tag definitions and promote consistent tagging, governance, reporting and resource management across the following categories are available \<font color="#f3f4f6"> category \</font> \<font color="#f3f4f6"> description \</font> application management refers to managing it health and ensuring business application availability, focusing on application types and their dependency on it infrastructure the performance of applications depends on the stability of components such as servers, networks and storage systems asset management encompasses the entire lifecycle of managing assets, from procurement to disposal, including financial aspects like license management and relies on inventory management automation refers to all content related to automation, regardless of the technology used this includes the success/failure of automation and opportunities for further improvement backup and resiliency refers to all content related to data backup, archival storage, redundancy and resilience digital workplace management refers to all content associated with end user device support, management, and related services like a mainframe, it has its own category as it is typically managed separately other categories will also have workplace content environment build and decommission refers to all aspects of infrastructure build out, including network, servers, operating systems and software installations it also addresses system integration in the service and systems management environment, focusing on backup and support and their effects on operational stability registering the new server updates records for traceability and readiness event management covers all content related to system monitoring and management, including events from any monitoring technology growth refers to all content associated with opportunity development and business growth for kyndryl hardware and software currency refers to tracking end of life and end of support for hardware, operating systems and software it offers kyndryl opportunities to collaborate with customers to improve their currency position, leading to better service levels and lower costs identity and access management refers to all content associated with identity and access management and their systems inventory management refers to all content related to the inventory, including both kyndryl owned and customer owned items this encompasses devices, operating systems and installed software it also includes efforts to optimize hardware and software to improve efficiency and reduce costs mainframe management refers to all content related to the mainframe, categorized by technology type due to distinct skills and management other categories, such as inventory, will also include mainframe content network management covers all content related to the network, including management and configuration performance and capacity are expected to encompass the network in their end to end perspective performance and capacity refers to all content related to performance and capacity management, regardless of technology type security and vulnerability management covers all aspects of system and environment security, focusing on adherence to best practices and compliance standards like iso and gdpr key elements include patch management and vulnerability assessments to mitigate risks and ensure compliance service maintenance refers to all content related to daily technical operations, including data availability, audit logs, command histories and certificate expiration supports day to day operations service management refers to all content related to service management, including meantime between outages, root cause analysis, critical situation management and sla management it encompasses topics related to tickets, specifically incident, problem, change and service requests, as well as use cases for viewing current situations and ticket volumes storage management refers to all content associated with storage, its management, and configuration it is expected that performance and capacity will also include storage as part of their end to end perspective sustainability refers to all content associated with sustainability, carbon footprint, and environmental concerns this category focuses on measuring and actively reducing ecological impacts transformation management refers to all content associated with kyndryl programs and projects this can include information on the progress of various aspects of the transformation managing tag definitions tag administrators can edit, use templates and delete tag definitions to edit tag definitions follow these steps from the tag definitions table, l ocate the tag definition that you want to manage click the ellipsis (⋮) in the actions column the following actions are available for the selected tag definition audit information here, you can find the owner information, creation date, last user who modified the item, and the date of the latest update history the history record is tracked only for definitions in the active state the changes tracked are only at the metadata level edit a details page opens, allowing administrators to modify it only the key name will be read only use as template administrators can clone the existing definition, except for keys categories, constraints, and scope are pre populated when this option is selected an edit page opens where you can make the corresponding updates delete administrators can delete the current definition creating tag definitions you can create definitions with all basic details (tag key, description, tag categories), constraints and scope (optional) additionally, you can customize tag categories if needed follow these steps to create tag definitions from the main menu , go to administration → tag management → bridge tag management the tag definitions page displays, click create tag definition to begin creating a new tag definition complete the required information, including the tag key, category, description and value type click the save button to go back to the previous steps and edit the tag without losing the tag creation progress basic details continue to edit the tag completing the basic details of the tag definition state define the status of the new item if you select active status, the definition will be available for all users otherwise, if a new tag key is saved in a draft state, those tag keys will not be available by default, the tag definition for a new tag key is set in draft state key this is a required field you can select a key from the drop down menu (case sensitive) or create a new one by clicking the create key + link to avoid duplicate items, the key for tag definitions must be unique; otherwise, an error message is displayed indicating the duplicate issue if a tag definition attempts to be created for a tag key that already exists without a definition, the system will display an error message the tag management allows tag keys with a minimum of 1 character and a maximum of 256 characters, including digits from 0 to 9 and special characters (!@$% (); / \\) description this is a required field add a description for the definitions that do not exceed 100 characters tag categories tag categories help organize and manage tags you can select categories from the drop down menu (operations, location, security, finance, cost center, business unit, automation and technical) or customize a category that suits your needs please note that the system does not permit duplicate tag categories in the same account after all details are added, click the next button define constraints define a value type for the tag definition by default, this is set as a string value value type this field is required only one value type can be selected per tag definition regex pattern add a regular expression (set of strings) enumerated list define a list of allowed values here string add a sequence of characters click add constraint + link based on the value type previously selected enumerated list enter the values of the list separated by a comma regex enter the string set string define the number of characters allowed min chars count by default, it sets a minimum of 3 characters max chars count by default, it sets a maximum of 100 characters special character allowed? set a list of allowed characters after all details are added, click the next button define scope (optional) scope determines the boundaries within which tags are allowed to be performed the attributes that would be used to define the scope are provider and resource type this allows you to specify the context in which the tag is applicable, making your tag management more precise and efficient by default, all option is selected, indicating provider and resource types are applicable across all providers follow these steps to define the scope define the provider scope you can select one or more supported providers (aws, azure, gcp, ibm, local, among others) from the drop down list define the resource type based on the selected provider, the resource type field shows the applicable tag definition you can choose one or more resource types once the scope is delimited, click the next button review this is the most important step of the process confirm all details added are correct for the tag definition about to be created review all tag definition details to ensure the information is accurate and complete if any changes are needed, click the corresponding step link and update the information when all details are correct, click submit a confirmation message displays “tag definition created successfully you have successfully created \[tag key name] ” to cancel the operation, click cancel a confirmation message displays “are you sure you want to cancel? you will lose your edits for this tag definition this action is permanent and cannot be undone ” click confirm to cancel the operation and discard all changes or click nevermind to return to the tag definition and continue editing importing tag definitions into these definitions imported into the system would be in an active state and immediately available to bridge applications/services tag definition import capability would be available for both account level tags and for global tags docid\ pbvnofkqugyuqjzyhor w (global control plane) the display of data remains consistent with the current tagging process after importing, users can view, edit, or delete tags follow these steps to import definitions from the page, click import definition the bulk import tag definitions window displays read the note carefully from the import ui, as it outlines the mandatory and optional attributes essential for a successful import without these, the imports will fail a csv & json template sample is provided, including all required attributes, eliminating potential errors during the process ensure the tag keys are unique drag and drop a file otherwise, you can browse a file from your device click upload if a tag category added through the import file already exists in the system as an oob tag category, the existing description will be displayed in the ui if the tag definition is imported at the account level (dcp), it is an account specific tag; if it is imported from the global plane (gcp), it is a global tag and is automatically prefixed with 'global tagname' to stay updated, monitor the toast notification currently displayed in the upper right corner of the screen a successful tag import notification indicates that your process is complete and that the new tag definitions will remain in an active state within the system if you see a partial or failed bulk import notification, recheck whether the required attributes were added correctly in the uploaded file in app notifications for tag definition the bulk import capability for tag definitions enables delivery teams to upload tag definitions in bulk eliminating the need for manual entry imported definitions are automatically activated and ready for use by bridge applications users receive in app notifications on the import outcome and can download a detailed report to review results and identify any errors this ensures efficient onboarding of tag definitions and improved visibility into the import process as the process is asynchronous, users receive updates indicating whether the import is successful indicates that all tags definition everywhere were imported successfully, including the total count of imported tags unsuccessful indicates that the import failed completely, and no tags were imported partially successful indicates that some tags were imported successfully while others failed, including counts for both tag definition import report notifications include an option to download a detailed tag definition import report the import report provides a detailed, downloadable summary of the tag import results, enabling users to quickly validate which tags were successfully imported and identify any failures the import report is available from the in app notification for all import outcomes (successful, unsuccessful, and partially successful) it contains the following columns tag key the identifier of the tag being imported tag value the value associated with the tag status indicates whether each entry was success or failed reason for failure provides an explanation for failed entries common failure reasons may include tag key already exist (in the system, duplicate tag key (duplicate key within the file) or no tag key available etc tag definition import report complements in app notifications by offering a row level view of the import outcome for better troubleshooting and auditability