DocsDatosEtiquetas

Etiquetas

.md

Ordená servicios, servidores y aplicaciones con etiquetas, niveles T1/T2/T3 y reglas automáticas, y usá la etiqueta reservada grupo para los servidores.

En esta página

Cuándo usarlas Cómo se arma una etiqueta De dónde vienen las etiquetas Niveles T1, T2 y T3 Configurarlo paso a paso Tabla de campos La etiqueta reservada grupo Ejemplos Problemas comunes

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).

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#

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

Crear una regla#

En Etiquetas, tocá + Nueva regla.
Poné un nombre (hasta 80 caracteres) y dejala activa o pausada.
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.
Elegí qué pone la regla: etiquetas (hasta 10) y/o un nivel. Tiene que poner al menos una cosa.
Mirá la vista previa ("Se aplicaría a N entidades"). Se actualiza sola mientras escribís.
Guardá.

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

Cambiar el nombre de los niveles#

En la tarjeta Niveles, escribí el nombre nuevo para T1, T2 y/o T3 (de 1 a 24 caracteres).
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, Procesamiento.

← AnteriorReglas de captura Siguiente →Almacenamiento y retención