- Versão do manual
- 1.27.0
- Aplica-se à versão Klarun
- 2026.09
- Última atualização
- 21 de outubro de 2026
Documentação
Tudo o que você precisa para implantar, configurar e usar o Klarun, o sistema operacional da sua equipe de dados.
Esta documentação cobre os seis módulos (Relatórios, Governança, Plataforma, Pessoas, Projetos e FinOps), a Avaliação 360, a Visão de Negócio, as Configurações da organização e o sistema de funções. Use a barra lateral para ir a qualquer seção.
O que é o Klarun
O Klarun é um Data Ecosystem OS: uma única plataforma que dá aos líderes de dados e às suas equipes visibilidade operacional completa de cada camada da organização de dados: os relatórios que produzem, os ativos que governam, as pessoas que gerenciam, a plataforma que operam e os investimentos que fazem.
Foi pensado para CTOs, heads de dados e gerentes de BI que precisam operar em escala sem o custo de ferramentas próprias. Em vez de espalhar o contexto por páginas do Notion, planilhas e portais de BI desconectados, o Klarun o centraliza e se conecta às ferramentas que a sua equipe já usa (Fabric / Power BI, Databricks e Microsoft 365 Copilot) para sincronizar metadados e uso automaticamente.
O Klarun segue um modelo híbrido de entrada: parte dos dados chega automaticamente pelas integrações, e parte é registrada manualmente pela sua equipe. Os dois tipos vivem na mesma interface e podem ser enriquecidos, marcados e trabalhados da mesma forma.
Resumo dos módulos
O Klarun se organiza em seis módulos. Cada módulo cobre uma área distinta da sua operação de dados.
Começando com o Klarun
Siga estes passos ao implantar o Klarun pela primeira vez. A ordem importa, porque as configurações da organização e as integrações liberam dados de que os passos seguintes dependem.
Vá em Configurações → Organização. Preencha o nome da organização, o setor, o tamanho da empresa, o mês de início do ano fiscal e o fuso horário. O ano fiscal orienta o FinOps, o fuso horário orienta as métricas de incidentes, e o setor dá contexto à Avaliação 360.
Ainda em Configurações → Organização, registre o domínio de e-mail da empresa. Depois de verificado, qualquer pessoa com um e-mail desse domínio pode entrar por um link de convite, sem códigos avulsos.
Vá em Configurações → Membros e gere um link de convite. Escolha entre Link de uso múltiplo (a equipe toda), Convite por e-mail, Convite por domínio ou Link de uso único. Atribua funções antes ou depois de as pessoas entrarem. Todos entram em um assento de visualizador, que todo plano inclui sem limite; mova quem precisa de funções de módulo para um assento de equipe de dados, que é o que o seu plano conta.
Em Configurações → Integrações, conecte Fabric / Power BI, Databricks, Microsoft 365 Copilot e Azure Cost Management. Depois de conectados, o Klarun sincroniza automaticamente relatórios e ativos do Fabric / Power BI, ativos do Databricks, licenças e uso do Copilot, e o custo mensal do Azure no FinOps. As integrações exigem o plano Business ou superior. Para usar o Klarun pelo Claude, pelo ChatGPT ou pelo Copilot, configure o conector de IA (MCP) na mesma página; veja Conector de IA.
Em Relatórios → Catálogo de Relatórios, os relatórios sincronizados aparecem na hora. Enriqueça-os com Domínio, Subdomínio, Responsável e Frequência. Registre manualmente os relatórios de outras ferramentas.
Antes de convidar usuários de negócio, oculte workspaces sensíveis (RH, Finanças, Remuneração...) em Configurações → Catálogo de relatórios e escolha quem continua vendo cada um. O resto do catálogo continua aberto a todos.
Em Pessoas → Equipe de Dados, adicione cada membro da sua organização de dados. Complete os perfis (cargo, squad, senioridade, habilidades e idiomas) para liberar as análises de força de trabalho de Operações de Pessoas.
Em Pessoas → Integração, envie documentos, cole links ou escreva textos em cada uma das oito seções de onboarding. Quem chega acessa tudo por essa página, e os itens de que os leitores de negócio precisam podem ser publicados nos Guias da Visão de Negócio.
Em Plataforma → Arquitetura, documente as camadas de dados e os componentes de infraestrutura, e abra a seção Domínios de Negócio no topo dessa página para mapear seus domínios. Em Plataforma → Saúde da Plataforma, registre os incidentes em andamento.
Os ativos são sincronizados pelas integrações. Em Governança → Contratos e Fontes, adicione os contratos e os SLAs das suas fontes de dados.
Em FinOps → Orçamento e Plano, informe o orçamento por plataforma e categoria. Em FinOps → Custo Real, registre o gasto mensal real. A Inteligência de Custos então calcula orçamento vs. realizado automaticamente.
Em Projetos → Objetivos, crie suas metas estratégicas. Vincule Resultados-Chave a cada objetivo e depois crie as Iniciativas (os itens concretos de trabalho) no kanban de Iniciativas.
Plano Free
O Klarun tem um plano gratuito para você começar sem cartão de crédito. Ele é pensado para equipes pequenas explorando a plataforma: os seis módulos estão disponíveis, com os dados lançados manualmente em vez de sincronizados por uma integração.
- 2 assentos de equipe de dados
- Assentos de visualizador ilimitados para a Visão de Negócio
- Módulos: Relatórios, Governança, Plataforma, Pessoas, Projetos, FinOps
Relatórios
O módulo Relatórios é o registro central de todos os relatórios, dashboards e produtos de dados da sua organização. Ele dá a cada pessoa interessada um único lugar para descobrir o que existe, quem é o responsável, com que frequência é atualizado e onde abrir.
Páginas: Catálogo de Relatórios
Os relatórios entram no catálogo de duas formas: sincronização automática pela integração do Fabric / Power BI, ou registro manual para qualquer outra ferramenta. O Databricks adiciona ativos à Governança, não relatórios ao catálogo.
Campos do Catálogo de Relatórios
Governança
O módulo Governança dá uma visão unificada da saúde do seu ecossistema de dados: todos os ativos da plataforma, como são usados e os contratos que regem as suas fontes de dados.
Páginas: Hub de Observabilidade · Ativos · Contratos e Fontes
Os Ativos são preenchidos automaticamente pelas integrações do Fabric / Power BI e do Databricks, sem lançamento manual. Eles recebem sinais de saúde (quebrado, órfão, desatualizado) calculados a partir dos metadados das integrações. Como os ativos vêm das integrações, um plano sem elas mostra as páginas Hub de Observabilidade e Ativos com uma nota sobre como obtê-las. Depois de um downgrade, a sincronização pausa e os ativos já sincronizados continuam disponíveis para leitura.
Os Contratos e Fontes são lançados manualmente. Cada contrato representa uma fonte de dados da qual a sua organização depende. Preencha os campos abaixo para acompanhar obrigações e riscos.
Campos do contrato
Nos planos Corporate e Enterprise, a aba Fabric do Hub de Observabilidade mostra quanto de cada capacidade do Fabric está em uso. O Klarun lê o modelo semântico do app Microsoft Fabric Capacity Metrics toda noite, junto com a sincronização de custo do Azure: a cada noite, lê os últimos 14 dias de segundos de CU e minutos de throttling por capacidade por dia, e os 50 itens que mais usaram CU em cada dia, para até 10 capacidades (as demais esperam a noite seguinte). O Klarun guarda 90 dias.
A configuração fica na conexão do Azure Cost Management, com o mesmo app registration: veja Configurações da organização → Integrações.
A aba Databricks do Hub de Observabilidade mostra o uso de DBU por carga de trabalho (jobs, pipelines, SQL warehouses, clusters e notebooks) nos últimos 30 dias, lido de system.billing a preço de lista. Esses números são apenas informativos e nunca viram custo real no FinOps.
Jobs sem uso são jobs que gastaram DBUs escrevendo tabelas que nada leu na mesma janela, avaliados a partir de system.access.table_lineage. Leituras feitas direto pelo caminho de armazenamento, ou por um atalho ou espelho do Fabric, não aparecem ali, então confirme com quem consome a tabela antes de parar um job.
Os dois precisam de um SQL warehouse na conexão e das permissões nas tabelas de sistema listadas em Configurações da organização → Integrações; o painel indica a permissão que falta. A linhagem dos ativos vem da mesma tabela de linhagem, nos últimos 90 dias.
Plataforma
O módulo Plataforma é onde você documenta a infraestrutura sobre a qual a sua equipe de dados roda e acompanha a saúde operacional dela. Cobre a documentação da arquitetura, os domínios de negócio e a saúde da plataforma.
Páginas: Arquitetura · Saúde da Plataforma
A Arquitetura é um inventário, não um diagrama. Ela é dividida em seções fixas, uma por camada do stack, e você registra cada ferramenta, sistema ou carga de trabalho que opera como uma entrada dentro da seção a que pertence.
Seções da arquitetura
Cada entrada registra mais do que o nome de uma ferramenta. Os campos são agrupados para que cada carga de trabalho diga quem responde por ela, quanto é usada, quanto custa e como é protegida.
Os Domínios de Negócio são registrados na seção Domínios de Negócio, no topo da página Arquitetura. Marque os domínios em torno dos quais seus dados se organizam ou adicione os seus. Os domínios são usados em Relatórios, nos incidentes da Plataforma, em Pessoas e em Projetos, e a Visão de Negócio agrupa relatórios, incidentes e iniciativas por eles. Um domínio escrito em um relatório que não corresponde a nenhum domínio registrado, nem pelo nome nem pelo id, não é tratado como tal: a Visão de Negócio ainda o mostra como a área do relatório, mas nenhum incidente ou iniciativa é associado a ele.
Os incidentes de Saúde da Plataforma são registrados com título, severidade (P1 a P4), categoria (disponibilidade, desempenho, atualidade, qualidade de dados, acesso ou custo), serviço afetado, descrição e status atual: Aberto, Investigando, Monitorando (corrigido, em observação) ou Resolvido. Atualize o status conforme o incidente avança; a primeira saída de Aberto é registrada como o momento do reconhecimento, a partir do qual se mede o tempo médio para reconhecer. O serviço afetado é escolhido no registro da Arquitetura em vez de digitado, então renomear uma entrada preserva o histórico de incidentes, e duas entradas com o mesmo nome continuam distintas. Escolher um serviço sugere uma severidade a partir da criticidade dele para o negócio, que você pode alterar. Toda mudança de status, severidade, responsável ou serviço entra no histórico do incidente, que é escrito pela plataforma e não pode ser editado. Marcar um incidente como Resolvido exige notas de resolução e um horário de resolução que não seja anterior ao início, porque são esses dois campos que calculam o MTTR. Um P1 ou P2 exige ainda uma categoria de causa raiz e uma ação preventiva ou um "nenhuma ação preventiva necessária" explícito: são os incidentes com mais a ensinar e os que mais tendem a ser fechados às pressas.
A aba Mapa de serviços, ao lado de Seções na página Arquitetura, desenha suas entradas a partir do campo Depende De: cada seta vai de uma dependência para a entrada que a usa. Entradas sem dependência em nenhum sentido não aparecem. Alterne entre as visões Diagrama e Tabela.
Selecione uma entrada para ver o seu raio de impacto: todas as entradas que dependem dela, diretamente ou por meio de outras. A coluna de saúde vem dos incidentes abertos: um P1 ou P2 mostra Fora do ar, um P3 ou P4 mostra Degradado, e as entradas que dependem dela mostram Impactado.
Uma dependência que fecharia um ciclo é recusada ao salvar e, se mesmo assim existir um ciclo, as entradas dele recebem a marca Ciclo. O mapa mostra só o que o seu time cadastrou: nada é descoberto a partir da sua nuvem.
Pessoas
O módulo Pessoas reúne a camada humana da sua organização de dados. Ele combina um cadastro da equipe, análises da força de trabalho em Operações de Pessoas e uma biblioteca de materiais de onboarding.
Páginas: Operações de Pessoas · Equipe de Dados · Integração
Campos do perfil na Equipe de Dados
Pessoas não guarda salário nem remuneração. A folha é registrada apenas no FinOps, em Custo Real.
Seções de onboarding
A página Integração é organizada em oito seções fixas. Os admins preenchem cada seção com documentos, links ou textos.
Tipos de material
Publicar na Visão de Negócio
Um admin de Pessoas pode publicar qualquer item, de qualquer seção, nos Guias da Visão de Negócio: use Publicar na Visão de Negócio no cartão, ou a chave Mostrar na Visão de Negócio no formulário. A publicação pede confirmação, já que todos que abrem a Visão de Negócio vão ler. Os leitores de negócio veem o título, a descrição e o conteúdo, nunca o propósito, as ferramentas ou os cargos. Os itens publicados levam a etiqueta Publicado e aparecem no filtro Publicados na Visão de Negócio; Remover da Visão de Negócio retira um item na hora. Admins de Pessoas aqui são people_admin, org_admin e org_member, quaisquer que sejam suas outras funções. Os leitores de negócio veem os itens publicados quando Guias é ligado em Configurações → Visão de Negócio; os itens podem ser publicados antes disso.
Um admin pode restringir a função de Pessoas de um membro a A própria pessoa e quem se reporta a ela, em Configurações → Membros, junto às funções de Pessoas. O membro passa a ler apenas o próprio registro na equipe e todos abaixo dele na linha de reporte, direta ou indiretamente. A Equipe de Dados mostra quantos da equipe inteira ele está vendo, e o organograma começa nele.
A linha parte do registro na equipe vinculado à conta do membro no Klarun. Sem registro vinculado, com dois, ou quando a linha de reporte volta até ele, o membro não vê ninguém, e as Configurações mostram um aviso ao lado dele. Os gestores são verificados a cada alteração, então um novo ciclo não pode ser salvo. A mudança vale a partir da próxima requisição do membro e fica registrada no log de auditoria. Um membro com org_admin nunca é restrito.
Projetos
O módulo Projetos é a estrutura de OKRs (Objetivos e Resultados-Chave) do Klarun. Ele dá às equipes de dados uma forma estruturada de definir a estratégia, acompanhar resultados mensuráveis e gerenciar os itens concretos de trabalho que entregam esses resultados. O Portfólio dá uma visão geral de todos os objetivos e iniciativas.
Páginas: Portfólio · Objetivos · Resultados-Chave · Iniciativas
Comece de cima para baixo: crie primeiro os Objetivos, depois adicione Resultados-Chave a cada um e, por fim, crie as Iniciativas sob os Resultados-Chave.
Um admin pode restringir a função de Projetos de um membro a Apenas o que é de sua responsabilidade, em Configurações → Membros, junto às funções de Projetos. A leitura não muda: o membro continua vendo todos os objetivos, resultados-chave e iniciativas, então o Portfólio e os totais de progresso ficam completos. O que se restringe é o que ele pode alterar.
As contribuições de uma iniciativa movem o progresso dos resultados-chave que ela vincula. Por isso, um membro restrito não pode vincular, desvincular nem alterar uma contribuição a um resultado-chave que não é dele, mesmo em uma iniciativa que é dele. Esses vínculos ficam como estão.
A responsabilidade vem do registro na equipe vinculado à conta do membro no Klarun, e cada conta pode ser vinculada a um único registro. Sem registro vinculado, ou com dois, o membro não pode alterar nada, e as Configurações mostram um aviso ao lado dele. A mudança vale a partir da próxima requisição do membro e fica registrada no log de auditoria. Um membro com org_admin nunca é restrito.
FinOps
O módulo FinOps dá à liderança de dados a visibilidade financeira de que ela precisa para gerir a área de dados como um negócio. Cobre o planejamento do orçamento, o acompanhamento do custo real e uma visão de Inteligência de Custos que compara os dois.
Páginas: Inteligência de Custos · Orçamento e Plano · Custo Real
Orçamento e Plano: adicione linhas de orçamento para cada plataforma de dados (ex.: Databricks, Snowflake, Power BI), divididas por categoria de custo e mês. O calendário fiscal segue Configurações → Organização → Início do ano fiscal.
Custo Real: lance ou importe o gasto mensal real de cada plataforma e categoria. Nos planos Corporate e acima, o assistente de IA consegue ler faturas e folhas de pagamento enviadas e transformá-las em linhas mensais estruturadas.
A Inteligência de Custos lê o orçamento e o realizado e calcula a variação automaticamente. Não há lançamento separado nessa página.
Com o Azure Cost Management conectado (veja Configurações da organização → Integrações), a sincronização noturna grava o custo faturado do Azure no realizado de Plataforma em FinOps → Custo Real: uma linha sincronizada por categoria de custo por ano fiscal, marcada como Sincronizado do Azure. As regras de mapeamento decidem em qual categoria cada linha de custo entra.
A correspondência ignora maiúsculas e minúsculas. Vence a regra mais específica e, depois, a de menor prioridade. O custo que nenhuma regra cobre aparece em Gasto sem mapeamento, do maior para o menor, e Mapear em uma linha abre uma regra já preenchida a partir dela. Criar, alterar ou apagar uma regra regrava as linhas sincronizadas na hora.
As regras pertencem à seção Plataforma: quem a possui as vê, e finops_admin as altera. Os números de DBU do Databricks em Governança são preço de lista, apenas informativos, e nunca são gravados aqui.
Os dados do FinOps são divididos em três seções, cada uma compartilhada por inteiro ou não, além da função de FinOps. A função define o quanto um membro pode fazer no FinOps; as seções definem quais partes ele vê.
Sem escolha, os admins de FinOps têm todas as seções e os demais têm Plataforma e Projetos, então a folha é sempre uma concessão explícita. Um membro com org_admin sempre tem todas as seções. Um admin altera as seções de um membro em Configurações → Membros, junto às funções de FinOps. A mudança vale a partir da próxima requisição do membro e fica registrada no log de auditoria.
Os números que somam seções, como o orçamento e a variação combinados na Inteligência de Custos, só aparecem para quem tem Plataforma e Time. Abrir ou excluir um ano fiscal e mudar o início do ano fiscal exigem todas as seções. A Avaliação 360 mostra a seção financeira só para quem tem todas as seções.
Avaliação 360
A Avaliação 360 é a revisão organizacional do Klarun feita com IA. Ela reúne dados de todos os seus módulos (Governança, Plataforma, Pessoas, Projetos e FinOps) em uma avaliação periódica e única da saúde da sua organização de dados, com análises em texto e recomendações.
Páginas: Visão 360°
Não há lançamento manual. Mantenha os outros módulos em dia e gere uma avaliação para um período. A qualidade do resultado depende de quão completos estão os dados de Governança, Plataforma, Pessoas, Projetos e FinOps.
Visão de Negócio
A Visão de Negócio é uma porta de entrada para quem está fora da equipe de dados. Ela responde a quatro perguntas: onde está o relatório de que preciso, posso confiar nele agora, com quem eu falo e o que está mudando e me afeta. Tudo o que ela mostra vem de registros que a sua equipe de dados já mantém no Klarun, por uma lista fixa de campos e em linguagem simples: sem prioridades, números de incidente, ids de plataforma nem outros termos internos.
Páginas: Início · Meu App · Encontrar · Status · O que vem por aí · Guias
Exceto no Meu App, que é a lista de cada leitor, todo leitor recebe a mesma resposta: nada nessas páginas depende de quem pergunta. Abrir um relatório e buscar somam um às contagens semanais da empresa (relatórios abertos, abertos após uma busca e buscas). No Meu App, uma alteração que adiciona relatórios soma um, uma que remove soma um, e cada relatório exibido soma um, não importa quantos relatórios a alteração mude. Nenhum leitor, id, relatório ou palavra buscada é guardado com elas, e nada do que um leitor de negócio faz altera outro dado além da sua própria lista do Meu App.
Um leitor adiciona um relatório do Power BI com Adicionar ao Meu App no card dele em Encontrar, até 50 relatórios, e os ordena como quiser. Cada relatório abre dentro do Klarun no próprio quadro do Power BI: o leitor entra no Power BI ali e vê apenas o que o seu próprio acesso no Power BI permite. O Klarun não guarda nenhum token do Power BI. Com o Login do Power BI para o Meu App ligado em Configurações → Visão de Negócio, Adicionar ao Meu App primeiro pergunta ao Power BI, com o login do próprio leitor no navegador dele, se ele pode abrir o relatório: um leitor sem acesso é avisado em vez de o relatório ser adicionado, e um acesso novo pode levar alguns minutos para valer. Com ele desligado, ou quando a verificação não pode rodar, o relatório é adicionado sem verificação, e o Power BI avisa quando carrega um relatório que o leitor não pode abrir.
O Meu App aceita apenas relatórios do Power BI e do Fabric. Relatórios paginados, dashboards, apps e relatórios de outras ferramentas mostram Indisponível no Meu App e continuam abrindo na sua ferramenta. O quadro exige a opção Embed content in apps permitida no seu locatário do Power BI; sem ela, o quadro fica em branco e Abrir no Power BI continua funcionando. O endereço do quadro leva os ids do relatório no Power BI, que quem já vê o relatório em Encontrar pode ler nas ferramentas de desenvolvedor do navegador. Ninguém mais vê a lista de um leitor, nem a equipe de dados, e ela é apagada quando o leitor sai da empresa.
Cada relatório em Encontrar leva no máximo um selo: o primeiro destes que se aplicar. Sem sinal não há selo, e nunca a afirmação de que está tudo bem.
Os selos de incidente só aparecem enquanto Status estiver ligado. Os endossos dividem uma linha no cartão: Certificado em verde (o selo 4, então só enquanto nenhum selo de problema aparece), Promovido em azul e Baseado em dados mestres em dourado, quando o modelo semântico do relatório tem o endosso Dados mestres no Fabric. Só itens de dados podem ser dados mestres, nunca um relatório.
Enquanto uma iniciativa publicada do tipo Migração de Relatórios, Migração Técnica ou Migração de Dados estiver em andamento ou planejada, cada relatório da área dela avisa que alguns relatórios ali estão mudando, com o mês previsto de conclusão, e leva à iniciativa. O aviso fala da área, nunca do relatório, e só aparece enquanto O que vem por aí estiver ligado. Selos e avisos de área exigem um Domínio de Negócio: uma área que não é um deles não recebe nenhum dos dois.
Tudo é definido em Configurações → Visão de Negócio. Membros com org_admin ou org_member gerenciam, e só eles abrem as Configurações. Toda mudança vale para todos na hora e fica registrada como admin.business_view_changed, com o que mudou, mas nunca o contato.
Em Projetos → Iniciativas, use Publicar na Visão de Negócio na linha da iniciativa, ou a chave Mostrar na Visão de Negócio no formulário. Quem pode editar uma iniciativa pode publicá-la, então um membro restrito ao que é dele só publica as próprias. A publicação pede confirmação, porque um título que os leitores de negócio já viram não se desfaz. As iniciativas publicadas levam a etiqueta Publicada, e o filtro Publicadas na Visão de Negócio as lista. O trabalho entregue sai de O que vem por aí 90 dias depois da data de fim.
Em Pessoas → Integração, um admin de Pessoas publica os itens um a um, em qualquer uma das oito seções, com Publicar na Visão de Negócio ou a chave Mostrar na Visão de Negócio. Funciona como as iniciativas: quem gerencia as Configurações liga ou desliga Guias para a empresa inteira (começa desligado), e os admins de Pessoas escolhem o que entra. A publicação pede confirmação, a etiqueta Publicado marca o que os leitores de negócio veem, e Remover da Visão de Negócio retira um item na hora. Guias mostra só as seções que têm um item publicado, e uma página vazia enquanto nada estiver publicado. Veja Pessoas.
A área de um relatório é o Domínio de Negócio de Plataforma → Arquitetura quando o domínio do relatório corresponde a um, pelo id ou pelo nome, ignorando maiúsculas e espaços. Caso contrário, é o próprio valor de domínio do relatório, porque os domínios do Fabric não precisam coincidir com os registrados no Klarun; grafias que só diferem em maiúsculas ou espaços são uma área só. Incidentes e iniciativas só são associados a Domínios de Negócio, então uma área que não é um deles não recebe selo de incidente da área nem aviso de migração. Um domínio vazio ou com cara de id não mostra área.
Configurações da organização
As Configurações ficam na barra lateral, sob o nome da sua organização. A página tem cinco abas: Organização, Integrações, Membros, Visão de Negócio e Cobrança. Quem tem a função org_admin pode alterar todas as configurações. A função org_member pode gerenciar as abas Organização, Integrações, Membros e Visão de Negócio, mas não Cobrança, e não pode conceder a função de admin.
Aba Organização
Configure o perfil da organização. Esses valores aparecem em todo o app: o ano fiscal orienta o FinOps, o fuso horário orienta as métricas de incidentes, e o setor dá contexto à Avaliação 360.
Verificação de domínio
Registre o domínio de e-mail da empresa para habilitar convites por domínio. Qualquer pessoa com um e-mail desse domínio pode então entrar no seu espaço de trabalho por um link de convite de domínio, sem precisar de um código avulso.
A verificação é feita por um código de uso único enviado a um e-mail de admin no domínio registrado. Depois de verificado, o domínio fica travado e é usado em todos os convites de domínio futuros.
Aba Integrações
Conecte suas ferramentas de BI ao Klarun. As integrações sincronizadas preenchem automaticamente os Relatórios (módulo Relatórios), os Ativos (módulo Governança) e o Hub de Observabilidade. Membros com org_admin ou org_member conectam, sincronizam e desconectam as integrações; funções de módulo, inclusive reporting_admin, não. Conectar e sincronizar exigem o plano Business ou superior. Desconectar funciona em qualquer plano: depois de um downgrade, a sincronização pausa e o que foi sincronizado continua disponível para leitura.
Passos para configurar o Power BI
Vá em Portal do Azure → Microsoft Entra ID → Registros de aplicativo → Novo registro. Dê qualquer nome (ex.: "Klarun Integration"), selecione Locatário único e clique em Registrar. Use um registro dedicado: não reutilize o que está conectado ao Microsoft 365 Copilot.
Deixe as permissões de API vazias. Não adicione Tenant.Read.All e não conceda consentimento de administrador. O Power BI recusa um service principal que tenha permissões do Power BI com consentimento de administrador no Entra, e a chamada falha com um 401 que parece problema de credencial. O acesso é concedido no portal de administração do Power BI, nos passos 03 e 04.
Abra o Portal de administração do Power BI → Configurações do locatário → Configurações do desenvolvedor. Habilite "Service principals can call Fabric public APIs". Isso cobre a listagem de workspaces e relatórios. Se restringir a um grupo de segurança, adicione o service principal a esse grupo. O portal pode mostrar os nomes das configurações em inglês.
Power BI Admin Portal → Tenant settings → Developer settings → Service principals can call Fabric public APIsNo mesmo portal, abra Configurações do locatário → Configurações de API de administração e habilite "Service principals can access read-only admin APIs". É uma chave separada da do passo 03 e cobre metadados, linhagem e uso de todo o locatário. Restrinja a um grupo do qual o service principal faça parte e aguarde cerca de 15 minutos para que as duas configurações entrem em vigor.
Power BI Admin Portal → Tenant settings → Admin API settings → Service principals can access read-only admin APIsDe volta ao registro do aplicativo → Certificados e segredos → Novo segredo do cliente. Defina uma validade, clique em Adicionar e copie na hora a coluna Valor. Não copie o ID do segredo, que fica ao lado e não é uma credencial. O Valor aparece uma única vez.
Vá em Configurações → Integrações → Power BI → Conectar. Informe o ID do tenant, o ID do aplicativo (cliente) e o valor do Segredo do cliente. Clique em Testar conexão e, se der certo, em Salvar e sincronizar.
Databricks
Conecte um ou mais espaços de trabalho do Databricks com a URL do espaço de trabalho e um service principal ou um token de acesso pessoal e, opcionalmente, um SQL warehouse. Depois de conectado, o Klarun sincroniza catálogos, schemas, tabelas e views, clusters, SQL warehouses, jobs, pipelines e notebooks como ativos de Governança. O uso e a atividade vêm do log de auditoria do espaço de trabalho (a tabela de sistema system.access.audit), que o Klarun só consegue consultar por meio de um SQL warehouse: com um escolhido, o uso também é sincronizado; sem ele, os ativos são sincronizados e o uso não.
Uso de DBU, jobs sem uso e linhagem leem tabelas de sistema do Unity Catalog pelo mesmo SQL warehouse, filtradas pelo espaço de trabalho. Conceda ao service principal USE CATALOG no catálogo system, e USE SCHEMA e SELECT em system.billing (uso e preços de lista) e system.access (auditoria e linhagem de tabelas). USE SCHEMA e SELECT em system.lakeflow são opcionais e acrescentam falhas de execução de jobs às sugestões de Saúde. Isso exige um espaço de trabalho com Unity Catalog e uma URL do espaço de trabalho no formato adb-NNNN, que traz o id do espaço de trabalho; caso contrário, essas leituras são puladas.
Microsoft 365 Copilot
Use um registro de aplicativo no Entra dedicado, não o conectado ao Power BI: as permissões do Graph com consentimento de administrador do Copilot impediriam um registro compartilhado de chegar às APIs de administração somente leitura do Power BI. No registro, em Permissões de API, adicione as permissões de aplicativo do Microsoft Graph Reports.Read.All e Organization.Read.All e conceda o consentimento de administrador. As Configurações podem copiar o ID do tenant da sua conexão do Power BI.
O Klarun lê o número de licenças e os relatórios de uso do Copilot de todo o locatário. Reports.Read.All cobre todos os relatórios de uso do Microsoft 365, porque a Microsoft não oferece um escopo só para o Copilot. A Microsoft publica o uso com 48 a 72 horas de atraso, então os primeiros números aparecem alguns dias depois de conectar.
Passos de configuração do Azure Cost Management
Vá em Azure Portal → Microsoft Entra ID → App registrations → New registration. Dê um nome (ex.: "Klarun Cost"), selecione Single tenant e clique em Register. Mantenha-o separado dos registros do Power BI e do Copilot. Ele não precisa de nenhuma permissão de API.
Em cada assinatura que o Klarun deve ler, abra Access control (IAM) → Add role assignment, escolha Cost Management Reader e atribua ao app. A função é somente leitura: mostra dados de custo e não dá acesso aos recursos em si. Uma atribuição nova pode levar alguns minutos para valer.
Subscription → Access control (IAM) → Add role assignment → Cost Management ReaderNo app registration → Certificates & secrets → New client secret. Defina uma validade, copie o Value (não o Secret ID) na hora e anote a data de expiração: você vai precisar dela no passo 06.
Vá em Configurações → Integrações → Azure Cost Management → Conectar. Informe o ID do tenant (um GUID; common e organizations são recusados), o ID do aplicativo (cliente) e o valor do Segredo do cliente. Testar conexão lista as assinaturas que o app consegue ler.
As assinaturas ativas já vêm marcadas. Mantenha até 50 e clique em Salvar; uma assinatura que o app não consegue ler é recusada. O custo é lido toda noite, por mês, grupo de recursos e serviço. O Azure publica o custo com 8 a 24 horas de atraso, então os dias mais recentes se completam nas sincronizações seguintes.
O Klarun não acompanha a data de expiração. Antes dela, crie um segredo novo no mesmo registro, depois Conecte de novo, teste e salve: salvar substitui a conexão guardada. Em seguida, apague o segredo antigo no Azure. Se o segredo expirar antes, a sincronização noturna falha, a conexão mostra o erro e o custo já sincronizado continua.
Aba Membros
Gerencie quem faz parte do seu espaço de trabalho no Klarun. Você vê todos os membros atuais, altera as funções deles e cria códigos de convite.
Tipos de assento
Cada membro ocupa um assento de visualizador ou um assento de equipe de dados. Todos que entram, por código de convite ou por domínio, começam em um assento de visualizador, que tem só a função business_viewer e abre a Visão de Negócio. Os assentos de visualizador são ilimitados em todos os planos. Um assento de equipe de dados tem funções de módulo, e os assentos de equipe de dados são o que dimensiona um plano: 2 no Free, 15 no Business, 30 no Corporate e ilimitados no Enterprise. O cabeçalho de Membros mostra quantos estão em uso. Quando todos estão, um membro em assento de visualizador não pode passar para um assento de equipe de dados até que alguém volte para um assento de visualizador ou o plano mude. Recuperar o acesso de admin pelo DNS sempre funciona, mesmo com o plano cheio, porque é assim que uma organização sem admin volta a ter um.
Tipos de código de convite
Aba Visão de Negócio
Escolha quais páginas da Visão de Negócio ficam ligadas, inclusive Guias, e para onde os leitores de negócio levam suas dúvidas. O que Guias mostra é publicado item a item em Pessoas → Integração. A aba também mostra a completude da Visão de Negócio, como ela está sendo usada e uma prévia, um painel abaixo do outro. Veja Visão de Negócio.
Aba Cobrança
Veja o seu plano atual e gerencie a assinatura. Upgrade, downgrade e dados de pagamento são todos tratados nesta aba. Só quem tem a função org_admin acessa a aba Cobrança.
Notificações
O sino no cabeçalho mostra o que precisa da sua atenção, em todos os assentos. A contagem é atualizada cerca de uma vez por minuto enquanto o Klarun está aberto em uma aba visível. Abra uma notificação para ir direto ao item; se o item não existir mais, a página avisa que ele não está mais disponível. Uma solicitação de acesso pode ser aprovada ou dispensada na própria notificação. Minha Conta → Notificações lista todas as notificações, com filtros, seleção, marcar como lida e excluir. Uma notificação excluída pode ser restaurada por 10 segundos.
Sobre o que você é notificado
Cada notificação vai apenas para quem pode agir sobre ela ou ler o item, e a lista confere isso de novo sempre que carrega: um membro que perde o acesso a um item deixa de ver a notificação dele. Ninguém é notificado da própria ação, como um incidente que abriu.
Quanto tempo ficam
Uma notificação fica por 3 dias depois da última vez que apareceu, lida ou não. Um item de ação (uma solicitação de acesso, um incidente atribuído a você, uma revisão do catálogo pendente) fica até alguém tratá-lo, e depois mais 3 dias. Uma repetição do mesmo evento atualiza a notificação existente em vez de criar outra.
Membros em assento de equipe de dados também podem receber notificações por e-mail, escolhidas por categoria em Minha Conta → Notificações. Cada e-mail traz o título da notificação e um link para o item. Assentos de visualizador nunca recebem e-mail.
A mesma página permite ocultar alertas e atualizações do sino. Incidentes críticos sempre aparecem, e itens de ação e avisos do sistema não podem ser ocultados. A revisão do catálogo mantém o próprio e-mail diário de lembrete, descrito em Itens ocultos do catálogo.
Um admin da organização pode ativar Enviar incidentes críticos por e-mail para toda a equipe de dados em Configurações → Organização. Assim, incidentes P1 e P2 chegam por e-mail a todos os membros da equipe de dados que os recebem, inclusive a quem desativou os e-mails de alerta ou ocultou o tipo.
Conector de IA
O conector de IA permite que o Claude, o ChatGPT, o Microsoft Copilot e outros assistentes compatíveis com o Model Context Protocol (MCP) leiam o Klarun e, quando a sua empresa permite, adicionem e atualizem itens nele. Cada pessoa se conecta com a própria conta do Klarun, e o assistente vê só o que as funções dessa pessoa permitem. A URL do conector fica em Configurações → Integrações → Conector de IA (MCP). O conector está disponível em todos os planos pagos; no plano Free, um org admin ainda pode desligá-lo e revogar clientes, e os membros ainda podem desconectar os seus apps.
Acesso da empresa
Um org admin escolhe o que os assistentes podem fazer na empresa inteira, em Acesso da empresa, no mesmo painel. Começa em Somente leitura.
Conecte um assistente
Cada pessoa adiciona o Klarun no seu assistente com a URL do conector, entra no Klarun e aprova o acesso que o assistente pede. O Claude e o ChatGPT não precisam de configuração no Klarun.
O que os assistentes adicionam
Um relatório adicionado por um assistente entra como Revisão Pendente, para que um admin de relatórios o confira antes de valer. Tudo o que um assistente adiciona ou edita mostra uma etiqueta Adicionado via ou Editado via (Claude, ChatGPT ou Copilot) no Catálogo de Relatórios, em Orçamento e Plano e em Custo Real, e o Catálogo de Relatórios pode filtrar por quem adicionou um relatório. Campos que uma sincronização preenche, como os detalhes de um relatório sincronizado ou as linhas da sincronização de custos do Azure, não são sobrescritos. Um assistente envia no máximo 50 itens por chamada, e enviar o mesmo item de novo não cria duplicata.
Desconecte e acompanhe
Qualquer pessoa pode desconectar os próprios assistentes em Minha Conta → Apps de IA conectados. Um org admin vê todas as conexões em Conexões, no painel do conector de IA, e pode revogar qualquer uma delas, ou revogar um cliente OAuth e todas as conexões feitas por ele. Baixar atividade do conector de IA (CSV) lista cada ferramenta que um assistente chamou, por quem e por qual cliente, com o número de itens; o que foi perguntado nunca é registrado. Mudar o Acesso da empresa para Desligado desconecta todos de uma vez.
Funções
O Klarun usa um sistema de funções em camadas. Cada membro tem uma função da organização, que controla o acesso básico em todo o espaço de trabalho, mais funções de módulo opcionais, que dão permissões maiores dentro de módulos específicos.
Funções da organização
Atribuídas no nível do espaço de trabalho. Valem para todos os módulos, a menos que uma função de módulo as substitua.
Funções de módulo
Cada módulo tem três níveis: admin, contribuidor e visualizador. As funções de módulo se somam: atribuir uma função de módulo a um membro dá esse nível de permissão naquele módulo, qualquer que seja a função da organização.
Matriz de permissões
Permissões básicas por nível de função, válidas em todos os módulos. Admins de módulo têm os mesmos privilégios que os admins da organização dentro do seu módulo. Exceção: em Pessoas e FinOps, criar, editar e excluir registros exige o nível admin, e o FinOps ainda é dividido em seções (veja Seções do FinOps). Em Projetos, um admin pode limitar um membro a alterar só o que é dele (veja Alterar só o que é seu), e em Pessoas, à própria pessoa e a quem se reporta a ela (veja A própria pessoa e quem se reporta a ela). Qualquer pessoa cuja conta no Klarun esteja vinculada a um registro na equipe pode editar as próprias habilidades e idiomas. As quatro últimas linhas são configurações da organização: pertencem só a org_admin e org_member, nunca a um admin de módulo.
Escopos de acesso a dados
As funções decidem o que um membro pode fazer em cada módulo. Os escopos de acesso a dados restringem quais registros desse módulo ele alcança. Um escopo só restringe uma função: nunca concede um acesso que a função não dá, e nunca se aplica a um membro com org_admin. Os escopos são de cada membro, definidos por um admin em Configurações → Membros ao lado das funções que restringem, e aplicados no servidor a cada requisição, tanto nas páginas quanto na API. Os itens do Catálogo de Relatórios são restringidos por item, não por membro: veja Itens ocultos do catálogo.
Os três escopos
Cada escopo é descrito por completo junto do seu módulo: veja Seções do FinOps, Alterar só o que é seu e A própria pessoa e quem se reporta a ela.
Quando um escopo não pode ser calculado
Os escopos de Projetos e de Pessoas partem do registro na equipe vinculado à conta do membro no Klarun. Cada conta pode ser vinculada a um único registro, e um admin só pode vincular um registro à própria conta quando o e-mail do registro é o dele. Quando o vínculo falta ou está duplicado, ou quando a linha de reporte volta até o membro, o escopo não dá nada em vez de adivinhar: em Projetos o membro não pode alterar nada, e em Pessoas ele não vê ninguém. As Configurações mostram um aviso ao lado do membro para que um admin corrija o registro. Os gestores são verificados a cada alteração, então um novo ciclo não pode ser salvo. Um escopo salvo que não pode ser lido é tratado como a opção restrita.
Em todo lugar onde os dados aparecem
Um escopo acompanha os dados, não a página, então as mesmas regras valem onde quer que esses dados apareçam.
Auditoria
Toda mudança de escopo fica registrada como admin.scope_changed, com o membro, o admin e o novo valor de cada módulo alterado. Toda mudança na conta à qual um registro da equipe está vinculado fica registrada como people.link_changed, e as mudanças de função continuam como admin.role_changed. Uma mudança de escopo vale a partir da próxima requisição do membro, sem desconectá-lo; uma mudança de função o desconecta de todas as sessões, então vale na hora.
Esses eventos ficam no log de auditoria da organização, que registra entradas, saídas e tentativas de entrada que falharam, além de mudanças de segurança e de administração: funções, escopos de acesso a dados, membros removidos, sessões encerradas, integrações conectadas, desconectadas e sincronizadas, mudanças em contratos, configurações da Visão de Negócio, o modelo de assentos do Copilot e as exportações de uso do Copilot por usuário, o conector de IA (o nível de acesso, os clientes registrados e as conexões feitas ou revogadas), membros da equipe editando ou vinculando o próprio registro, e decisões sobre iniciativas propostas (ROI): aprovações, adiamentos, rejeições e rebaseamentos, sem o valor nem a justificativa. Ele registra esses eventos, não toda mudança em todo registro. Membros com org_admin ou org_member, que gerenciam as Configurações, podem baixá-lo em CSV nas Configurações. Cada ferramenta que um assistente de IA chama pelo conector também é registrada, nunca o que foi perguntado, e é baixada à parte no painel do conector de IA em Configurações, Integrações.
Itens ocultos do catálogo
O Catálogo de Relatórios é aberto a todos da sua organização por padrão. Um admin da organização ou um admin de relatórios pode ocultar um workspace do Power BI ou um único relatório em Configurações → Catálogo de relatórios, ou pelo menu da linha no catálogo, e escolher as pessoas que continuam vendo o item. Admins sempre veem tudo. Ocultar é uma configuração do Klarun: não lê nem altera permissões no Power BI ou no Microsoft Fabric.
Como funciona
Onde se aplica
Um item oculto fica fora de todas as listas, buscas, contagens, rankings de uso e exportações para quem não está na lista dele: o Catálogo de Relatórios, a Business View, os ativos, a saúde, a atividade e os responsáveis em Governança, a exportação CSV de ativos e os ativos de um perfil em Pessoas. Abrir o link direto dá a mesma resposta de um item que não existe. Na linhagem ele aparece como Item indisponível, sem nome, workspace ou responsável. Quem está na lista vê um selo com cadeado que mostra quem mais vê o item. Rotinas que rodam sem uma pessoa conectada, como a Avaliação 360 e as sugestões de incidentes, deixam de fora todo item com regra. Se as regras não puderem ser lidas, o Klarun oculta de todos, exceto dos admins, cada item com regra em vez de exibi-lo.
Mantendo as listas em dia
Quando um membro sai da organização, ou o registro dele em Pessoas é marcado como inativo ou removido, ele sai de todas as listas na hora. A cada 90 dias cada lista precisa ser revisada: as Configurações marcam a lista, um admin a confirma com um clique, e admins da organização e admins de relatórios recebem um e-mail diário com o número de listas pendentes e um link, nunca os nomes dos itens. Cada regra guarda o histórico completo de alterações, que os admins podem ver nas Configurações ou baixar em CSV.
Edição implantada no cliente
Na edição implantada no cliente, o Klarun roda na sua própria assinatura do Azure, como uma instalação para a sua organização. Seus dados, logs e backups ficam no seu tenant e na sua região, e a instalação não envia nada ao Klarun: nem telemetria, nem heartbeat. O Klarun e o seu time de infraestrutura instalam e atualizam juntos, seguindo os runbooks de instalação e atualização enviados com cada versão. Esta seção é para o administrador do Klarun e para o seu time de Azure.
O que muda
Pré-requisitos
Versões e atualizações
As versões têm nome por data (CalVer, AAAA.M.PATCH, por exemplo 2026.10.0). O seu endereço seguido de /api/healthz mostra a versão em execução, e o bloco de versão no topo deste manual mostra a versão que ele descreve. Cada versão vem com notas em inglês, português e espanhol: o digest da imagem, as mudanças no banco de dados, se a reversão é segura e o que mudou. As atualizações são feitas uma versão por vez, levam cerca de 30 minutos e aplicam as mudanças no banco antes de a nova versão receber tráfego. O Klarun dá suporte à versão atual e às duas anteriores (N-2).
Reversão e restauração
Se uma nova versão apresentar problemas, o seu time volta para a versão anterior pelo digest da imagem. As mudanças no banco só adicionam, então uma reversão não precisa de restauração. O Azure guarda 35 dias de pontos de restauração do banco na sua região. Uma restauração vai para um novo servidor e a instalação é então reimplantada sobre ele, então o banco em uso nunca é sobrescrito. Faça um teste de restauração após a instalação e uma vez por ano.
Suporte
O seu time de infraestrutura é a primeira linha. Quando algo falha, ele roda o script de pacote de suporte, que lê versões, saúde, histórico de jobs e logs recentes com acesso somente leitura, e substitui tokens, chaves, endereços de e-mail e endereços IP. Ele nunca lê segredos, configurações ou linhas do banco. O seu time revisa o arquivo e o envia pelo canal de suporte do contrato.