- Versión del manual
- 1.27.0
- Se aplica a la versión Klarun
- 2026.09
- Última actualización
- 21 de octubre de 2026
Documentación
Todo lo que necesitas para implementar, configurar y usar Klarun, el sistema operativo de tu equipo de datos.
Esta documentación cubre los seis módulos (Informes, Gobernanza, Plataforma, Personas, Proyectos y FinOps), la Evaluación 360, la Vista de Negocio, la Configuración de la organización y el sistema de roles. Usa la barra lateral para ir a cualquier sección.
Qué es Klarun
Klarun es un Data Ecosystem OS: una sola plataforma que da a los líderes de datos y a sus equipos visibilidad operativa completa sobre cada capa de su organización de datos: los informes que producen, los activos que gobiernan, las personas que gestionan, la plataforma que operan y las inversiones que hacen.
Está pensado para CTOs, responsables de datos y gerentes de BI que necesitan operar a escala sin el costo de herramientas propias. En lugar de repartir el contexto entre páginas de Notion, hojas de cálculo y portales de BI desconectados, Klarun lo centraliza y se conecta a las herramientas que tu equipo ya usa (Fabric / Power BI, Databricks y Microsoft 365 Copilot) para sincronizar sus metadatos y su uso automáticamente.
Klarun sigue un modelo híbrido de carga: una parte de los datos llega automáticamente por las integraciones y otra la registra tu equipo a mano. Los dos tipos conviven en la misma interfaz y se pueden enriquecer, etiquetar y trabajar de la misma forma.
Resumen de los módulos
Klarun se organiza en seis módulos. Cada módulo cubre un área distinta de tu operación de datos.
Cómo empezar con Klarun
Sigue estos pasos al implementar Klarun por primera vez. El orden importa, porque la configuración de la organización y las integraciones habilitan datos de los que dependen los pasos siguientes.
Ve a Configuración → Organización. Completa el nombre de la organización, el sector, el tamaño de la empresa, el mes de inicio del año fiscal y la zona horaria. El año fiscal guía FinOps, la zona horaria guía las métricas de incidentes y el sector da contexto a la Evaluación 360.
Todavía en Configuración → Organización, registra el dominio de correo de la empresa. Una vez verificado, cualquier persona con un correo de ese dominio puede unirse con un enlace de invitación, sin códigos sueltos.
Ve a Configuración → Miembros y genera un enlace de invitación. Elige entre Enlace de uso múltiple (todo el equipo), Invitación por correo, Invitación por dominio o Enlace de un solo uso. Asigna roles antes o después de que se unan. Todos entran con un asiento de visor, que todo plan incluye sin límite; pasa a un asiento de equipo de datos a quien necesite roles de módulo, que es lo que cuenta tu plan.
En Configuración → Integraciones, conecta Fabric / Power BI, Databricks, Microsoft 365 Copilot y Azure Cost Management. Una vez conectados, Klarun sincroniza automáticamente informes y activos de Fabric / Power BI, activos de Databricks, licencias y uso de Copilot, y el costo mensual de Azure en FinOps. Las integraciones requieren el plan Business o superior. Para usar Klarun desde Claude, ChatGPT o Copilot, configura el conector de IA (MCP) en la misma página; consulta Conector de IA.
En Informes → Catálogo de Informes, los informes sincronizados aparecen al momento. Enriquécelos con Dominio, Subdominio, Responsable y Frecuencia. Registra a mano los informes de otras herramientas.
Antes de invitar a usuarios de negocio, oculta las áreas de trabajo sensibles (RR. HH., Finanzas, Compensación...) en Configuración → Catálogo de informes y elige quién las sigue viendo. El resto del catálogo sigue abierto a todos.
En Personas → Equipo de Datos, agrega a cada miembro de tu organización de datos. Completa los perfiles (puesto, squad, seniority, habilidades e idiomas) para habilitar los análisis de fuerza de trabajo de Operaciones de Personas.
En Personas → Incorporación, sube documentos, pega enlaces o escribe textos en cada una de las ocho secciones de incorporación. Quien llega accede a todo desde esa página, y lo que necesitan los lectores de negocio se puede publicar en las Guías de la Vista de Negocio.
En Plataforma → Arquitectura, documenta las capas de datos y los componentes de infraestructura, y abre la sección Dominios de Negocio arriba de esa página para mapear tus dominios. En Plataforma → Salud de la Plataforma, registra los incidentes en curso.
Los activos se sincronizan desde las integraciones. En Gobernanza → Contratos y Fuentes, agrega los contratos y SLAs de tus fuentes de datos.
En FinOps → Presupuesto y Plan, ingresa el presupuesto por plataforma y categoría. En FinOps → Costo Real, registra el gasto mensual real. La Inteligencia de Costos calcula entonces el presupuesto frente a lo real automáticamente.
En Proyectos → Objetivos, crea tus metas estratégicas. Vincula Resultados Clave a cada objetivo y luego crea las Iniciativas (los trabajos concretos) en el kanban de Iniciativas.
Plan Free
Klarun tiene un plan gratuito para empezar sin tarjeta de crédito. Está pensado para equipos pequeños que exploran la plataforma: los seis módulos están disponibles, con los datos cargados a mano en lugar de sincronizados desde una integración.
- 2 asientos de equipo de datos
- Asientos de visor ilimitados para la Vista de Negocio
- Módulos: Informes, Gobernanza, Plataforma, Personas, Proyectos, FinOps
Informes
El módulo Informes es el registro central de todos los informes, dashboards y productos de datos de tu organización. Da a cada interesado un único lugar para saber qué existe, quién es el responsable, con qué frecuencia se actualiza y dónde abrirlo.
Páginas: Catálogo de Informes
Los informes entran al catálogo de dos formas: sincronización automática desde la integración de Fabric / Power BI, o registro manual para cualquier otra herramienta. Databricks agrega activos a Gobernanza, no informes al catálogo.
Campos del Catálogo de Informes
Gobernanza
El módulo Gobernanza da una vista unificada de la salud de tu ecosistema de datos: todos los activos de la plataforma, cómo se usan y los contratos que rigen tus fuentes de datos.
Páginas: Centro de Observabilidad · Activos · Contratos y Fuentes
Los Activos se completan automáticamente con las integraciones de Fabric / Power BI y Databricks, sin carga manual. Reciben señales de salud (roto, huérfano, obsoleto) calculadas a partir de los metadatos de las integraciones. Como los activos vienen de las integraciones, un plan sin ellas muestra las páginas Centro de Observabilidad y Activos con una nota sobre cómo obtenerlas. Si se cambia a un plan sin integraciones, la sincronización se pausa y los activos ya sincronizados siguen disponibles para lectura.
Los Contratos y Fuentes se cargan a mano. Cada contrato representa una fuente de datos de la que depende tu organización. Completa los campos de abajo para seguir obligaciones y riesgos.
Campos del contrato
En los planes Corporate y Enterprise, la pestaña Fabric del Centro de Observabilidad muestra cuánto de cada capacidad de Fabric está en uso. Klarun lee el modelo semántico de la aplicación Microsoft Fabric Capacity Metrics cada noche, junto con la sincronización de costos de Azure: cada noche lee los últimos 14 días de segundos de CU y minutos de limitación por capacidad y día, y los 50 elementos que más CU usaron cada día, para hasta 10 capacidades (las demás esperan a la noche siguiente). Klarun conserva 90 días.
Se configura en la conexión de Azure Cost Management, con el mismo app registration: consulta Configuración de la organización → Integraciones.
La pestaña Databricks del Centro de Observabilidad muestra el uso de DBU por carga de trabajo (trabajos, pipelines, SQL warehouses, clústeres y notebooks) en los últimos 30 días, leído de system.billing a precio de lista. Estas cifras son solo informativas y nunca pasan a ser costo real en FinOps.
Los trabajos sin uso son trabajos que gastaron DBU escribiendo tablas que nada leyó en la misma ventana, según system.access.table_lineage. Las lecturas que van directo a la ruta de almacenamiento, o a través de un acceso directo o un espejo de Fabric, no aparecen ahí, así que confirma con quienes consumen la tabla antes de detener un trabajo.
Ambos necesitan un SQL warehouse en la conexión y los permisos sobre las tablas de sistema listados en Configuración de la organización → Integraciones; el panel indica el permiso que falta. El linaje de los activos viene de la misma tabla de linaje, en los últimos 90 días.
Plataforma
El módulo Plataforma es donde documentas la infraestructura sobre la que corre tu equipo de datos y sigues su salud operativa. Cubre la documentación de la arquitectura, los dominios de negocio y la salud de la plataforma.
Páginas: Arquitectura · Salud de la Plataforma
La Arquitectura es un inventario, no un diagrama. Se divide en secciones fijas, una por capa del stack, y registras cada herramienta, sistema o carga de trabajo que operas como una entrada dentro de la sección a la que pertenece.
Secciones de la arquitectura
Cada entrada registra más que el nombre de una herramienta. Los campos se agrupan para que cada carga de trabajo diga quién responde por ella, cuánto se usa, cuánto cuesta y cómo se protege.
Los Dominios de Negocio se registran en la sección Dominios de Negocio, arriba de la página Arquitectura. Marca los dominios en torno a los que se organizan tus datos o agrega los tuyos. Los dominios se usan en Informes, en los incidentes de Plataforma, en Personas y en Proyectos, y la Vista de Negocio agrupa informes, incidentes e iniciativas por ellos. Un dominio escrito en un informe que no coincide con ningún dominio registrado, ni por nombre ni por id, no se trata como tal: la Vista de Negocio lo sigue mostrando como el área del informe, pero no se le asocia ningún incidente ni iniciativa.
Los incidentes de Salud de la Plataforma se registran con título, severidad (P1 a P4), categoría (disponibilidad, rendimiento, actualidad, calidad de datos, acceso o costo), servicio afectado, descripción y estado actual: Abierto, Investigando, Monitoreando (corregido, en observación) o Resuelto. Actualiza el estado a medida que avanza el incidente; la primera salida de Abierto se registra como el momento del reconocimiento, desde el que se mide el tiempo medio de reconocimiento. El servicio afectado se elige del registro de Arquitectura en lugar de escribirse, así que renombrar una entrada conserva su historial de incidentes y dos entradas con el mismo nombre siguen siendo distintas. Elegir un servicio sugiere una severidad según su criticidad para el negocio, que puedes cambiar. Todo cambio de estado, severidad, asignado o servicio se agrega al historial del incidente, que escribe la plataforma y no se puede editar. Marcar un incidente como Resuelto exige notas de resolución y una hora de resolución que no sea anterior al inicio, porque con esos dos campos se calcula el MTTR. Un P1 o P2 exige además una categoría de causa raíz y una acción preventiva o un "no se necesita acción preventiva" explícito: son los incidentes de los que más se aprende y los que más tienden a cerrarse deprisa.
La pestaña Mapa de servicios, junto a Secciones en la página Arquitectura, dibuja tus entradas a partir del campo Depende De: cada flecha va de una dependencia a la entrada que la usa. Las entradas sin dependencias en ningún sentido no se dibujan. Alterna entre las vistas Diagrama y Tabla.
Selecciona una entrada para ver su radio de impacto: todas las entradas que dependen de ella, directamente o a través de otras. La columna de salud viene de los incidentes abiertos: un P1 o P2 muestra Caído, un P3 o P4 muestra Degradado, y las entradas que dependen de ella muestran Afectado.
Una dependencia que cerraría un ciclo se rechaza al guardar y, si aun así existe un ciclo, sus entradas llevan la etiqueta Ciclo. El mapa muestra solo lo que tu equipo registró: no se descubre nada desde tu nube.
Personas
El módulo Personas reúne la capa humana de tu organización de datos. Combina un registro del equipo, análisis de la fuerza de trabajo en Operaciones de Personas y una biblioteca de materiales de incorporación.
Páginas: Operaciones de Personas · Equipo de Datos · Incorporación
Campos del perfil en Equipo de Datos
Personas no guarda salario ni remuneración. La nómina se registra solo en FinOps, en Costo Real.
Secciones de incorporación
La página Incorporación se organiza en ocho secciones fijas. Los admins completan cada sección con documentos, enlaces o textos.
Tipos de material
Publicar en la Vista de Negocio
Un admin de Personas puede publicar cualquier elemento, de cualquier sección, en las Guías de la Vista de Negocio: usa Publicar en la Vista de Negocio en su tarjeta, o el interruptor Mostrar en la Vista de Negocio en su formulario. La publicación pide confirmación, porque todos los que abren la Vista de Negocio lo van a leer. Los lectores de negocio ven el título, la descripción y el contenido, nunca el propósito, las herramientas ni los puestos. Los elementos publicados llevan la etiqueta Publicado y aparecen en el filtro Publicados en la Vista de Negocio; Quitar de la Vista de Negocio retira uno al instante. Los admins de Personas aquí son people_admin, org_admin y org_member, cualesquiera que sean sus otros roles. Los lectores de negocio ven los elementos publicados cuando Guías se activa en Configuración → Vista de Negocio; los elementos se pueden publicar antes.
Un admin puede limitar el rol de Personas de un miembro a La propia persona y quienes le reportan, en Configuración → Miembros, junto a los roles de Personas. El miembro pasa a leer solo su propio registro en el equipo y a todos los que están por debajo en la línea de reporte, directa o indirectamente. Equipo de Datos muestra cuántos del equipo completo está viendo, y el organigrama empieza en él.
La línea parte del registro del equipo vinculado a la cuenta de Klarun del miembro. Sin registro vinculado, con dos, o cuando la línea de reporte vuelve hasta él, el miembro no ve a nadie, y la Configuración muestra un aviso junto a él. Los responsables se verifican en cada cambio, así que no se puede guardar un nuevo ciclo. El cambio se aplica en la siguiente solicitud del miembro y queda en el registro de auditoría. A quienes tienen org_admin nunca se les aplica un alcance.
Proyectos
El módulo Proyectos es el marco de OKRs (Objetivos y Resultados Clave) de Klarun. Da a los equipos de datos una forma estructurada de definir su estrategia, seguir resultados medibles y gestionar los trabajos concretos que los hacen realidad. El Portafolio da una vista general de todos los objetivos e iniciativas.
Páginas: Portafolio · Objetivos · Resultados Clave · Iniciativas
Empieza de arriba hacia abajo: crea primero los Objetivos, luego agrega Resultados Clave a cada uno y, por último, crea las Iniciativas bajo los Resultados Clave.
Un admin puede limitar el rol de Proyectos de un miembro a Solo lo que tiene a su cargo, en Configuración → Miembros, junto a los roles de Proyectos. La lectura no cambia: el miembro sigue viendo todos los objetivos, resultados clave e iniciativas, así que el Portafolio y los totales de avance quedan completos. Lo que se limita es lo que puede cambiar.
Las contribuciones de una iniciativa mueven el avance de los resultados clave que vincula. Por eso un miembro limitado no puede vincular, desvincular ni cambiar una contribución a un resultado clave que no es suyo, ni siquiera en una iniciativa suya. Esos vínculos quedan como están.
La responsabilidad viene del registro del equipo vinculado a la cuenta de Klarun del miembro, y cada cuenta se puede vincular a un solo registro. Sin registro vinculado, o con dos, el miembro no puede cambiar nada, y la Configuración muestra un aviso junto a él. El cambio se aplica en la siguiente solicitud del miembro y queda en el registro de auditoría. A quienes tienen org_admin nunca se les aplica un alcance.
FinOps
El módulo FinOps da a la dirección de datos la visibilidad financiera que necesita para gestionar el área de datos como un negocio. Cubre la planificación del presupuesto, el seguimiento del costo real y una vista de Inteligencia de Costos que compara los dos.
Páginas: Inteligencia de Costos · Presupuesto y Plan · Costo Real
Presupuesto y Plan: agrega líneas de presupuesto para cada plataforma de datos (p. ej., Databricks, Snowflake, Power BI), divididas por categoría de costo y mes. El calendario fiscal sigue Configuración → Organización → Inicio del año fiscal.
Costo Real: carga o importa el gasto mensual real de cada plataforma y categoría. En los planes Corporate y superiores, el asistente de IA puede leer facturas y nóminas subidas y convertirlas en filas mensuales estructuradas.
La Inteligencia de Costos lee el presupuesto y lo real y calcula la variación automáticamente. No hay carga aparte en esta página.
Con Azure Cost Management conectado (consulta Configuración de la organización → Integraciones), la sincronización nocturna escribe el costo facturado de Azure en lo real de Plataforma en FinOps → Costo Real: una línea sincronizada por categoría de costo y año fiscal, marcada como Sincronizado desde Azure. Las reglas de mapeo deciden en qué categoría cae cada fila de costo.
La coincidencia ignora mayúsculas y minúsculas. Gana la regla más específica y, después, la de menor prioridad. El costo que ninguna regla cubre aparece en Gasto sin mapear, de mayor a menor, y Mapear en una fila abre una regla ya completada a partir de ella. Crear, cambiar o borrar una regla reescribe las líneas sincronizadas al instante.
Las reglas pertenecen a la sección Plataforma: quienes la tienen las ven, y finops_admin las cambia. Las cifras de DBU de Databricks en Gobernanza son precio de lista, solo informativas, y nunca se escriben aquí.
Los datos de FinOps se dividen en tres secciones, cada una compartida por completo o no, además del rol de FinOps. El rol define cuánto puede hacer un miembro en FinOps; las secciones definen qué partes ve.
Sin elección, los admins de FinOps tienen todas las secciones y los demás tienen Plataforma y Proyectos, así que la nómina siempre es una concesión explícita. Quienes tienen org_admin siempre tienen todas las secciones. Un admin cambia las secciones de un miembro en Configuración → Miembros, junto a los roles de FinOps. El cambio se aplica en la siguiente solicitud del miembro y queda en el registro de auditoría.
Las cifras que suman secciones, como el presupuesto y la variación combinados en Inteligencia de Costos, solo aparecen para quien tiene Plataforma y Equipo. Abrir o eliminar un año fiscal y cambiar el inicio del año fiscal requieren todas las secciones. La Evaluación 360 muestra su sección financiera solo a quien tiene todas las secciones.
Evaluación 360
La Evaluación 360 es la revisión organizacional de Klarun hecha con IA. Reúne datos de todos tus módulos (Gobernanza, Plataforma, Personas, Proyectos y FinOps) en una evaluación periódica y única de la salud de tu organización de datos, con análisis en texto y recomendaciones.
Páginas: Vista 360°
No hay carga manual. Mantén al día los otros módulos y genera una evaluación para un período. La calidad del resultado depende de qué tan completos estén los datos de Gobernanza, Plataforma, Personas, Proyectos y FinOps.
Vista de Negocio
La Vista de Negocio es una puerta de entrada para quien está fuera del equipo de datos. Responde a cuatro preguntas: dónde está el informe que necesito, puedo confiar en él ahora, a quién pregunto y qué está cambiando que me afecta. Todo lo que muestra sale de registros que tu equipo de datos ya mantiene en Klarun, con una lista fija de campos y en lenguaje simple: sin prioridades, números de incidente, ids de plataforma ni otros términos internos.
Páginas: Inicio · Mi App · Buscar · Estado · Lo que viene · Guías
Salvo en Mi App, que es la lista de cada lector, todo lector recibe la misma respuesta: nada en estas páginas depende de quién pregunta. Abrir un informe y buscar suman uno a los conteos semanales de la empresa (informes abiertos, abiertos tras una búsqueda y búsquedas). En Mi App, un cambio que añade informes suma uno, uno que quita suma uno, y cada informe mostrado suma uno, sin importar cuántos informes cambie. No se guarda con ellos ningún lector, id, informe ni palabra buscada, y nada de lo que hace un lector de negocio cambia otros datos que su propia lista de Mi App.
Un lector añade un informe de Power BI con Añadir a Mi App en su tarjeta en Buscar, hasta 50 informes, y los ordena como quiera. Cada informe se abre dentro de Klarun en el propio marco de Power BI: el lector inicia sesión en Power BI ahí y ve solo lo que su propio acceso en Power BI permite. Klarun no guarda ningún token de Power BI. Con el Inicio de sesión de Power BI para Mi App activado en Configuración → Vista de Negocio, Añadir a Mi App primero pregunta a Power BI, con el inicio de sesión del propio lector en su navegador, si puede abrir el informe: a un lector sin acceso se le avisa en lugar de añadir el informe, y un acceso nuevo puede tardar unos minutos en aplicarse. Con la opción apagada, o cuando la comprobación no puede ejecutarse, el informe se añade sin comprobar, y Power BI lo dice al cargar un informe que el lector no puede abrir.
Mi App acepta solo informes de Power BI y de Fabric. Los informes paginados, paneles, apps e informes de otras herramientas muestran No disponible en Mi App y siguen abriéndose en su herramienta. El marco necesita la opción Embed content in apps permitida en su inquilino de Power BI; sin ella, el marco queda en blanco y Abrir en Power BI sigue funcionando. La dirección del marco lleva los ids del informe en Power BI, que quien ya ve el informe en Buscar puede leer en las herramientas de desarrollo del navegador. Nadie más ve la lista de un lector, ni el equipo de datos, y se borra cuando el lector deja la empresa.
Cada informe en Buscar lleva como máximo una insignia: la primera de estas que aplique. Sin señal no hay insignia, y nunca la afirmación de que todo está bien.
Las insignias de incidente solo aparecen mientras Estado está activado. Los respaldos comparten una fila en la tarjeta: Certificado en verde (la insignia 4, así que solo mientras no aparece ninguna insignia de problema), Promocionado en azul y Basado en datos maestros en dorado, cuando el modelo semántico del informe tiene el respaldo Datos maestros en Fabric. Solo los elementos de datos pueden ser datos maestros, nunca un informe.
Mientras una iniciativa publicada de tipo Migración de Reportes, Migración Técnica o Migración de Datos está en curso o planificada, cada informe de su área avisa que algunos informes allí se están moviendo, con el mes previsto de finalización, y lleva a la iniciativa. El aviso habla del área, nunca del informe, y solo aparece mientras Lo que viene está activado. Las insignias y avisos de área requieren un Dominio de Negocio: un área que no lo es no recibe ninguno de los dos.
Todo se define en Configuración → Vista de Negocio. Quienes tienen org_admin u org_member la gestionan, y solo ellos abren la Configuración. Cada cambio se aplica a todos al instante y queda registrado como admin.business_view_changed, con lo que cambió, pero nunca el contacto.
En Proyectos → Iniciativas, usa Publicar en la Vista de Negocio en la fila de una iniciativa, o el interruptor Mostrar en la Vista de Negocio en su formulario. Quien puede editar una iniciativa puede publicarla, así que un miembro limitado a lo que tiene a su cargo solo publica las suyas. La publicación pide confirmación, porque un título que los lectores de negocio ya vieron no se puede deshacer. Las iniciativas publicadas llevan la etiqueta Publicada, y el filtro Publicadas en la Vista de Negocio las lista. El trabajo entregado sale de Lo que viene 90 días después de su fecha de fin.
En Personas → Incorporación, un admin de Personas publica los elementos uno por uno, en cualquiera de las ocho secciones, con Publicar en la Vista de Negocio o el interruptor Mostrar en la Vista de Negocio. Funciona como las iniciativas: quien gestiona la Configuración activa o desactiva Guías para toda la empresa (empieza desactivado), y los admins de Personas eligen qué entra. La publicación pide confirmación, la etiqueta Publicado marca lo que ven los lectores de negocio, y Quitar de la Vista de Negocio retira un elemento al instante. Guías muestra solo las secciones que tienen un elemento publicado, y una página vacía mientras no haya nada publicado. Consulta Personas.
El área de un informe es el Dominio de Negocio de Plataforma → Arquitectura cuando su dominio coincide con uno, por id o por nombre, sin distinguir mayúsculas ni espacios. Si no, es el propio valor de dominio del informe, porque los dominios de Fabric no tienen que coincidir con los registrados en Klarun; las grafías que solo difieren en mayúsculas o espacios son una sola área. Los incidentes y las iniciativas solo se asocian a Dominios de Negocio, así que un área que no lo es no recibe insignia de incidente del área ni aviso de migración. Un dominio vacío o que parece un id no muestra área.
Configuración de la organización
La Configuración está en la barra lateral, bajo el nombre de tu organización. La página tiene cinco pestañas: Organización, Integraciones, Miembros, Vista de Negocio y Facturación. Quien tiene el rol org_admin puede cambiar toda la configuración. El rol org_member puede gestionar las pestañas Organización, Integraciones, Miembros y Vista de Negocio, pero no Facturación, y no puede conceder el rol de admin.
Pestaña Organización
Configura el perfil de la organización. Estos valores aparecen en toda la app: el año fiscal guía FinOps, la zona horaria guía las métricas de incidentes y el sector da contexto a la Evaluación 360.
Verificación de dominio
Registra el dominio de correo de la empresa para habilitar las invitaciones por dominio. Cualquier persona con un correo de ese dominio puede entonces unirse a tu espacio de trabajo con un enlace de invitación de dominio, sin necesitar un código suelto.
La verificación se hace con un código de un solo uso enviado a un correo de admin del dominio registrado. Una vez verificado, el dominio queda fijo y se usa en todas las invitaciones de dominio futuras.
Pestaña Integraciones
Conecta tus herramientas de BI a Klarun. Las integraciones sincronizadas completan automáticamente los Informes (módulo Informes), los Activos (módulo Gobernanza) y el Centro de Observabilidad. Quienes tienen org_admin u org_member las conectan, sincronizan y desconectan; los roles de módulo, reporting_admin incluido, no. Conectar y sincronizar requieren el plan Business o superior. Desconectar funciona en cualquier plan: al cambiar a un plan sin integraciones, la sincronización se pausa y lo sincronizado sigue disponible para lectura.
Pasos para configurar Power BI
Ve a Azure Portal → Microsoft Entra ID → Registros de aplicaciones → Nuevo registro. Ponle cualquier nombre (p. ej., "Klarun Integration"), elige Inquilino único y haz clic en Registrar. Usa un registro dedicado: no reutilices el que está conectado a Microsoft 365 Copilot.
Deja vacíos los permisos de API. No agregues Tenant.Read.All y no concedas consentimiento de administrador. Power BI rechaza una entidad de servicio que tenga permisos de Power BI con consentimiento de administrador en Entra, y la llamada falla con un 401 que parece un problema de credenciales. El acceso se concede en el portal de administración de Power BI, en los pasos 03 y 04.
Abre el Portal de administración de Power BI → Configuración del inquilino → Configuración para desarrolladores. Habilita "Service principals can call Fabric public APIs". Esto cubre el listado de workspaces e informes. Si lo limitas a un grupo de seguridad, agrega la entidad de servicio a ese grupo. El portal puede mostrar los nombres de las opciones en inglés.
Power BI Admin Portal → Tenant settings → Developer settings → Service principals can call Fabric public APIsEn el mismo portal, abre Configuración del inquilino → Configuración de la API de administración y habilita "Service principals can access read-only admin APIs". Es un interruptor distinto del paso 03 y cubre metadatos, linaje y uso de todo el inquilino. Limítalo a un grupo al que pertenezca la entidad de servicio y espera unos 15 minutos a que las dos opciones surtan efecto.
Power BI Admin Portal → Tenant settings → Admin API settings → Service principals can access read-only admin APIsDe vuelta en el registro de la aplicación → Certificados y secretos → Nuevo secreto de cliente. Define una expiración, haz clic en Agregar y copia enseguida la columna Valor. No copies el ID del secreto, que está al lado y no es una credencial. El Valor se muestra una sola vez.
Ve a Configuración → Integraciones → Power BI → Conectar. Ingresa el ID de inquilino, el ID de aplicación (cliente) y el valor del Secreto de cliente. Haz clic en Probar conexión y, si funciona, en Guardar y sincronizar.
Databricks
Conecta uno o más espacios de trabajo de Databricks con la URL del espacio de trabajo y una entidad de servicio o un token de acceso personal y, opcionalmente, un SQL warehouse. Una vez conectado, Klarun sincroniza catálogos, esquemas, tablas y vistas, clústeres, SQL warehouses, trabajos, pipelines y notebooks como activos de Gobernanza. El uso y la actividad vienen del registro de auditoría del espacio de trabajo (la tabla de sistema system.access.audit), que Klarun solo puede consultar a través de un SQL warehouse: si eliges uno, también se sincroniza el uso; sin él, se sincronizan los activos y el uso no.
El uso de DBU, los trabajos sin uso y el linaje leen tablas de sistema de Unity Catalog a través del mismo SQL warehouse, filtradas por el espacio de trabajo. Concede a la entidad de servicio USE CATALOG sobre el catálogo system, y USE SCHEMA y SELECT sobre system.billing (uso y precios de lista) y system.access (auditoría y linaje de tablas). USE SCHEMA y SELECT sobre system.lakeflow son opcionales y añaden los fallos de ejecución de trabajos a las sugerencias de Salud. Esto requiere un espacio de trabajo con Unity Catalog y una URL del espacio de trabajo con el formato adb-NNNN, que lleva el id del espacio de trabajo; si no, estas lecturas se omiten.
Microsoft 365 Copilot
Usa un registro de aplicación de Entra dedicado, no el conectado a Power BI: los permisos de Graph con consentimiento de administrador de Copilot impedirían que un registro compartido llegue a las API de administración de solo lectura de Power BI. En el registro, en Permisos de API, agrega los permisos de aplicación de Microsoft Graph Reports.Read.All y Organization.Read.All y concede el consentimiento de administrador. La Configuración puede copiar el ID de inquilino desde tu conexión de Power BI.
Klarun lee la cantidad de licencias y los informes de uso de Copilot de todo el inquilino. Reports.Read.All cubre todos los informes de uso de Microsoft 365, porque Microsoft no ofrece un alcance solo para Copilot. Microsoft publica el uso con 48 a 72 horas de retraso, así que las primeras cifras aparecen unos días después de conectar.
Pasos de configuración de Azure Cost Management
Ve a Azure Portal → Microsoft Entra ID → App registrations → New registration. Dale un nombre (p. ej., "Klarun Cost"), selecciona Single tenant y haz clic en Register. Mantenlo separado de los registros de Power BI y Copilot. No necesita ningún permiso de API.
En cada suscripción que Klarun deba leer, abre Access control (IAM) → Add role assignment, elige Cost Management Reader y asígnalo a la aplicación. El rol es de solo lectura: muestra datos de costo y no da acceso a los recursos en sí. Una asignación nueva puede tardar unos minutos en aplicarse.
Subscription → Access control (IAM) → Add role assignment → Cost Management ReaderEn el app registration → Certificates & secrets → New client secret. Define una caducidad, copia el Value (no el Secret ID) de inmediato y anota la fecha de caducidad: la necesitarás en el paso 06.
Ve a Configuración → Integraciones → Azure Cost Management → Conectar. Ingresa el ID de inquilino (un GUID; common y organizations se rechazan), el ID de aplicación (cliente) y el valor del Secreto de cliente. Probar conexión lista las suscripciones que la aplicación puede leer.
Las suscripciones activas vienen marcadas. Conserva hasta 50 y haz clic en Guardar; una suscripción que la aplicación no puede leer se rechaza. El costo se lee cada noche, por mes, grupo de recursos y servicio. Azure publica el costo con 8 a 24 horas de retraso, así que los días más recientes se completan en las sincronizaciones siguientes.
Klarun no sigue la fecha de caducidad. Antes de ella, crea un secreto nuevo en el mismo registro, luego vuelve a Conectar, prueba y guarda: guardar reemplaza la conexión almacenada. Después, borra el secreto antiguo en Azure. Si el secreto caduca antes, la sincronización nocturna falla, la conexión muestra el error y el costo ya sincronizado se mantiene.
Pestaña Miembros
Gestiona quién forma parte de tu espacio de trabajo de Klarun. Ves a todos los miembros actuales, cambias sus roles y creas códigos de invitación.
Tipos de asiento
Cada miembro ocupa un asiento de visor o un asiento de equipo de datos. Todos los que se unen, por código de invitación o por dominio, empiezan en un asiento de visor, que tiene solo el rol business_viewer y abre la Vista de Negocio. Los asientos de visor son ilimitados en todos los planes. Un asiento de equipo de datos tiene roles de módulo, y los asientos de equipo de datos son lo que dimensiona un plan: 2 en Free, 15 en Business, 30 en Corporate e ilimitados en Enterprise. El encabezado de Miembros muestra cuántos están en uso. Cuando están todos, un miembro con asiento de visor no puede pasar a un asiento de equipo de datos hasta que alguien vuelva a un asiento de visor o cambie el plan. Recuperar el acceso de admin por DNS siempre funciona, aunque el plan esté completo, porque es la forma en que una organización sin admin vuelve a tener uno.
Tipos de código de invitación
Pestaña Vista de Negocio
Elige qué páginas de la Vista de Negocio están activadas, Guías incluida, y adónde llevan sus preguntas los lectores de negocio. Lo que muestra Guías se publica elemento por elemento en Personas → Incorporación. La pestaña también muestra qué tan completa está la Vista de Negocio, cómo se usa y una vista previa, un panel debajo de otro. Consulta Vista de Negocio.
Pestaña Facturación
Ve tu plan actual y gestiona la suscripción. Subir o bajar de plan y cargar los datos de pago se hacen desde esta pestaña. Solo quien tiene el rol org_admin accede a la pestaña Facturación.
Notificaciones
La campana del encabezado muestra lo que necesita tu atención, en todos los asientos. El contador se actualiza aproximadamente una vez por minuto mientras Klarun está abierto en una pestaña visible. Abre una notificación para ir directo al elemento; si el elemento ya no existe, la página indica que ya no está disponible. Una solicitud de acceso se puede aprobar o descartar desde la propia notificación. Mi Cuenta → Notificaciones lista todas las notificaciones, con filtros, selección, marcar como leída y eliminar. Una notificación eliminada se puede restaurar durante 10 segundos.
Sobre qué se te notifica
Cada notificación llega solo a quienes pueden actuar sobre ella o leer el elemento, y la lista lo vuelve a comprobar cada vez que se carga: un miembro que pierde el acceso a un elemento deja de ver su notificación. Nadie recibe notificaciones de sus propias acciones, como un incidente que abrió.
Cuánto tiempo se mantienen
Una notificación se mantiene 3 días después de la última vez que apareció, leída o no. Una acción pendiente (una solicitud de acceso, un incidente asignado a ti, una revisión del catálogo pendiente) se mantiene hasta que alguien la atiende, y luego 3 días más. Una repetición del mismo evento actualiza la notificación existente en lugar de añadir otra.
Correo
Los miembros con asiento de equipo de datos también pueden recibir notificaciones por correo, elegidas por categoría en Mi Cuenta → Notificaciones. Cada correo incluye el título de la notificación y un enlace al elemento. Los asientos de visor nunca reciben correo.
La misma página permite ocultar alertas y novedades de la campana. Los incidentes críticos siempre aparecen, y las acciones pendientes y los avisos del sistema no se pueden ocultar. La revisión del catálogo mantiene su propio correo diario de recordatorio, descrito en Elementos ocultos del catálogo.
Un admin de la organización puede activar Enviar los incidentes críticos por correo a todo el equipo de datos en Configuración → Organización. Así, los incidentes P1 y P2 llegan por correo a todos los miembros del equipo de datos que los reciben, incluso a quienes desactivaron los correos de alerta u ocultaron el tipo.
Conector de IA
El conector de IA permite que Claude, ChatGPT, Microsoft Copilot y otros asistentes compatibles con el Model Context Protocol (MCP) lean Klarun y, cuando tu empresa lo permite, añadan y actualicen elementos en él. Cada persona se conecta con su propia cuenta de Klarun, y el asistente ve solo lo que permiten los roles de esa persona. La URL del conector está en Configuración → Integraciones → Conector de IA (MCP). El conector está disponible en todos los planes de pago; en el plan Free, un org admin aún puede desactivarlo y revocar clientes, y los miembros aún pueden desconectar sus apps.
Acceso de la empresa
Un org admin elige qué pueden hacer los asistentes en toda la empresa, en Acceso de la empresa, en el mismo panel. Empieza en Solo lectura.
Conecta un asistente
Cada persona añade Klarun en su asistente con la URL del conector, inicia sesión en Klarun y aprueba el acceso que pide el asistente. Claude y ChatGPT no necesitan configuración en Klarun.
Qué añaden los asistentes
Un informe que añade un asistente entra como Revisión Pendiente, para que un admin de informes lo revise antes de que cuente. Todo lo que un asistente añade o edita muestra una etiqueta Añadido vía o Editado vía (Claude, ChatGPT o Copilot) en el Catálogo de Informes, en Presupuesto y Plan y en Costo Real, y el Catálogo de Informes puede filtrar por quién añadió un informe. Los campos que llena una sincronización, como los detalles de un informe sincronizado o las líneas de la sincronización de costos de Azure, no se sobrescriben. Un asistente envía como máximo 50 elementos por llamada, y enviar el mismo elemento de nuevo no crea un duplicado.
Desconecta y revisa
Cualquiera puede desconectar sus propios asistentes en Mi Cuenta → Apps de IA conectadas. Un org admin ve todas las conexiones en Conexiones, en el panel del conector de IA, y puede revocar cualquiera de ellas, o revocar un cliente OAuth y todas las conexiones hechas con él. Descargar actividad del conector de IA (CSV) lista cada herramienta que llamó un asistente, quién y con qué cliente, con el número de elementos; lo que se preguntó nunca se registra. Cambiar el Acceso de la empresa a Desactivado desconecta a todos a la vez.
Roles
Klarun usa un sistema de roles en capas. Cada miembro tiene un rol de la organización, que controla el acceso básico en todo el espacio de trabajo, más roles de módulo opcionales, que dan permisos mayores dentro de módulos concretos.
Roles de la organización
Se asignan a nivel del espacio de trabajo. Valen para todos los módulos, salvo que un rol de módulo los reemplace.
Roles de módulo
Cada módulo tiene tres niveles: admin, colaborador y visor. Los roles de módulo se suman: asignar un rol de módulo a un miembro le da ese nivel de permiso en ese módulo, sea cual sea su rol de la organización.
Matriz de permisos
Permisos básicos por nivel de rol, válidos en todos los módulos. Los admins de módulo tienen los mismos privilegios que los admins de la organización dentro de su módulo. Excepción: en Personas y FinOps, crear, editar y eliminar registros requiere el nivel admin, y FinOps además se divide en secciones (consulta Secciones de FinOps). En Proyectos, un admin puede limitar a un miembro a cambiar solo lo que tiene a su cargo (consulta Cambiar solo lo que tiene a su cargo), y en Personas a la propia persona y quienes le reportan (consulta La propia persona y quienes le reportan). Cualquiera cuya cuenta de Klarun esté vinculada a un registro del equipo puede editar sus propias habilidades e idiomas. Las cuatro últimas filas son configuración de la organización: corresponden solo a org_admin y org_member, nunca a un admin de módulo.
Alcances de acceso a datos
Los roles deciden qué puede hacer un miembro en cada módulo. Los alcances de acceso a datos limitan a qué registros de ese módulo llega. Un alcance solo limita un rol: nunca concede un acceso que el rol no da, y a quienes tienen org_admin nunca se les aplica un alcance. Los alcances son de cada miembro, los define un admin en Configuración → Miembros junto a los roles que limitan, y se aplican en el servidor en cada solicitud, tanto en las páginas como en la API. Los elementos del Catálogo de Informes se limitan por elemento, no por miembro: consulta Elementos ocultos del catálogo.
Los tres alcances
Cada alcance se describe por completo junto a su módulo: consulta Secciones de FinOps, Cambiar solo lo que tiene a su cargo y La propia persona y quienes le reportan.
Cuando no se puede calcular un alcance
Los alcances de Proyectos y Personas parten del registro del equipo vinculado a la cuenta de Klarun del miembro. Cada cuenta se puede vincular a un solo registro, y un admin solo puede vincular un registro a su propia cuenta cuando el correo del registro es el suyo. Cuando falta el vínculo o está duplicado, o cuando la línea de reporte vuelve hasta el miembro, el alcance no da nada en lugar de adivinar: en Proyectos el miembro no puede cambiar nada, y en Personas no ve a nadie. La Configuración muestra un aviso junto al miembro para que un admin corrija el registro. Los responsables se verifican en cada cambio, así que no se puede guardar un nuevo ciclo. Un alcance guardado que no se puede leer se trata como la opción limitada.
En todos los lugares donde aparecen los datos
Un alcance sigue a los datos, no a la página, así que las mismas reglas valen dondequiera que se muestren esos datos.
Auditoría
Cada cambio de alcance queda registrado como admin.scope_changed, con el miembro, el admin y el nuevo valor de cada módulo que tocó. Cada cambio en la cuenta a la que está vinculado un registro del equipo queda registrado como people.link_changed, y los cambios de rol siguen siendo admin.role_changed. Un cambio de alcance se aplica en la siguiente solicitud del miembro sin cerrar su sesión; un cambio de rol cierra todas sus sesiones, así que se aplica al instante.
Estos eventos quedan en el registro de auditoría de la organización, que registra los inicios y cierres de sesión y los inicios de sesión fallidos, además de los cambios de seguridad y de administración: roles, alcances de acceso a datos, miembros eliminados, sesiones cerradas, integraciones conectadas, desconectadas y sincronizadas, cambios en contratos, la configuración de la Vista de Negocio, el modelo de asientos de Copilot y las exportaciones del uso de Copilot por usuario, el conector de IA (el nivel de acceso, los clientes registrados y las conexiones hechas o revocadas), miembros del equipo que editan o vinculan su propio registro, y decisiones sobre iniciativas propuestas (ROI): aprobaciones, aplazamientos, rechazos y rebases, sin el importe ni la justificación. Registra esos eventos, no todos los cambios de todos los registros. Quienes tienen org_admin u org_member, que gestionan la Configuración, pueden descargarlo en CSV desde Configuración. Cada herramienta que llama un asistente de IA a través del conector también se registra, nunca lo que se preguntó, y se descarga aparte en el panel del conector de IA en Configuración, Integraciones.
Elementos ocultos del catálogo
El Catálogo de Informes está abierto a todos en tu organización de forma predeterminada. Un admin de la organización o un admin de informes puede ocultar un área de trabajo de Power BI o un solo informe en Configuración → Catálogo de informes, o desde el menú de la fila en el catálogo, y elegir a las personas que lo siguen viendo. Los admins siempre ven todo. Ocultar es un ajuste de Klarun: no lee ni cambia permisos en Power BI ni en Microsoft Fabric.
Cómo funciona
Dónde se aplica
Un elemento oculto queda fuera de todas las listas, búsquedas, recuentos, rankings de uso y exportaciones para quienes no están en su lista: el Catálogo de Informes, la Business View, los activos, la salud, la actividad y los responsables en Gobernanza, la exportación CSV de activos y los activos de un perfil en Personas. Abrir su enlace directo da la misma respuesta que un elemento que no existe. En el linaje aparece como Elemento no disponible, sin nombre, área de trabajo ni responsable. Quienes están en la lista ven una insignia con candado que muestra quién más lo ve. Las tareas que se ejecutan sin una persona conectada, como la Evaluación 360 y las sugerencias de incidentes, dejan fuera todo elemento con regla. Si las reglas no se pueden leer, Klarun oculta a todos, salvo a los admins, cada elemento con regla en lugar de mostrarlo.
Mantener las listas al día
Cuando un miembro sale de la organización, o su registro en Personas se marca como inactivo o se quita, sale de todas las listas al momento. Cada 90 días cada lista debe revisarse: Configuración la marca, un admin la confirma con un clic, y los admins de la organización y de informes reciben un correo diario con el número de listas pendientes y un enlace, nunca los nombres de los elementos. Cada regla guarda su historial completo de cambios, que los admins pueden ver en Configuración o descargar en CSV.
Edición implementada en el cliente
En la edición implementada en el cliente, Klarun se ejecuta en tu propia suscripción de Azure, como una instalación para tu organización. Tus datos, registros y copias de seguridad quedan en tu tenant y en tu región, y la instalación no envía nada a Klarun: ni telemetría ni heartbeat. Klarun y tu equipo de infraestructura la instalan y actualizan juntos, siguiendo los runbooks de instalación y actualización enviados con cada versión. Esta sección es para el administrador de Klarun y para tu equipo de Azure.
Qué cambia
Requisitos previos
Versiones y actualizaciones
Las versiones se nombran por fecha (CalVer, AAAA.M.PATCH, por ejemplo 2026.10.0). Tu dirección seguida de /api/healthz muestra la versión en ejecución, y el bloque de versión al inicio de este manual muestra la versión que describe. Cada versión llega con notas en inglés, portugués y español: el digest de la imagen, los cambios en la base de datos, si la reversión es segura y qué cambió. Las actualizaciones se hacen una versión a la vez, toman unos 30 minutos y aplican los cambios de la base antes de que la nueva versión reciba tráfico. Klarun da soporte a la versión actual y a las dos anteriores (N-2).
Reversión y restauración
Si una nueva versión falla, tu equipo vuelve a la versión anterior por el digest de su imagen. Los cambios de la base solo agregan, así que una reversión no necesita restauración. Azure guarda 35 días de puntos de restauración de la base en tu región. Una restauración va a un servidor nuevo y luego la instalación se vuelve a implementar sobre él, así que la base en uso nunca se sobrescribe. Haz una prueba de restauración tras la instalación y una vez al año.
Soporte
Tu equipo de infraestructura es la primera línea. Cuando algo falla, ejecuta el script del paquete de soporte, que lee versiones, estado, historial de jobs y registros recientes con acceso de solo lectura, y reemplaza tokens, claves, direcciones de correo y direcciones IP. Nunca lee secretos, configuraciones ni filas de la base. Tu equipo revisa el archivo y lo envía por el canal de soporte del contrato.