# Etiquetas

Las etiquetas son marcas que le ponés a cada cosa que monitoreás (un servicio, un servidor, una base, una aplicación) para ordenarla: por equipo, por sede, por ambiente o por lo que necesites. Además, cada una tiene un **nivel** (T1, T2 o T3) que dice qué tan importante es.

La pantalla está en Configuración, **Etiquetas**. Ahí ves qué claves se usan, cuántas entidades tiene cada una, las reglas que etiquetan solas y los nombres de los niveles.

## Cuándo usarlas

- Querés filtrar la Topología, los Dashboards o los perfiles por "equipo: pagos" o "sede: norte".
- Querés que los servidores de producción queden marcados solos, sin ir uno por uno.
- Querés que lo más importante (por ejemplo, el sistema de turnos) se distinga de lo secundario.
- Necesitás separar servidores en grupos para que sus agentes se actualicen distinto (ver [La etiqueta reservada grupo](#la-etiqueta-reservada-grupo)).

## Cómo se arma una etiqueta

Una etiqueta puede ser **simple** (`crítico`) o **clave y valor** (`equipo: pagos`). Se puede escribir `equipo: pagos` o `equipo:pagos`.

| Parte | Reglas |
|---|---|
| Clave | Hasta 40 caracteres. Letras, números, `-`, `_` y `.`. Tiene que empezar con letra o número. Si la escribís con mayúsculas, se pasa sola a minúsculas. |
| Valor | Hasta 60 caracteres. No admite comas. Es opcional. |
| Cantidad | Hasta 30 etiquetas distintas por entidad, sumando todos los orígenes. |
| Clave `nivel` | Está reservada: el nivel se elige con el selector, no con una etiqueta. |

## De dónde vienen las etiquetas

Cada etiqueta tiene un origen, y se distingue por el color de la pastilla.

| Origen | Cómo llega | Se puede quitar a mano |
|---|---|---|
| A mano | La ponés vos desde la ficha de la entidad (Topología, Servicios o Infraestructura). Guarda quién y cuándo. | Sí |
| Por regla | La pone una regla de esta pantalla. Las reglas se revisan cada 5 minutos. | No. Se quita sola si la entidad deja de cumplir la regla; para cambiarla, editás la regla. |
| De los datos | Viene de lo que mandan tus aplicaciones: el ambiente (`deployment.environment` pasa a ser `ambiente`) y los atributos que empiezan con `lymen.etiqueta.`. | No |

Si la misma etiqueta llega por dos orígenes, se muestra una sola vez. Tiene prioridad la de regla, después la de datos y después la manual.

## Niveles T1, T2 y T3

El nivel dice cuán importante es una entidad. T1 es el más importante.

| Nivel | Nombre de fábrica |
|---|---|
| T1 | Crítico |
| T2 | Importante |
| T3 | Normal |

- Una entidad sin nivel puesto cuenta como T3.
- Si el nivel lo puso una persona, ese gana. Si no, vale el más alto que hayan puesto las reglas.
- El botón **Volver al automático** de la ficha saca el nivel manual.
- El nivel también sirve para priorizar incidentes: la severidad inicial de un incidente nuevo sale del nivel más alto de lo afectado (T1 crítica, T2 alta, T3 normal). Queda fija aunque después cambies el nivel.

## Configurarlo paso a paso

Solo los roles **admin** e **it** pueden editar. Los demás ven la pantalla en solo lectura.

### Ponerle etiquetas a una entidad

1. Abrí la ficha de la entidad (en Topología, Servicios o Infraestructura).
2. En "Etiquetas y nivel", escribí en "Agregar una etiqueta", por ejemplo `equipo: pagos`.
3. Para el nivel, elegí T1, T2 o T3 en el selector.
4. Para sacar una etiqueta, tocá la cruz de su pastilla.

### Crear una regla

1. En Etiquetas, tocá **+ Nueva regla**.
2. Poné un nombre (hasta 80 caracteres) y dejala activa o pausada.
3. Definí las condiciones. Hace falta al menos una:
   - Tipo de entidad.
   - Nombre: es, empieza con, contiene, o cumple una expresión regular.
   - Atributos: hasta 5, con un valor o solo que existan.
   - Relaciones: hasta 5, "usa" o "corre en" una entidad concreta.
4. Elegí qué pone la regla: etiquetas (hasta 10) y/o un nivel. Tiene que poner al menos una cosa.
5. Mirá la vista previa ("Se aplicaría a N entidades"). Se actualiza sola mientras escribís.
6. Guardá.

Las reglas se evalúan cada 5 minutos. Hay un máximo de 50 reglas.

### Cambiar el nombre de los niveles

1. En la tarjeta **Niveles**, escribí el nombre nuevo para T1, T2 y/o T3 (de 1 a 24 caracteres).
2. Tocá **Guardar nombres**.

El nombre nuevo se ve en todo el portal.

## Tabla de campos

| Campo | Para qué sirve | Valor por defecto | Valores válidos | Impacto de cambiarlo |
|---|---|---|---|---|
| Claves en uso | Muestra cada clave con cuántas entidades la tienen y sus valores. Es solo lectura. | - | - | Ninguno. |
| Nombre de la regla | Identifica la regla en la lista y en el tooltip de cada etiqueta. | Vacío | 1 a 80 caracteres | Ninguno sobre los datos. |
| Activa / Pausada | Prende o apaga la regla. | Activa | Activa o Pausada | Pausar la regla quita enseguida lo que había puesto. No toca lo puesto a mano. |
| Tipo de entidad | Limita la regla a ciertos tipos. | Todos | Servicio, servidor, base, cola, aplicación, chequeo, instancia, externo | Una regla más amplia etiqueta más cosas y puede mezclar entidades que no querías. Revisá la vista previa. |
| Nombre (condición) | Filtra por nombre de la entidad. | Sin condición | es, empieza con, contiene, expresión regular. Hasta 200 caracteres | Una expresión regular muy abierta etiqueta de más. Se rechazan las peligrosas (repeticiones anidadas, referencias hacia atrás). |
| Atributos (condición) | Filtra por atributos de la entidad. | Sin condición | Hasta 5. Valor de hasta 120 caracteres | Todas las condiciones tienen que cumplirse: más condiciones achican a qué se aplica. |
| Relaciones (condición) | Filtra por lo que usa la entidad o dónde corre. | Sin condición | Hasta 5 | Ídem. |
| Etiquetas que pone | Las etiquetas que la regla asigna. | Ninguna | Hasta 10 por regla. No admite `grupo` ni `nivel` | Más etiquetas ayudan a filtrar, pero ocupan lugar en el tope de 30 por entidad. |
| Nivel que pone | El nivel que asigna la regla. | Ninguno | T1, T2, T3 o ninguno | Subir una entidad a T1 sube la severidad inicial de los incidentes nuevos que la afecten. Un nivel puesto a mano gana sobre el de la regla. |
| Nivel de la entidad (ficha) | Importancia de una entidad. | T3 | T1, T2, T3 | Ídem. Con "Volver al automático" se saca el manual. |
| Etiqueta a mano (ficha) | Agrega una marca a una entidad. | Ninguna | Ver reglas de clave y valor | Una clave nueva aparece en "Claves en uso". |
| Nombre de T1, T2, T3 | Cómo se llama cada nivel en todo el portal. | Crítico, Importante, Normal | 1 a 24 caracteres | Cambia lo que ve todo el mundo. No cambia qué entidades tiene cada nivel. |
| Eliminar regla | Borra la regla. | - | - | Se quitan enseguida las etiquetas y el nivel que había puesto. Las puestas a mano no se tocan. |

## La etiqueta reservada grupo

`grupo` es una etiqueta especial. Sirve para agrupar **servidores** y decide la **política de actualización de los agentes** de esos servidores: cada grupo se actualiza según la política que tenga definida. Si un grupo no tiene política propia, hereda la general de Lymen.

Reglas de `grupo`:

- Solo se puede poner en servidores. Los equipos de red no la admiten.
- Lleva siempre un valor: el nombre del grupo (por ejemplo, `grupo: produccion`).
- Un servidor está en un solo grupo. Si le ponés otro, reemplaza al anterior.
- Se pone siempre a mano. Las reglas no la pueden poner y los datos que mandan tus aplicaciones la ignoran.
- El nombre tiene hasta 60 caracteres y no admite comas, comillas, barra invertida, `$` ni acento grave.
- Hay un máximo de 100 grupos.

Impacto: mover un servidor de grupo cambia cuándo y cómo se actualiza su agente. Un servidor crítico en el grupo equivocado puede actualizarse antes de lo que querías. Como `grupo` también es una etiqueta, se puede usar para filtrar.

## Ejemplos

- **Producción marcada sola.** Regla "Servidores de producción": tipo servidor, nombre empieza con `srv-`, pone `ambiente: producción`. Con la vista previa confirmás qué servidores entran.
- **Sistema de turnos como crítico.** En la ficha de la aplicación de turnos: nivel T1 y etiqueta `equipo: turnos`.
- **Una sede completa.** Una regla por atributo que pone `sede: norte` a todo lo que tenga ese atributo.
- **Grupos de actualización.** `grupo: piloto` en un par de servidores de prueba y `grupo: produccion` en el resto.

## Problemas comunes

| Qué pasa | Por qué | Qué hacer |
|---|---|---|
| "La clave va con letras, números, - _ o ." | Usaste espacios o símbolos. | Usá guiones o puntos. |
| "«nivel» está reservada" | Intentaste una etiqueta `nivel`. | Usá el selector de nivel. |
| El valor se rechaza | Tiene coma o más de 60 caracteres. | Sacá la coma o acortalo. |
| No puedo quitar una etiqueta | Viene de una regla o de los datos. | Editá la regla o corregí lo que mandan tus aplicaciones. |
| "Demasiadas etiquetas" | Llegaste a 30 en esa entidad. | Sacá las que no usás. |
| `grupo` rechazada | Es reservada: solo para servidores, con valor y puesta a mano. | Asignala directo al servidor. |
| La regla no se aplicó todavía | Se evalúa cada 5 minutos. | Esperá unos minutos y recargá. |

Ver también: [Almacenamiento y retención](https://lymen.app/docs/datos/almacenamiento/), [Procesamiento](https://lymen.app/docs/datos/procesamiento/).