Pular para o conteúdo principal

kpi

kpi​

Função global utilizada para calcular métricas de desempenho e disponibilidade (Key Performance Indicators) baseadas nos dados históricos das entradas digitais.

kpi.mtbf​

Retorna o tempo médio entre falhas (Mean Time Between Failures) de um equipamento ou sistema em horas.

kpi.mtbf(di, period = 'g', mode = true);

Resposta: number tempo médio entre falhas em horas, ou 0 se não há dados suficientes.

Onde:

  • di: número da entrada digital (1 a DIs_MAX);
  • period: período de análise (opcional), sendo os possíveis valores:
    • "g": geral/total (valor padrão, se não informado);
    • "d": diário;
    • "m": mensal;
    • "y": anual;
  • mode: define qual estado representa falha (opcional):
    • true: falha quando DI = 1 (valor padrão, se não informado);
    • false: falha quando DI = 0.

Fórmula interna​

  • Se mode = true: (horas em estado 0) / quantidade de viradas para estado 1
  • Se mode = false: (horas em estado 1) / quantidade de viradas para estado 0

Exemplo 1​

Calcular o MTBF geral do DI1 (falha em estado 1):

kpi.mtbf(1);

Resposta: number tempo médio entre falhas em horas.

Exemplo 2​

Calcular o MTBF diário do DI2 (falha em estado 0):

kpi.mtbf(2, "d", false);

Resposta: number tempo médio entre falhas em horas no dia atual.

Exemplo 3​

Calcular o MTBF mensal do DI3:

kpi.mtbf(3, "m");

Resposta: number tempo médio entre falhas em horas no mês atual.


kpi.mttr​

Retorna o tempo médio para reparo (Mean Time To Repair) após uma falha em horas.

kpi.mttr(di, period = 'g', mode = true);

Resposta: number tempo médio para reparo em horas, ou 0 se não há dados suficientes.

Onde:

  • di: número da entrada digital;
  • period: período de análise (opcional), sendo os possíveis valores:
    • "g": geral/total (valor padrão, se não informado);
    • "d": diário;
    • "m": mensal;
    • "y": anual;
  • mode: define qual estado representa falha (opcional):
    • true: falha quando DI = 1 (valor padrão, se não informado);
    • false: falha quando DI = 0.

Fórmula interna​

  • Se mode = true: (horas em estado 1 / 3600) / quantidade de pulsos para estado 0
  • Se mode = false: (horas em estado 0 / 3600) / quantidade de pulsos para estado 1

Exemplo 1​

Calcular o MTTR geral do DI1 (falha em estado 1):

kpi.mttr(1);

Resposta: number tempo médio para reparo em horas.

Exemplo 2​

Calcular o MTTR anual do DI4 (falha em estado 0):

kpi.mttr(4, "y", false);

Resposta: number tempo médio para reparo em horas no ano atual.

Exemplo 3​

Calcular o MTTR diário do DI2:

kpi.mttr(2, "d");

Resposta: number tempo médio para reparo em horas no dia atual.


kpi.availability​

Retorna a disponibilidade de um sistema em porcentagem, considerando o tempo total de operação versus o tempo de falha.

kpi.availability(di_disp, di_falha, period = 'g', di_falha_mode = true);

Resposta: number disponibilidade em porcentagem (0-100%), ou 0 se não há dados suficientes.

Onde:

  • di_disp: número da entrada digital que mede a operação da falha;
  • di_falha: número da entrada digital de falha;
  • period: período de análise (opcional), sendo os possíveis valores:
    • "g": geral/total (valor padrão, se não informado);
    • "d": diário;
    • "m": mensal;
    • "y": anual;
  • di_falha_mode: define qual estado do DI de falha representa falha (opcional):
    • true: falha quando di_falha = 1 (valor padrão, se não informado);
    • false: falha quando di_falha = 0.

Fórmula interna​

  • Se di_falha_mode = true: 100 * (horas sem falha / total de horas de disponibilidade)
  • Se di_falha_mode = false: 100 * (horas com falha / total de horas de disponibilidade)

Exemplo 1​

Calcular a disponibilidade geral - DI 1 para disponibilidade, DI 2 para falha:

kpi.availability(1, 2);

Resposta: number disponibilidade em porcentagem.

Exemplo 2​

Calcular a disponibilidade mensal - falha em estado 0 do DI 3:

kpi.availability(1, 3, "m", false);

Resposta: number disponibilidade em porcentagem no mês atual.

Exemplo 3​

Calcular a disponibilidade diária:

kpi.availability(2, 4, "d");

Resposta: number disponibilidade em porcentagem no dia atual.


Exemplos de uso​