# Ambientes (Prod, QA y Desarrollo)

## Para qué sirve

Un **ambiente** es el lugar donde corre algo: lo que usan tus clientes o pacientes todos los días, lo que probás antes de publicarlo o lo que tu equipo está construyendo. Lymen tiene tres, siempre los mismos:

| Ambiente | Qué es | Ejemplo en una clínica |
|---|---|---|
| **Prod** | Lo que usan de verdad tus clientes o tu gente. | El sistema de turnos que usan los pacientes y el servidor de historias clínicas. |
| **QA** | Donde se prueba antes de publicar. | Una copia del sistema de turnos donde recepción prueba la versión nueva antes de que salga. |
| **Desarrollo** | Donde se construye y se experimenta. | El servidor del equipo de sistemas donde se programa el nuevo portal de resultados. |

Todo se ve en la misma organización de Lymen, pero cada servidor, cluster, servicio y aplicación lleva su ambiente. Así, una falla en QA no se confunde con una caída en Prod, y podés mirar solo lo que te importa con un **selector** que está siempre arriba.

Lo que hace Lymen con el ambiente:

- Se **elige al instalar** (servidores, clusters, sitios y apps): es obligatorio.
- Un **selector** en la barra de arriba filtra las pantallas del portal.
- Cada fila de una lista muestra una **marca** con su ambiente.
- **Configuración › Ambientes** muestra qué hay en cada ambiente y permite cambiarlo.
- **Plan y consumo** muestra el uso de cada ambiente.
- Los **perfiles de alerta** pueden avisar solo de ciertos ambientes.
- El **bot de Telegram** y los **asistentes de IA** aceptan un ambiente en sus consultas.

Dos cosas importantes desde el principio:

