Desvio

Documentação: Funcionalidade de Desvio

1. Visão Geral

A funcionalidade de Desvio no Lighthouse foi desenvolvida para comparar valores entre diferentes colunas ou períodos de forma nativa, dinâmica e simplificada.

• Objetivo Principal: Facilitar a visualização de variações de custos (ex: Orçado vs. Realizado) e a análise detalhada de descontos contratuais (ex: AWS SPP e EDP).

---

2. Tipos de Desvio

Existem dois modelos principais de configuração para atender diferentes necessidades analíticas:

A. Desvio entre Colunas (Desvio de Dados)

Compara valores entre dois campos distintos dentro do mesmo conjunto de dados.

• Caso de Uso Comum: Calcular a diferença entre o Custo Unblended (custo bruto) e o Custo Net Unblended (custo com descontos aplicados). Isso permite mensurar o impacto real de descontos como SPP e EDP em comparação ao uso On-Demand.

• Importância dos Filtros: Para análises de descontos, a aplicação de filtros de utilização é crucial. Sem o refinamento adequado, os valores das colunas podem coincidir, mascarando o desvio real.

B. Desvio de Período

Compara os valores de um mesmo campo em intervalos de tempo diferentes (análise temporal).

• Configuração: O usuário seleciona a granularidade do período (diário, semanal ou mensal) e define o intervalo de comparação (ex: comparar o custo de hoje com o mesmo dia na semana anterior: D1 vs D-7).

---

3. Casos de Uso Identificados

• Orçamento vs. Realizado: Comparação essencial para o controle financeiro, permitindo identificar rapidamente desvios de orçamento.

• Monitoramento de Infraestrutura: Uso de intervalos não contínuos para monitorar o comportamento de recursos (ex: detectar picos de consumo entre comparações semanais ou mensais)

---

4. Benefícios da Funcionalidade

• Agilidade: Simplificação no processo de BI para criar desvios e comparativos

• Visualização Dinâmica: Os desvios são recalculados automaticamente conforme os filtros de data e categoria são aplicados na plataforma.

---

Para acesso e utilização na plataforma:

Passo 1: Em Workspaces, selecione o Workspace desejado;

Passo 2: Dentro do Workspace, selecione Nova Visualização;

Passo 3: Clicar na opção de "Configuração"

Passo 4: Ao deslizar nas opções na lateral, a função desvio estará no final da seção.

Passo 5: Ao selecionar desvio, você terá a opção de adicionar os campos para criação da sua visualização.

---

Desvio de Dados

Passo 1: Selecione o desvio desejado:

• Desvio de Dados - Compara valores entre dois campos diferentes.

• Desvio de Período - Compara valores do mesmo campo em períodos diferentes.

após isso, clique em próximo.

Passo 2: Na aba de "Cálculo", temos duas opções para criação da visualização:

• Desvio Nominal: Diferença absoluta entre dois valores (Primeiro Campo - Segundo Campo).

• Desvio Percentual: Diferença percentual entre dois valores ((Primeiro Campo- Segundo Campo) / Segundo Campo * 100)

Passo 3: Na aba de "Primeiro Campo" você fará a configuração dos campos e expressões.

Nesta etapa, você deve definir as métricas que irão compor o cálculo do desvio:

• Primeiro Campo (Métrica Base): Selecione o campo principal para a análise. Defina a Expressão (ex: SOMA, MÉDIA, CONTAGEM) que determinará como os dados brutos serão processados.

Comparação de Expressões: O Lighthouse permite comparar diferentes agregadores entre si. Você pode, por exemplo, confrontar a Média de um indicador com a Soma de outro, permitindo uma análise comparativa flexível e a geração de insights personalizados sobre o comportamento dos dados.

Passo 4: Na aba de "Segundo Campo", você configurará a métrica que será utilizada como o valor a subtrair da equação (o valor que será deduzido do Primeiro Campo).

Nesta etapa, você define o comparativo para gerar o desvio:

• Segundo Campo (Métrica de Comparação): Selecione o campo que será subtraído do valor base. Assim como no passo anterior, escolha a Expressão adequada (ex: SOMA, MÉDIA, CONTAGEM) para consolidar esses valores.

