Manual de Administração e Operação
Versão do manual
1.23.0
Aplica-se à versão Klarun
2026.09
Última atualização
30 de setembro de 2026
Documentação do Klarun

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.

Primeiros passos

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.

RelatóriosCatálogo de Relatórios
Centraliza todos os relatórios, dashboards e ativos de BI da sua organização.
GovernançaHub de Observabilidade · Ativos · Contratos e Fontes
Acompanha os ativos de dados e a saúde deles, e os contratos por trás das suas fontes de dados.
PlataformaArquitetura · Saúde da Plataforma
Documenta a arquitetura da sua plataforma de dados, os domínios de negócio e a saúde operacional.
PessoasOperações de Pessoas · Equipe de Dados · Integração
Cadastro da sua organização de dados, análises da força de trabalho e biblioteca de onboarding.
ProjetosPortfólio · Objetivos · Resultados-Chave · Iniciativas
Estrutura de OKRs e acompanhamento de iniciativas da sua estratégia de dados.
FinOpsInteligência de Custos · Orçamento e Plano · Custo Real
Planeje e acompanhe os gastos da plataforma de dados, orçamento vs. realizado e custo por plataforma.

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.

01
Preencha as configurações da organização

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.

02
Verifique seu domínio

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.

03
Convide sua equipe

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.

04
Conecte as integrações

Em Configurações → Integrações, conecte Fabric / Power BI, Databricks e Microsoft 365 Copilot. Depois de conectados, o Klarun sincroniza automaticamente relatórios e ativos do Fabric / Power BI, ativos do Databricks, e licenças e uso do Copilot. As integrações exigem o plano Business ou superior.

05
Preencha Relatórios

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.

06
Monte Pessoas

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.

07
Adicione os materiais de onboarding

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.

08
Registre a arquitetura da plataforma

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.

09
Configure a Governança

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.

10
Configure o FinOps

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.

11
Defina os Projetos (OKRs)

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.

Free · US$ 0 / mês
  • 5 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
Não inclui: integrações, análise de atividade e recursos com IA.
Para conectar integrações (Fabric / Power BI, Databricks e Microsoft 365 Copilot) e ter análise de atividade, faça upgrade para o plano Business (US$ 390 / mês) ou superior. Recursos de IA como a Avaliação 360 exigem o plano Corporate ou superior. Veja a página de preços para a comparação completa.
Módulo

Relatórios

O que é

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

Para que serve
Descoberta de relatóriosQualquer pessoa encontra relatórios de todas as ferramentas de BI em uma só busca.
ResponsáveisSaiba quem responde por cada relatório e a quem pedir mudanças.
Atualização visívelMostre a quem consome com que frequência o relatório é atualizado (diário, de hora em hora ou sob demanda).
EnriquecimentoMarque relatórios com domínios e subdomínios para filtrar pelo negócio.
Como preencher

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

CampoDescrição
Nome do RelatórioNome de exibição do relatório ou dashboard.
LinkURL que abre o relatório. Preenchido pela sincronização do Fabric / Power BI.
DescriçãoContexto em texto livre: o que o relatório mostra e para quem é.
DomínioDomínio de negócio de nível superior (ex.: Finanças, Marketing). Definido manualmente.
SubdomínioSubclassificação dentro do domínio (ex.: Receita, Atribuição).
Espaço de TrabalhoEspaço de trabalho de origem. Preenchido e bloqueado quando sincronizado de uma ferramenta de BI.
ResponsávelE-mail da pessoa responsável por este relatório.
FrequênciaCom que frequência o relatório é atualizado. As opções aparecem em inglês (ex.: Daily, Hourly, On demand).
FerramentaFerramenta de BI usada no relatório (ex.: Power BI, Looker, Metabase).
StatusAtivo · Revisão Pendente · Manutenção · Descontinuado.
TagsRótulos livres para busca e filtros.
Sobre a sincronização: os campos marcados como sincronizado são gerenciados pela integração e sobrescritos a cada sincronização. Vindos do Microsoft Fabric, são Nome do Relatório, Link, Ferramenta, Espaço de Trabalho, Domínio, Subdomínio, Responsável e Frequência: você define Status, Tags e Descrição. Vindos do Power BI, são Nome do Relatório, Link, Ferramenta e Espaço de Trabalho, mais a Descrição quando o Power BI tiver uma; todo o resto continua editável e é preservado entre sincronizações.
Notas de acesso
reporting_adminPode registrar, editar e excluir todos os relatórios. Conectar e sincronizar integrações não faz parte desta função: exige org_admin ou org_member, em Configurações → Integrações.
reporting_contributorPode registrar, editar e excluir relatórios.
reporting_viewerSomente leitura. Pode navegar, buscar e abrir relatórios.
Módulo