- **Los ambientes no son planes separados.** Todos suman al mismo plan y al mismo límite: no hay un plan ni un límite para Prod y otro para QA. El ambiente solo reparte lo que ya usás para que lo veas por separado.
- **El ambiente es un filtro, no un permiso.** No esconde datos ni cambia quién puede ver qué: quien tiene permiso para ver servicios, los ve de todos los ambientes. Para limitar lo que ve cada persona, usá los roles (ver [Usuarios y roles](https://lymen.app/docs/operacion/usuarios-y-roles/)).

## Cuándo usarlo

- Tenés una versión de prueba de tus sistemas y no querés que sus errores se mezclen con los de producción.
- Querés que a la guardia solo le lleguen avisos de Prod, y que QA o Desarrollo avisen solo al equipo técnico.
- Querés saber cuánto de tu plan se va en cada ambiente.
- Querés mirar el Resumen o los incidentes de un solo ambiente.

## Quién puede qué

| Qué | Permiso | Roles de fábrica |
|---|---|---|
| Usar el selector de arriba y ver las marcas | Ninguno en especial: lo tiene cualquier persona que entra al portal. | Todos |
| Ver **Configuración › Ambientes** | **Etiquetas › Ver** | Administrador, IT y Auditor |
| Cambiar el ambiente de algo (asignar) | **Etiquetas › Editar** | Administrador e IT |
| Elegir el ambiente al agregar un servidor, un cluster o un sitio | El permiso de esa alta: **Agregar datos › Administrar** (servidores y clusters) o **Aplicaciones › Editar** (sitios y apps) | Administrador (servidores y clusters); Administrador e IT (sitios y apps) |
| Ver **Uso por ambiente** en Plan y consumo | **Plan y consumo › Ver** | Administrador, IT, Dirección y Auditor |

Con solo **Etiquetas › Ver**, la pantalla de Ambientes se abre en modo lectura y avisa "Podés ver los ambientes, pero no cambiarlos: te falta el permiso para editar etiquetas." Más sobre permisos en [Usuarios y roles](https://lymen.app/docs/operacion/usuarios-y-roles/).

## Cómo se elige al instalar

El ambiente se elige siempre, y **no tiene valor por defecto**: el botón de generar queda deshabilitado hasta que elijas uno de los tres (**Prod**, **QA** o **Desarrollo**). Debajo del selector, el portal te recuerda: "Así sabés qué es de producción y qué es de prueba. Todos los ambientes suman al mismo plan."

| Qué instalás | Dónde se elige | Qué pasa después |
|---|---|---|
| **Servidor** o **gateway** | Al tocar **Agregar servidor** o **Agregar gateway** en [Agregar datos](https://lymen.app/docs/instalacion/agregar-datos/). | El comando que genera el portal ya lleva `--ambiente` con tu elección. Ver [Linux](https://lymen.app/docs/instalacion/agente-linux/#opciones-del-instalador) y [Windows](https://lymen.app/docs/instalacion/agente-windows/). |
| **Cluster de Kubernetes** | Al tocar **Agregar cluster** en Agregar datos. | El portal usa ese ambiente para el cluster y para sus namespaces, workloads, pods y nodos. Ver [Kubernetes](https://lymen.app/docs/instalacion/kubernetes/). |
| **Sitio web o app móvil** | En el alta de [Aplicaciones](https://lymen.app/docs/instalacion/aplicaciones/). | El código de instalación ya trae el ambiente. |

Si tenés que repetir una instalación a mano, copiá siempre el comando completo del portal: ya incluye el ambiente. Un instalador sin ambiente termina con un error claro y no instala nada.

## El selector de arriba

En la barra superior hay un selector llamado **Ambiente**, siempre visible. Tiene cuatro opciones:

- **Todos los ambientes** (lo normal: sin filtro).
- **Prod**
- **QA**
- **Desarrollo**

Al elegir uno, las pantallas que filtra el selector (las de la tabla de abajo y sus detalles) se vuelven a cargar con lo de ese ambiente. Las demás **no se recargan**: si estabas escribiendo algo en un editor (un perfil de alerta, una regla, una automatización, Agregar datos, un tablero), no se pierde nada; cambia el selector y la dirección de la página, y listo. El selector se pinta del color del ambiente para que no te olvides de que estás mirando un recorte. Lo que elegiste se **recuerda** la próxima vez que entres, y también queda escrito en la dirección de la página (`?ambiente=qa`), así que si le pasás ese enlace a un compañero, ve lo mismo que vos.

Con un ambiente elegido, **lo que todavía no tiene ambiente no aparece**: volvé a **Todos los ambientes** o asignale uno en Configuración › Ambientes (ver más abajo).

### Qué pantallas filtra el selector

| Pantalla | Cómo se filtra |
|---|---|
| Resumen | La salud y los números cuentan solo los servicios del ambiente y los incidentes abiertos que afecten algo de ese ambiente. |
| Servicios (con el mapa y los servicios sin medir) | Solo los servicios del ambiente. |
| Topología | Solo lo del ambiente. Lo que no tiene ambiente (por ejemplo, una base de datos sin asignar) no aparece. |
| Infraestructura | Solo los servidores y clusters del ambiente; la cobertura y los totales se recalculan. |
| Kubernetes | Solo los clusters del ambiente. Una vez que abrís un cluster, ves todo lo suyo. |
| Equipos de red | Solo los equipos del ambiente. |
| Aplicaciones (y sus visitas, errores y sesiones) | Solo los sitios y apps del ambiente. |
| Incidentes | Solo los incidentes que afectan algo del ambiente. |
| Trazas | Solo las trazas de los servicios del ambiente. |
| Objetivos (SLO) | Solo los objetivos de servicios del ambiente. |
| Anomalías (señales recientes y alertas activas) | Solo lo de los servicios del ambiente. La lista de reglas se muestra completa. |

**No filtra** el [Explorar](https://lymen.app/docs/datos/explorar/), los [Dashboards](https://lymen.app/docs/datos/dashboards/) ni las pantallas de Configuración (servidores registrados, clusters conectados, sitios): las consultas y los tableros que armás vos muestran lo que pedís, y la configuración muestra todo, sin importar el selector.

Para que nadie crea que está viendo solo QA cuando no es así, en esas pantallas, si hay un ambiente elegido, el selector lo avisa con una nota corta ("Muestra todos") y un texto de ayuda: "Esta pantalla muestra todos los ambientes."

## La marca de ambiente

En las filas de **servicios, servidores, clusters, aplicaciones e incidentes**, y en el encabezado de su detalle, aparece una marca chica con el ambiente: **Prod**, **QA** o **Desarrollo**. Cuando hay un ambiente elegido en el selector, la marca no se repite en las filas (ya sabés cuál es), pero el encabezado del detalle la sigue mostrando.

Lo que todavía no tiene ambiente se muestra como **Sin ambiente**. Un incidente que afecta cosas de más de un ambiente muestra todos.

El ambiente de un incidente es el de lo que afecta **en el momento en que Lymen lo ve por primera vez**. Si ese incidente no afecta nada con ambiente, queda sin ambiente. Los incidentes que ya existían antes de que Lymen tuviera ambientes no tienen ambiente: con un ambiente elegido en el selector no aparecen.

## Configuración › Ambientes

Es la pantalla donde ves y corregís el ambiente de todo. Está en **Configuración**, en el grupo **Datos**, y también la encontrás con el buscador escribiendo "ambientes", "qa", "prod" o "desarrollo". Arriba explica en tres líneas qué es cada ambiente y recuerda que todos suman al mismo plan. Tiene tres partes.

### Qué hay en cada ambiente

Una tarjeta por ambiente (Prod, QA y Desarrollo) con cuántos **servidores, clusters, servicios y aplicaciones** tiene.

### Sin ambiente

La lista de lo que todavía no tiene ambiente, con la frase "Hay N cosas sin ambiente." Si no queda nada, la pantalla dice "Todo tiene ambiente. No queda nada por asignar." Esta lista es el punto de partida para ordenar: elegís varias cosas y las mandás a su ambiente de una sola vez.

### Todo, con su ambiente

La lista completa. Cada fila muestra el **nombre**, el **tipo** (Servidor, Cluster, Servicio, Aplicación, Equipo de red, Chequeo u Otro), su **ambiente** y **de dónde salió** ese ambiente. Podés filtrarla por **Ambiente** (incluida la opción **Sin ambiente**) y por **Tipo**. La lista muestra de a 100 filas; con **Mostrar más** ves las siguientes.

### Asignar en lote

Con el permiso **Etiquetas › Editar**:

1. Marcá las casillas de lo que querés cambiar (o **Elegir todas las que se ven**). Al lado ves cuántas elegiste.
2. En **Asignar a…**, elegí **Prod**, **QA** o **Desarrollo**. En la lista **Todo, con su ambiente** también está la opción **Sin ambiente**, para quitarle el ambiente a algo.
3. Tocá el botón **Asignar a…**.
4. Si alguna de las cosas elegidas ya tenía otro ambiente, Lymen te pide confirmar ("Asignar a QA": "2 elementos ya tienen otro ambiente y van a pasar a QA."). Tocá **Asignar**.
5. Aparece "Listo, quedó en QA." (o "Ambiente quitado.").

Se pueden asignar **hasta 200 por vez**. Lo asignado se aplica al instante en las listas y filtros del portal.

Qué se puede asignar acá: servidores, clusters, servicios, aplicaciones y equipos de red, entre otras cosas. El ambiente de una **aplicación** (sitio web o app) es el de su sitio, así que asignarla desde acá cambia el ambiente del sitio. Hay dos caminos y valen los dos: asignarla en esta pantalla, o abrir **Observar › Aplicaciones**, entrar al sitio, tocar **Configurar** y elegir otro ambiente. Una aplicación **siempre tiene ambiente**: no se le puede quitar. Si en la selección hay alguna aplicación, la opción **Sin ambiente** queda deshabilitada y la pantalla lo explica; si aun así el pedido no es válido, se muestra el motivo en pantalla. Los namespaces, workloads, pods y nodos de Kubernetes no se asignan uno por uno: siempre tienen el ambiente de su cluster.

### De dónde sale el ambiente de cada cosa

Lymen decide el ambiente de cada cosa mirando, en este orden, de dónde puede salir. Gana el primero que aplica:

| De dónde | Cómo lo muestra la lista | Qué significa |
|---|---|---|
| Alguien lo eligió | **Elegido a mano** | Lo asignaste vos o un compañero en esta pantalla. Siempre gana. |
| Se eligió al instalar | **Elegido al instalar** | El que marcaste al dar de alta el servidor, el cluster o el sitio. |
| Una regla de etiquetas | **Por una regla de etiquetas** | Una [regla de etiquetas](https://lymen.app/docs/datos/etiquetas/) pone `ambiente`. |
| Los servidores donde corre | **Por sus servidores** | Un servicio, base o proceso que no es un servidor toma el ambiente de los servidores donde corre, si todos tienen el mismo. |
| Lo que mandan los datos | **Por lo que mandan los datos** | Lo que informa la propia aplicación o el servidor. Si una aplicación informa más de un ambiente, no se le asigna ninguno. |

Dos cosas para tener en cuenta:

- **Cambiar el ambiente en el portal no cambia lo que el servidor manda.** Si pasás un servidor de Prod a QA en Configuración › Ambientes, las listas y los filtros del portal lo toman como QA, pero el agente instalado sigue marcando sus datos con el ambiente con el que se instaló. Eso se ve, por ejemplo, al armar consultas en Explorar. Para que coincidan, reinstalá el agente con el ambiente correcto.
- **Los equipos de red y los chequeos** no tienen ambiente hasta que se lo asignes.

## Lo que ya estaba instalado

Lo que conectaste antes de que existieran los ambientes sigue viéndose, no desaparece nada:

- **Servidores**: los instaladores anteriores ya marcaban "producción", así que aparecen como **Prod**. Si en realidad son de QA o de Desarrollo, reasignalos en Configuración › Ambientes.
- **Servicios**: toman el ambiente de los servidores donde corren.
- **Sitios y apps**: quedan en **Prod**. Se cambia en **Configurar** del sitio o asignándolos en Configuración › Ambientes.
- **Clusters de Kubernetes**: quedan **Sin ambiente**. Asignales uno en Configuración › Ambientes.

Si **reinstalás o actualizás** un servidor sin pasar `--ambiente`, conserva el ambiente que ya tenía. La actualización automática del agente no toca el ambiente.

## Uso por ambiente en Plan y consumo

En [Plan y consumo](https://lymen.app/docs/operacion/plan-y-consumo/#uso-por-ambiente) hay un bloque **Uso por ambiente**: una tabla con una fila por ambiente (Prod, QA y Desarrollo) y una fila **Total**, con tres columnas:

| Columna | Qué cuenta |
|---|---|
| **Recursos** | Los servidores, nodos de Kubernetes y equipos de red que ya cuentan para tu límite, repartidos por ambiente. |
| **Aplicaciones** | Los sitios y apps activos, repartidos por ambiente. |
| **Almacenamiento** | Lo que ocupan tus datos guardados, repartido por ambiente. |

- **El límite es uno solo.** El bloque lo dice: "El límite del plan es uno solo para toda la organización: todos los ambientes suman." La suma de las filas es siempre igual al total de los límites de arriba. Nada se cobra ni se frena por ambiente.
- **El almacenamiento por ambiente es aproximado.** Lymen lo reparte según cuántos datos llegaron de cada ambiente en las últimas 24 horas, y el bloque lo aclara. Hoy se puede medir por ambiente el almacenamiento de las **trazas** y de la **experiencia de usuarios**; el de los **logs, eventos y métricas** no se puede repartir y cuenta como **Sin ambiente**. Si no se pudo medir nada, la columna muestra un guion (—).
- **Sin ambiente** aparece como fila solo si tiene algo (por ejemplo, equipos de red sin asignar o el almacenamiento que no se pudo repartir). Debajo, un enlace lleva a **Asignar ambiente en Configuración › Ambientes**.
- Los usuarios, dashboards, reglas y la retención son de toda la organización: no se reparten.

## Alertas por ambiente

En un [perfil de alerta](https://lymen.app/docs/operacion/perfiles-de-alerta/), en **Qué incidentes**, el campo **Ambientes** tiene una casilla por ambiente (Prod, QA, Desarrollo). El perfil avisa solo de los incidentes que afecten algo de los ambientes marcados: entra si **alguno** de los ambientes del incidente está marcado. Sin ninguna casilla marcada, avisa de todos los ambientes, como hasta ahora.

Un incidente **sin ambiente** no entra en un perfil que tiene marcado algún ambiente. Para que no te pase sin darte cuenta, apenas marcás un ambiente el campo muestra el aviso: "Lo que no tiene ambiente no entra en este perfil. Revisá qué quedó sin ambiente en Configuración › Ambientes.", con un enlace a esa pantalla. Si querés que el perfil también cubra lo que no tiene ambiente, asignale uno ahí.

Los avisos (por email, Telegram, Slack, Teams, webhook y Jira) traen una línea con el ambiente, por ejemplo "Ambiente: QA" (o "Ambientes: Prod, QA" si afecta a varios). Las reglas de alerta en sí no cambian: no hay una regla distinta por ambiente.

## El bot de Telegram y los asistentes de IA

En el [bot de Telegram](https://lymen.app/docs/operacion/bot-de-telegram/#comandos-por-ambiente), **`/estado`**, **`/incidentes`**, **`/servicios`** e **`/infra`** aceptan el ambiente como una palabra más:

```
/incidentes qa
/servicios prod
/infra desarrollo
```

También entiende `produccion` y `dev`. Sin la palabra, muestra todos los ambientes y cada incidente, servicio o servidor dice el suyo. **`/plan`** muestra el uso por ambiente.

Los [asistentes de IA](https://lymen.app/docs/operacion/asistentes-de-ia/#filtrar-por-ambiente) pueden pedir lo de un ambiente en incidentes, servicios, servidores y el resumen del estado ("¿qué incidentes abiertos hay en QA?"), y consultar el uso por ambiente del plan.

## Límites

- **Son tres, siempre los mismos**: Prod, QA y Desarrollo. No se pueden crear ambientes propios ni cambiarles el nombre.
- **Cada cosa tiene un solo ambiente.**
- **El ambiente no aísla ni da permisos.** Es un filtro para ordenar y mirar. No hay roles por ambiente: quien ve servicios, los ve de todos.
- **No hay plan, límite ni precio por ambiente.** Todos suman a lo mismo.
- **El selector no filtra Explorar, Dashboards ni las pantallas de Configuración.**
- **Las reglas de alerta no se definen por ambiente**; el filtro está en los perfiles de alerta.
- **No se puede cambiar a distancia el ambiente que un agente ya instalado escribe en sus datos**: para eso hay que reinstalarlo con otro ambiente.
- **Se asignan hasta 200 cosas por vez** en Configuración › Ambientes.
- **El almacenamiento por ambiente es aproximado** (ver más arriba).

## Problemas comunes

| Qué pasa | Por qué | Qué hacer |
|---|---|---|
| Elegí un ambiente arriba, abrí Explorar y veo datos de todos los ambientes. | Esa pantalla no se filtra por el selector, y lo avisa junto al selector. | Filtrá dentro de la propia consulta (el campo de entorno de Explorar). |
| Elegí un ambiente arriba y una lista quedó vacía. | Lo que todavía no tiene ambiente no aparece cuando hay uno elegido. | Pasá el selector a **Todos los ambientes** o asigná ambiente en **Configuración › Ambientes**. |
| No encuentro un incidente viejo al filtrar por ambiente. | Los incidentes anteriores a los ambientes no tienen ambiente. | Miralo con **Todos los ambientes**. |
| No puedo generar el comando del servidor, el cluster o el sitio. | El ambiente es obligatorio y no viene elegido de entrada. | Elegí **Prod**, **QA** o **Desarrollo** en el formulario. |
| El instalador dice que falta el ambiente. | Corriste el comando sin `--ambiente` (o sin la variable `LYMEN_AMBIENTE`) en un servidor nuevo. | Copiá el comando completo desde **Agregar datos**. |
| No veo **Configuración › Ambientes**. | Tu rol no tiene **Etiquetas › Ver**. | Pedíselo a un administrador (ver [Usuarios y roles](https://lymen.app/docs/operacion/usuarios-y-roles/)). |
| La pantalla de Ambientes no me deja asignar. | Tenés **Etiquetas › Ver** pero no **Etiquetas › Editar**. | Pedí el permiso o que lo asigne otra persona. |
| Asigné un servidor a QA pero mis consultas en Explorar lo siguen mostrando como Prod. | El portal cambia el ambiente en sus listas y filtros, pero el agente sigue marcando sus datos con el ambiente de la instalación. | Reinstalá el agente con `--ambiente qa`. |
| Un servicio no tiene ambiente. | Corre en servidores de distintos ambientes, o su aplicación informa más de uno. | Asignale uno a mano en **Configuración › Ambientes**. |
| Un cluster conectado antes figura **Sin ambiente**. | Se conectó antes de que existieran los ambientes. | Asignale uno en **Configuración › Ambientes**. |
| Un perfil de alerta con un ambiente marcado no avisa de un incidente. | Ese incidente no tiene ambiente, o es de otro ambiente. | Mirá el ambiente del incidente y, si falta, asignale uno a lo que afecta. |
| El bot dice "No conozco ese ambiente". | Escribiste una palabra que no es ninguno de los tres. | Escribí `prod`, `qa` o `desarrollo`, por ejemplo `/incidentes qa`. |
| En Plan y consumo, el almacenamiento de un ambiente muestra un guion (—). | No se pudo medir en ese momento. | Volvé a abrir la pantalla en unos minutos. Los límites no cambian. |
| No puedo quitarle el ambiente a una aplicación. | Un sitio o app siempre tiene ambiente. | Cambiala a otro ambiente; si es solo para ordenar, elegí el que corresponda. |
| Quiero un ambiente más (por ejemplo, Staging). | La lista es fija. | Usá QA para lo que se prueba antes de publicar. |

Ver también: [Etiquetas](https://lymen.app/docs/datos/etiquetas/), [Perfiles de alerta](https://lymen.app/docs/operacion/perfiles-de-alerta/), [Plan y consumo](https://lymen.app/docs/operacion/plan-y-consumo/), [Agregar datos](https://lymen.app/docs/instalacion/agregar-datos/).