Comparação de Expressões: O Lighthouse permite comparar diferentes agregadores entre si. Você pode, por exemplo, confrontar a Média de um indicador com a Soma de outro, permitindo uma análise comparativa flexível e a geração de insights personalizados sobre o comportamento dos dados.

Passo 5: Na aba de "Configuração", temos algumas opções para configurar o resultado da sua equação, permitindo que voce personalize o nome

Geral:

• Apelido: informe um apelido a ser exibido na coluna;

Configuração:

• Ordenação: Opção para ordenar a exibição dos dados de do maior para o menor, como por exemplo, do maior desconto para o menor.

• Orientação: Eixo do gráfico, direito ou esquerdo.

Formatar

• Para campos do tipo número:

  • Decimais: Quantidade de casas decimais utilizado na visualização;

  • Unidade: Unidade de medida do campo em questão (USD, BRL, MEX, CNY, EUR, ANG, COP, DOP, ARS, PEN, UYU, MB, GB, TB, Percent).

  • Notação: Notação que pode ser utilizada no campo (Compacta e Científica).

• Regras de cor: Defina cores personalizadas que serão aplicadas automaticamente conforme os critérios estabelecidos.

  • Regra: Selecione a condição lógica desejada (entre, maior que, menor que, maior ou igual a, menor ou igual a).

  • Valor: Informe o valor numérico de referência para a validação da regra.

  • Cor: Escolha a cor que será aplicada ao campo quando o critério acima for atendido.

Segmentar por

• Prefixo: Entre com o nome correspondente ao campo

• Campo: Selecione a informação que irá agrupar e sumarizar os valores de seu gráfico, por exemplo, total por região;

• Quantidade: Informe a quantidade de itens que serão visualizados no gráfico, exemplo 10 maiores valores.

• Agrupar excedente em Outros: Selecione essa opção caso deseje agrupar o excedente em um novo tipo chamado Outros.

• Manter agrupado: Habilite esta opção caso deseje que as novas colunas sejam agrupadas sob a referência da coluna original.

Gráfico

• Tipo de Visualização: Selecione entre gráfico de linhas, de áreas ou de barras.

---

Desvio de Período

Passo 1: Selecione o desvio desejado:

• Desvio de Dados - Compara valores entre dois campos diferentes.

• Desvio de Período - Compara valores do mesmo campo em períodos diferentes.

após isso, clique em próximo.

Passo 2: Na aba de "Cálculo", temos duas opções para criação da visualização:

• Desvio Nominal: Diferença absoluta entre dois valores (Primeiro Campo - Segundo Campo).

• Desvio Percentual: Diferença percentual entre dois valores ((Primeiro Campo- Segundo Campo) / Segundo Campo * 100)

Passo 3: Na aba de "Primeiro Campo" você fará a configuração dos campos e expressões.

Nesta etapa, você deve definir as métricas que irão compor o cálculo do desvio:

• Primeiro Campo (Métrica Base): Selecione o campo principal para a análise. Defina a Expressão (ex: SOMA, MÉDIA, CONTAGEM) que determinará como os dados brutos serão processados.

Comparação de Expressões: O Lighthouse permite comparar diferentes agregadores entre si. Você pode, por exemplo, confrontar a Média de um indicador com a Soma de outro, permitindo uma análise comparativa flexível e a geração de insights personalizados sobre o comportamento dos dados.

Passo 4: Na aba de "Periodo", você fará a configuração do intervalo de período.

Defina o período para calcular o desvio dos valores do campo. Por exemplo, se você definir '3 meses', o desvio será calculado com base no período menos os últimos 3 meses de dados disponíveis no conjunto de dados.

Passo 5: Na aba de "Configuração", temos algumas opções para configurar o resultado da sua equação, permitindo que voce personalize o nome

Geral:

• Apelido: informe um apelido a ser exibido na coluna;

Configuração:

• Ordenação: Opção para ordenar a exibição dos dados de do maior para o menor, como por exemplo, do maior desconto para o menor.

• Orientação: Eixo do gráfico, direito ou esquerdo.

Formatar