Governança

O que é

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

Para que serve
Visibilidade dos ativosVeja em um só lugar cada relatório, modelo semântico, notebook, pipeline e lakehouse.
Saúde dos ativosIdentifique ativos quebrados, órfãos ou desatualizados antes que afetem quem os consome.
Gestão de contratosAcompanhe SLAs, datas de renovação, confiança e criticidade de cada fonte de dados.
Visão de governançaUma aba por integração conectada (Fabric / Power BI, Databricks, Microsoft 365 Copilot) com a atividade e o uso dela. O histórico de atividade segue o plano: 3 meses no Business, 12 meses no Corporate e todo o histórico no Enterprise.
Como preencher

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

CampoDescrição
Nome do ContratoNome de exibição da fonte de dados ou do contrato com o fornecedor.
Nome da FonteIdentificador da fonte de dados subjacente.
DomínioDomínio de negócio ao qual esta fonte pertence.
ResponsávelPessoa que responde por esta fonte de dados.
CriticidadeBaixa · Média · Alta · Crítica. O impacto no negócio se esta fonte falhar.
ConfiançaConfiável · Observação · Não confiável. O quanto quem consome pode confiar nesta fonte.
Nível do ContratoSem Contrato · Nível 0 (Registrado) · Nível 1 (Operacional) · Nível 2 (Contrato Completo). Atualizado automaticamente conforme os campos do contrato preenchidos.
SLADisponibilidade ou janela de entrega esperada (ex.: "99,5% de disponibilidade").
ClassificaçãoPública · Interna · Confidencial · Restrita · Não classificada. Nível de sensibilidade dos dados.
ConsumidoresNúmero de consumidores a jusante desta fonte.
Notas de acesso
governance_adminAcesso total. Pode gerenciar ativos e criar, editar e excluir contratos.
governance_contributorPode criar e editar contratos.
governance_viewerAcesso somente leitura a todas as páginas de Governança.
Módulo

Plataforma

O que é

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

Para que serve
Documentação da arquiteturaMantenha um registro vivo das camadas, ferramentas e componentes de infraestrutura da plataforma de dados.
Inventário de licençasAcompanhe ferramentas licenciadas e assistentes de IA com número de assentos, custo por assento e status da implantação.
Domínios de negócioDefina os domínios de negócio em torno dos quais seus dados se organizam.
Registro de incidentesRegistre incidentes da plataforma com severidade, sistemas afetados e prazos de resolução.
Status visívelDê à organização inteira um retrato claro da saúde atual da plataforma.
Apoio ao onboardingQuem chega na engenharia de dados entende a plataforma inteira de relance, sem depender de conhecimento informal.
Como preencher

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

SeçãoO que entra aqui
Fontes de DadosSistemas de origem que alimentam a plataforma
LinguagensCom o que a equipe constrói
Provedores de NuvemOnde a plataforma roda
OrquestraçãoComo os fluxos são agendados e gerenciados
Processamento de Dados / PipelinesComo os dados são transformados
ArmazenamentoOnde ficam os dados brutos e processados
Lakehouse / WarehouseDados estruturados, prontos para consumo
BI / AnalyticsComo o negócio consome dados
Governança & CatálogoControle e visibilidade
IA & MLCapacidades avançadas de dados
Assistentes & Agentes de IAAssistentes e agentes de IA licenciados em uso

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.

