Guia de Implementação › Implementação › Criação de script de lógica de negócios (Especialista em lógica de negócios) › Dentro da lógica de negócios › Comentários de causa raiz da violação e comentários de evento

Comentários de causa raiz da violação e comentários de evento

O comentário de causa raiz da violação pode ser definido na lógica de negócios para explicar os resultados de nível de serviço. Os comentários de causa raiz da violação são associados às métricas.

Também é possível gerar anotações do evento que são comentários associados aos eventos de dados brutos, em vez de associados à métrica. Esses dois tipos de comentários podem ser visualizados nos dados do relatório.

Dois métodos no objeto de ferramentas da lógica de negócios permitem a criação de causa raiz da violação e registros de anotações do evento:

• Tools.AddRootCauseComment (Texto, Data e hora, [resourceId])
• Salva um comentário de causa raiz. Essa informação pode ser útil posteriormente na geração de relatórios. O comentário de causa raiz salvo explica uma situação específica durante a execução da fórmula de lógica de negócios em um momento específico. O parâmetro de informações especifica o comentário que deve ser gravado. O método recebe uma data e hora a serem salvas junto com o comentário. Ele também aceita um parâmetro ResourceId, especificando o recurso relacionado ao contexto do método. (Esse parâmetro é opcional e pode ser omitido).
• Tools.AddEventAnnotation (EventId, Texto)
• Esses métodos podem ser usados em qualquer lugar da lógica de negócios, e o contexto do local onde se aplicam precisa ser levado em consideração. Adicionar um comentário de causa raiz pode ser mais relevante no final de um período de cálculo, quando o motivo para o nível de serviço ser menor do que o esperado para esse período é conhecido. Vamos supor que, por exemplo, durante o período de um mês ocorreram quatro interrupções, todas causadas por um único dispositivo. O comentário de causa raiz pode ser compilado a partir de algumas dessas informações sobre as interrupções, de modo que quando os relatórios forem exibidos para esse período, será possível ver o que contribuiu para qualquer violação de nível de serviço durante esse tempo. O comando AddRootCauseComment é mais adequado para a rotina do manipulador de eventos OnPeriodEnd ou outra função similar que é executada no final do período que está sendo calculado.
• Adicionar uma anotação do evento, no entanto, é mais adequado para o processamento de eventos de dados brutos e favorece seu uso para o OnXXXEvent (o manipulador de eventos personalizado especificado na declaração do registro). Nesse manipulador de eventos, todos os campos específicos do evento em questão estão disponíveis por meio do objeto eventDetails.
• Veja um exemplo de como isso pode ser na lógica de negócios:

  Sub OnPeriodEnd(Time)
          pctAvailable = (TotalTime-OutageTime) / TotalTime
          Tools.AddRootCauseComment “Violations caused by the
     following items: ” & ViolationCollection, Time
  End Sub
  …
  …
  Sub OnIncidentEvent(eventDetails)
      OutageTime = OutageTime + eventDetails(“TimeToResolve”)
  
      If eventDetails(“TimeToResolve”) > 6 Then
          ViolationCollection = ViolationCollection &
      eventDetails(“HardwareId”)
          Tools.AddEventAnnotation eventDetails.EventId, “Incident “ _
            eventDetails(“IncidentId”) & “ not resolved within target
      time 6 hours”
      End If
  End Sub