• Para campos do tipo número:

  • Decimais: Quantidade de casas decimais utilizado na visualização;

  • Unidade: Unidade de medida do campo em questão (USD, BRL, MEX, CNY, EUR, ANG, COP, DOP, ARS, PEN, UYU, MB, GB, TB, Percent).

  • Notação: Notação que pode ser utilizada no campo (Compacta e Científica).

• Regras de cor: Defina cores personalizadas que serão aplicadas automaticamente conforme os critérios estabelecidos.

  • Regra: Selecione a condição lógica desejada (entre, maior que, menor que, maior ou igual a, menor ou igual a).

  • Valor: Informe o valor numérico de referência para a validação da regra.

  • Cor: Escolha a cor que será aplicada ao campo quando o critério acima for atendido.

Segmentar por

• Prefixo: Entre com o nome correspondente ao campo

• Campo: Selecione a informação que irá agrupar e sumarizar os valores de seu gráfico, por exemplo, total por região;

• Quantidade: Informe a quantidade de itens que serão visualizados no gráfico, exemplo 10 maiores valores.

• Agrupar excedente em Outros: Selecione essa opção caso deseje agrupar o excedente em um novo tipo chamado Outros.

• Manter agrupado: Habilite esta opção caso deseje que as novas colunas sejam agrupadas sob a referência da coluna original.

Gráfico

• Tipo de Visualização: Selecione entre gráfico de linhas, de áreas ou de barras.

---

Exemplo de uso Pratico - Comparativo de custo de produto - Mês Atual x Mês Anterior.

A nova funcionalidade de Desvio permite a comparação direta entre o gasto atual e o gasto do período anterior (mês a mês) para produtos AWS dentro do Lighthouse. A solução substitui o uso de subqueries complexas por campos calculados utilizando a função lag, garantindo maior performance e precisão na visualização dos dados.

O que a funcionalidade entrega:

• Comparação Binária: Exibe, na mesma linha, o custo do mês atual e o custo do mês anterior para cada produto.

• Métricas de Desvio: Calcula automaticamente o Desvio Absoluto (valor em moeda) e o Desvio Percentual (%) entre os períodos.

• Inteligência de Visualização: Utiliza a função lag para buscar o histórico sem sobrecarregar o banco de dados.

  • Permite a segmentação personalizada (ex: por Produto, Região ou Tag).

  • Inclui o recurso de ocultação de linhas irrelevantes, mantendo o foco apenas no período de referência atual, mesmo que o produto não tenha tido gastos no mês anterior (evitando "buracos" na análise de contas novas).

Para acesso e utilização na plataforma:

Passo 1: Em Workspaces, selecione o Workspace desejado;

Passo 2: Dentro do Workspace, selecione Nova Visualização;

Passo 3: Para esse caso específico, se faz necessário os seguintes passos:

• Incluir o campo - bill/billingperiodstartdate

• Incluir o campo - product/productname

• Incluir o campo - product/region

• Nas configurações do campo, ajustar a formatação para mensal.

Passo 4: Acesse a aba de "Configurações" e selecione "Expandir competência para...."

• Defina o campo como Dinâmico.

• Ajuste o segundo período para 0.

• Isso permitirá comparar os dados do mês anterior com os do mês atual.

Passo 5: Retornando na aba de "Campos", será necessário adicionar o campo - lineitem/unblendedcost , para trazer os valores de custo.

Passo 6: Criação de Campo Calculado para Custos Retroativos.

Nesta etapa, vamos criar um Campo Calculado. Essa funcionalidade permite customizar dados existentes para extrair informações específicas — neste caso, os custos do mês anterior.

Procedimento de Acesso:

1. No painel lateral de Configuração, localize o ícone de três pontos (⋮) ao lado do nome.

2. Clique na opção "Campos Personalizados".

3. Uma nova sessão será aberta em seu navegador com o menu de criação.

Passo 7: Para a criação do seu campo calculado, basta seguir os passos abaixo onde ja trazemos um modelo que possa ser utilizados para esse caso.

• Ação: Selecionar a opção "Adicionar Campo".

• Nome do Campo: Utilize um identificador curto e padronizado (ex: last_month_cost_productname).