Grupo de camposRegistra
Visão geralA ferramenta ou o sistema em si: nome, tipo, tecnologia e provedor de nuvem.
Responsabilidade & CriticidadeResponsável, criticidade para o negócio, ambiente e estágio do ciclo de vida (em uso, em desativação, planejado). O responsável pode ser escolhido na equipe de dados, então a responsabilidade continua correta quando alguém muda de função; um squad ou texto livre cobre fornecedores e quem está fora da equipe.
Escala & UsoQuanto é usado: nível de adoção, volumes, frequência de atualização e número de pessoas capacitadas.
Licenciamento & CustoModelo de licença, número de assentos ou capacidade, custo e data de renovação ou fim do contrato. Apenas estimativas de planejamento.
Segurança & ConformidadeClassificação dos dados, exposição de dados pessoais (PII) e residência dos dados. Uma fonte marcada em Contém PII precisa ter a Classificação de Dados Restricted / PII; as duas coisas não podem divergir.
NotasDescrição em texto livre do papel desse componente na plataforma.
Os campos de custo são bases de planejamento. Os números de licenças e o custo por assento informados aqui são estimativas para dimensionar a plataforma. O gasto mensal real é acompanhado à parte em FinOps → Custo Real, e os dois não são conciliados automaticamente.

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.

Notas de acesso
platform_adminAcesso total. Pode criar, editar e excluir entradas da arquitetura, domínios de negócio e incidentes. Excluir um incidente o esconde em todo lugar, mas mantém o registro, com quem o removeu e quando.
platform_contributorPode criar e atualizar entradas da arquitetura e incidentes, mas não excluir.
platform_viewerAcesso somente leitura às páginas de arquitetura e de saúde.
Módulo

Pessoas

O que é

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

Para que serve
Cadastro da equipeMantenha um diretório vivo de cada membro da equipe de dados, com skills, domínios e senioridade.
OrganogramaVisualize a hierarquia da equipe, agrupada por senioridade, com cartões de perfil.
Força de trabalhoEntenda a composição da equipe, a cobertura de skills, a distribuição de senioridade e a responsabilidade por domínio.
Skills críticasIdentifique skills que só um membro tem, um risco operacional importante.
Biblioteca de onboardingGuarde e compartilhe todo material de que quem chega à equipe de dados precisa, organizado por fase de onboarding.
Como preencher

Campos do perfil na Equipe de Dados

CampoDescrição
Nome completoNome completo do membro da equipe.
E-mail corporativoE-mail de trabalho. Único na organização.
ID do funcionárioIdentificador opcional do RH. Visível apenas para admins de Pessoas.
CargoCargo, escolhido na lista padrão de funções de dados.
SquadTime ou chapter: Architecture, Engineering, Analytics, Governance, AI/ML ou um squad personalizado.
SenioridadeTrainee · Júnior · Pleno · Sênior · Lead · Gestão.
Reporta aO gestor do membro, escolhido na equipe. Monta o organograma.
StatusAtivo ou Inativo.
DepartamentoDepartamento mais amplo da empresa. Texto livre.
HabilidadesHabilidades com nível de proficiência (1 Iniciante → 5 Especialista). Plataformas e ferramentas também são habilidades: liste Fabric ou Databricks aqui, com um nível.
IdiomasIdiomas falados, cada um com um nível de proficiência.
Propriedade de domíniosDomínios de negócio pelos quais o membro responde.

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.

SeçãoObjetivoConteúdo típico
AcessoRemova todo o atrito para começarAcesso a sistemas e repositórios, credenciais, VPN
Contexto de negócioEntenda por que os dados existemVisão da empresa, domínios principais, KPIs centrais, casos de uso de dados
Formas de trabalhoComo as coisas realmente são feitasFluxo de desenvolvimento, modelo de sprint, canais de comunicação, Definition of Done
Arquitetura de dadosEntenda o panorama geralDiagramas de arquitetura, fluxo de dados, estratégia medallion, plataformas principais
EngenhariaComo construir as coisasPadrões de código, padrões de pipeline, convenções de nomes, CI/CD
AnalyticsComo os dados são consumidosPadrões de BI, modelos semânticos, camada de métricas, boas práticas de relatórios
GovernançaRegras e responsabilidadesPropriedade dos dados, controle de acesso, expectativas de qualidade, compliance
IA & MLCapacidades avançadasFluxos de ML, engenharia de features, deploy de modelos, acompanhamento de experimentos

Tipos de material

DocumentoEnvie qualquer arquivo (PDF, DOCX, XLSX etc.). Fica armazenado com segurança; um botão Baixar aparece no cartão.
LinkCole qualquer URL (Confluence, Notion, YouTube etc.). Um botão Abrir abre em uma nova aba.
TextoEscreva texto simples ou Markdown direto no Klarun. Aparece no cartão com Mostrar mais / Mostrar menos.

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.

A própria pessoa e quem se reporta a ela

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.

OndeO que o membro restrito recebe
Equipe de DadosO próprio registro e os de quem se reporta a ele, incluindo a aba de ativos sob responsabilidade. Qualquer outro retorna como não encontrado.
Operações de PessoasComposição, habilidades e entrada no time da própria linha. O registro de riscos, a cobertura de domínios e o parque de dados descrevem a equipe inteira, então ficam bloqueados.
AlteraçõesComo admin de Pessoas: só registros da própria linha. Novos membros entram abaixo de alguém dessa linha, os membros dela mantêm um gestor dentro dela, o próprio gestor é definido por quem está acima, e um membro que ainda tem subordinados não pode ser excluído até que eles sejam movidos.
Em outros lugaresA Avaliação 360 não mostra a seção de pessoas, porque ela descreve a equipe inteira. Os seletores em outros módulos continuam listando todos os membros, só com nome e status.

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.

Notas de acesso
people_adminPode adicionar, editar e excluir membros da equipe e materiais de onboarding, e publicar materiais de onboarding na Visão de Negócio. A única função que vê o ID do funcionário.
people_contributorMesma leitura que people_viewer. Adicionar, editar e excluir membros e materiais de onboarding exige people_admin.
people_viewerAcesso somente leitura a perfis, organograma, análises de Operações de Pessoas e materiais de onboarding.
Módulo

Projetos

O que é

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

Para que serve
Visão de portfólioVeja cada objetivo, resultado-chave e iniciativa em um só lugar e acompanhe a estratégia de relance.
Alinhamento estratégicoConecte o trabalho do dia a dia às metas do negócio por uma hierarquia de três níveis.
ResultadosMeça o progresso dos Resultados-Chave com metas numéricas e marcos.
Kanban de iniciativasGerencie os itens de trabalho (iniciativas) em um kanban vinculado aos Resultados-Chave.
Orçamentos de projetoVincule uma iniciativa a um orçamento de projeto do FinOps para ver o orçamento e o custo lançado junto do trabalho.
Como preencher

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.

ObjetivoTítulo, descrição, Responsável do Time de Dados, ano fiscal, categoria estratégica, prioridade, status (Rascunho / Planejado / Em andamento / Em risco / Concluído / Cancelado).
Resultado-chaveTítulo, objetivo vinculado, tipo de métrica (Porcentagem, Moeda, Numérico, SLA, Booleano, Pontuação), valor inicial, meta, valor atual, prazo.
IniciativaTítulo, descrição, tipo, objetivos e resultados-chave vinculados, responsáveis na equipe de dados, stakeholders, plataformas, domínios, prioridade, status, datas de início e fim, progresso, marcos e um orçamento de projeto do FinOps vinculado.
Alterar só o que é seu

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.

ItemO membro pode alterar quando
ObjetivoEle é o responsável. Os objetivos que ele cria são dele.
Resultado-chaveEle é o responsável, ou é responsável pelo objetivo. Ele só adiciona resultados-chave a objetivos que são dele e só lança progresso em resultados-chave que são dele.
IniciativaEle é um dos responsáveis na equipe de dados, ou a iniciativa serve a um objetivo dele. As iniciativas que ele cria o incluem entre os responsáveis.

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.

Notas de acesso
projects_adminAcesso total. Pode criar, editar e excluir objetivos, resultados-chave e iniciativas, ou só os que são dele quando um admin o restringe.
projects_contributorPode criar e atualizar objetivos, resultados-chave e iniciativas, ou só os que são dele quando um admin o restringe. Excluir exige projects_admin.
projects_viewerAcesso somente leitura a todas as páginas de Projetos.
Módulo

FinOps

O que é

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

Para que serve
Inteligência de custosVeja o gasto planejado vs. realizado por plataforma e categoria, mês a mês, em uma só visão.
PlanejamentoMonte o orçamento da plataforma de dados por ferramenta e categoria para o ano fiscal.
RealizadoRegistre o gasto mensal real, com lançamento assistido por IA a partir de faturas e folha nos planos Corporate.
Análise de variaçãoAcompanhe a variação entre orçamento e realizado automaticamente e perceba estouros cedo.
Como preencher

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.

Seções do FinOps

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

SeçãoO que cobre
PlataformaCusto da plataforma: orçamento e realizado por recurso, e as faturas enviadas.
Time (folha)Orçamentos dos squads, totais da equipe e folha por pessoa.
ProjetosOrçamentos de projeto e lançamentos de custo das iniciativas.

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.

Notas de acesso
finops_adminPode criar, editar e excluir linhas de orçamento, realizado e orçamentos de projeto nas seções que tem. Tem todas as seções, a menos que um admin o restrinja.
finops_contributorMesma leitura que finops_viewer. Alterar dados do FinOps exige finops_admin.
finops_viewerAcesso somente leitura às seções do FinOps que tem.
Inteligência

Avaliação 360

O que é

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°

Para que serve
Visão da saúdeTenha um retrato consolidado, pronto para a liderança, da sua organização de dados em todos os módulos.
Por períodoGere uma avaliação por período e acompanhe como a organização evolui.
RecomendaçõesVeja pontos fortes, lacunas e próximos passos sugeridos pela IA.
ColaboraçãoRegistre comentários e feedback em cada avaliação para alinhar as partes interessadas.
Como preencher

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.

Notas de acesso
intelligence_adminAcesso total. Pode ver avaliações e gerar novas.
intelligence_contributorPode ver avaliações e gerar novas.
intelligence_viewerSomente leitura. Pode ver avaliações e publicar comentários e feedback.
Inteligência é um módulo de permissão próprio (a Avaliação 360 é, por enquanto, o único recurso dele). As funções da organização (org_admin, org_member, org_contributor, org_viewer) incluem acesso a Inteligência no nível delas. Uma avaliação cobre todos os módulos, mas cada leitor vê só o que as próprias funções permitem: a seção financeira exige todas as seções do FinOps, orçamentos e custos de iniciativas exigem a seção Projetos do FinOps, e a seção de pessoas exige leitura em Pessoas. A Avaliação 360 também é um recurso de IA, disponível no plano Corporate e acima. Nos planos Free e Business, ela aparece na barra lateral com o selo Assinar e não pode ser acessada.
Leitores de negócio

Visão de Negócio

O que é

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 · Encontrar · Status · O que vem por aí · Guias

Quem vê
Assentos de visualizadorMembros cuja única função é business_viewer caem na Visão de Negócio ao entrar e não podem abrir nada além da própria página de conta. As páginas dos módulos os mandam de volta para ela, e toda API de módulo responde a eles com 403.
Equipe de dadosAbre pela Visão de Negócio na barra lateral e vê exatamente o que um assento de visualizador vê, com Voltar ao Klarun no cabeçalho.
PlanosTodos os planos, inclusive o Free. Os assentos de visualizador são ilimitados em todos os planos, então a Visão de Negócio nunca pede upgrade.
O que cada página mostra
PáginaMostraNunca mostra
InícioUma linha com o status dos dados, uma caixa de busca, os espaços de trabalho com o número de relatórios (os maiores primeiro, 15 por vez, com Mostrar mais para o resto) e cartões para O que vem por aí, os guias e o contato da equipe de dados.Nada que as outras páginas não mostrem.
EncontrarRelatórios Ativos e em Manutenção: nome, descrição, área, ferramenta, espaço de trabalho, frequência de atualização, visualizações nos últimos 30 dias, um selo de confiança, um aviso de migração, etiquetas de endosso e Abrir no {tool}, que abre o relatório pelo Klarun. Busque por palavras ou filtre por área, espaço de trabalho, ou por uma métrica ou campo do modelo de dados do relatório. Enquanto houver um problema aberto, um aviso fica acima dos filtros.O e-mail do responsável, o link do relatório em si, ids de espaço de trabalho, de dataset e de plataforma, os nomes do modelo de dados e relatórios Descontinuados ou em Revisão Pendente.
StatusIncidentes P1 a P3 abertos, em palavras simples: Indisponível, Degradado ou Problema menor; Em tratamento, ou Correção aplicada, em monitoramento; as áreas afetadas; e quando os dados devem voltar. Um incidente que ninguém atualiza há 3 dias recebe Status não confirmado recentemente.Incidentes P4, descrições, causas raiz, resoluções, quem está atribuído, o serviço e números de incidente.
O que vem por aíSó as iniciativas publicadas, como Em andamento, Planejado, Entregue recentemente (90 dias) e Pausado: título, tipo, áreas, datas, progresso, marcos e nomes dos stakeholders.Iniciativas não publicadas, ideias, trabalho cancelado, descrições, prioridade, riscos, o motivo de uma pausa, orçamentos, resultados-chave, objetivos, responsáveis, plataformas e o e-mail de qualquer pessoa.
GuiasOs itens de onboarding que os admins de Pessoas publicam, em seções que abrem e fecham: um link abre em nova aba, um arquivo é baixado e um texto abre em uma janela para leitura.Itens que ninguém publicou, o propósito, as ferramentas e os cargos anotados para a equipe de dados, onde os arquivos ficam e quem adicionou um item.

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). Nenhum leitor, id ou palavra buscada é guardado com elas, e nada do que um leitor de negócio faz altera qualquer outro dado.

Selos de confiança e avisos de migração

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.

#SeloQuando
1Problema aberto afetando este relatórioUm incidente P1 a P3 aberto vincula o relatório ou o modelo semântico dele; em vermelho para um P1. Diz quando o relatório deve voltar e leva ao incidente em Status.
2Em manutençãoO status do relatório é Manutenção.
3Problema aberto nos dados de {area}Um incidente P1 ou P2 aberto na área do relatório. O relatório pode ser afetado, e o selo diz isso.
4CertificadoO relatório tem o endosso Certificado no Power BI ou no Fabric.

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.

Como configurar

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.

ConfiguraçãoO que faz
PáginasLiga ou desliga Encontrar relatórios, Status dos dados, O que vem por aí e Guias. As duas primeiras começam ligadas; O que vem por aí e Guias começam desligadas. A chave decide se a empresa mostra a página; o que O que vem por aí e Guias mostram é publicado item a item pela equipe de dados. Uma página desligada sai do cabeçalho, e os assentos de visualizador recebem uma mensagem de página indisponível.
Contato do time de dadosUm e-mail, um link do Microsoft Teams ou um link https da sua central de serviços, mostrado como Abra um chamado para o time de dados. Aparece na página inicial e em cada relatório.
Completude da Visão de NegócioPara quem gerencia: quantos relatórios visíveis têm responsável e descrição, e os incidentes abertos sem atualização há 3 dias.
Ver como leitor de negócioAbre a Visão de Negócio como um assento de visualizador a vê. Páginas desligadas continuam abrindo para você, sob uma faixa de Prévia.
Como está sendo usadaPara quem gerencia: por semana, os assentos de visualizador que entraram, relatórios abertos, buscas e aberturas por busca. Só contagens: ninguém é identificado e as palavras buscadas não são guardadas.
Publicar em O que vem por aí

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.

Publicar guias

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.

Áreas

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ção

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.

CampoDescrição
Nome da organizaçãoNome de exibição da organização, mostrado em todo o app.
DescriçãoDescrição curta da sua equipe ou organização de dados.
SetorO setor da empresa. Dá à Avaliação 360 o contexto do seu setor.
Tamanho da empresaFaixa de funcionários da empresa inteira (não só da equipe de dados).
SiteURL do site da empresa.
País / RegiãoPaís da sede da organização.
Fuso horárioUsado nas métricas de incidentes (MTTR e MTTA por dia local) e pela Avaliação 360.
Início do ano fiscalO mês em que o ano fiscal começa. Afeta os períodos do FinOps.

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

01
Crie um registro de aplicativo no Azure

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.

02
Não adicione permissões de API

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.

03
Permita que service principals chamem as APIs do Power BI

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 APIs
04
Permita acesso somente leitura às APIs de administração

No 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 APIs
05
Crie um segredo do cliente

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

06
Conecte no Klarun

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.

Por que a API de administração? A API padrão do Power BI só devolve os workspaces dos quais o service principal é membro direto, o que, para um registro novo, é nenhum. A API de administração devolve todos os workspaces do locatário, e é por isso que o passo 04 é obrigatório, não opcional. A função Administrador do Fabric só é necessária se você ativar “Atribuir automaticamente a função Visualizador aos workspaces” ao conectar, o que permite à sincronização ler os metadados das tabelas do Lakehouse.

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.

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.

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: 5 no Free, 10 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

TipoComportamento
Link de uso múltiploQualquer pessoa com o link pode entrar. Expira em 30 dias.
Convite por e-mailSó um endereço de e-mail específico pode usar este código.
Convite por domínioQualquer pessoa com e-mail de um domínio especificado pode entrar.
Link de uso únicoUma única pessoa. Expira em 7 dias.

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.

Controle de acesso

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çãoDescrição
org_adminAcesso total a todos os módulos e a todas as configurações da organização, inclusive cobrança.
org_memberA segunda função mais alta. Acesso total a todos os módulos e pode gerenciar todas as configurações da organização, exceto cobrança. Não pode conceder a função de admin.
org_contributorPode criar e editar conteúdo em todos os módulos. Sem acesso às configurações da organização.
org_viewerAcesso somente leitura a toda a organização.
business_viewerSó a Visão de Negócio: encontrar um relatório, ver o que está com problema, com quem falar e o que vem por aí, em palavras simples. Não tem acesso a módulos. Para qualquer coisa além disso, use um assento de equipe de dados com uma função de módulo.

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.

MóduloAdminContribuidorVisualizador
Relatóriosreporting_adminreporting_contributorreporting_viewer
Governançagovernance_admingovernance_contributorgovernance_viewer
Plataformaplatform_adminplatform_contributorplatform_viewer
Pessoaspeople_adminpeople_contributorpeople_viewer
Projetosprojects_adminprojects_contributorprojects_viewer
FinOpsfinops_adminfinops_contributorfinops_viewer
Inteligênciaintelligence_adminintelligence_contributorintelligence_viewer

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.

AçãoAdminContribuidorVisualizador
Ver todo o conteúdo✓✓✓
Criar, editar e excluir registros✓✓—
Gerenciar as configurações da organização✓——
Gerenciar membros e funções✓——
Gerenciar integrações✓——
Gerar e compartilhar links de convite✓——
As funções são atribuídas em Configurações → Membros. Selecione um membro, clique em Editar funções e escolha entre todas as funções da organização e de módulo disponíveis. As mudanças valem no próximo carregamento de página.
Controle de acesso

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 três escopos

MóduloOpçõesSem escolha
FinOpsSeções: Plataforma, Time (folha), Projetos. Ao menos uma.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.
ProjetosTudo o que a função permite, ou Apenas o que é de sua responsabilidade.Tudo o que a função permite. A leitura continua aberta nos dois casos: o escopo restringe o que o membro pode alterar.
PessoasTodos que a função permite, ou A própria pessoa e quem se reporta a ela.Todos que a função permite.

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.

OndeO que um escopo muda
Avaliação 360A seção financeira exige todas as seções do FinOps, orçamentos e custos de iniciativas exigem a seção Projetos, e a seção de pessoas exige acesso de Pessoas à equipe inteira.
Importações e lançamento com IAUploads de orçamento e de realizado, leitura de faturas e de folha, e o lançamento assistido por IA exigem a seção em que escrevem, verificada antes de ler qualquer arquivo ou gastar qualquer orçamento de IA.
Seletores em outros módulosListam todos os membros da equipe só com nome e status, para que objetivos e iniciativas possam ser atribuídos. Nenhum outro dado de Pessoas vai junto.

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, e membros da equipe editando ou vinculando o próprio registro. 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.