• Tipo de Dados: Selecione Number, pois o campo processará valores monetários.

• Descrição (Opcional): Ex: "Calcula o custo do produto no mês anterior para análise comparativa."

• Conector de Dados: Selecionar "AWS Billing".

Definir SQL

Copie e cole o bloco abaixo para criar a lógica de cálculo:

SQL

(
  LAG(SUM("lineitem/unblendedcost"), 1) OVER (
    PARTITION BY "product/productname", "product/region"
    ORDER BY DATE_FORMAT("bill/billingperiodstartdate", '%y-%m')
  )
)

Entendendo a Lógica (O que o SQL faz?)

1. Função LAG ("Olhar para trás"): O numeral 1 indica que o sistema buscará o valor da linha imediatamente anterior. No seu caso, o custo total (unblendedcost) do período passado.

2. PARTITION BY (Organização): O cálculo é isolado por Produto (ex: Amazon EC2) e Região (ex: sa-east-1). Isso evita que o custo do S3 em São Paulo seja comparado erroneamente com o EC2 na Virgínia.

3. ORDER BY (Linha do Tempo): Organiza os dados cronologicamente por mês e ano (%y-%m), garantindo que o "mês anterior" siga a ordem correta do calendário.

Pontos de Atenção e Customização

• Comparativos Diários: Se desejar comparar dias em vez de meses, altere a formatação no SQL para %y-%m-%d e certifique-se de que o campo bill/billingperiodstartdate esteja configurado para granularidade diária.

• Obrigatoriedade de Visualização: Como utilizamos a cláusula ORDER BY, é obrigatório incluir o campo bill/billingperiodstartdate na construção da sua visualização (gráfico ou tabela). Além disso, por conta do PARTITION BY , também é necessário trazer os campos product/productname e product/region . Qualquer mudança no SQL, se faz necessário ajustar quais os campos a visualização precisa trazer.

• Uso do UsageStartDate: É possível substituir o campo de cobrança pelo lineitem/usagestartdate. Caso opte por essa mudança, lembre-se de atualizar a referência manualmente dentro do código SQL acima.

Retornando para aba onde temos o desenvolvimento da view, será necessário dar um "refresh" nos campos, para que o campo criado, venha para o contexto onde estamos trabalhando.

Passo 9: Agora, bastante digitar o nome do campo ou partes do campo criado que ele estará presente na lista de campos disponíveis para utilização. Após isso, arraste o campo até a sessão de "Dados" e no menu de configuração, selecione a expressão "Nenhum"

Passo 10: Após aplicarmos, o resultado trará os custos em linha, separados em bloco sendo o primeiro bloco está representando o mês anterior. Para removermos esse bloco, pois nosso foco é visualizar os custos do mês atual apenas, utilizamos a função de "Ocultar Linhas".

• Na aba de "Configurações", clique na opção "Ocultar Linhas"

• Clique no icone de "+" para adicionar um novo filtro.

• Será aberto um novo menu, onde será necessário adicionar o campo que deseja ocultar.

• Em "Coluna a Verificar", digite o campo de data utilizado na sua visão.

• Por fim, marque a opção - "Ocultar linhas fora do período selecionado no BI"

Passo 11: Agora, podemos voltar na função desvio e adicionar os desvios corretos para podermos fazer as comparações do custo do mês atual x mês anterior.

Na aba de "Configurações", na sessão abaixo em "Desvio", vamos adicionar agora os dois tipos de desvios: Desvio Nominal e Desvio Percentual.

• Desvio Nominal:

1. Tipo de Desvio - Desvio de Dados

2. Cálculo - Desvio Nominal

3. Primeiro Campo - lineitem/unblendedcost com expressão 'Soma'

4. Segundo Campo - custom criado com expressão 'Nenhum'

5. Configurações - Como desejar.

• Desvio Percentual:

1. Tipo de Desvio - Desvio de Dados

2. Cálculo - Desvio Percentual

3. Primeiro Campo - lineitem/unblendedcost com expressão 'Soma'

4. Segundo Campo - custom criado com expressão 'Nenhum'

5. Configurações - Como desejar.

Após todos os passos seguidos, sua visualização terá uma prévia como essa: