Guía de implementación › Implementación › Scripting de lógica de negocios (experto en la lógica de negocios) › Dentro de la lógica de negocios › Comentarios de causa raíz de infracción y comentarios de evento

Comentarios de causa raíz de infracción y comentarios de evento

El comentario de causa raíz de infracción se puede establecer en la lógica de negocios para explicar los resultados de nivel de servicio. Los comentarios de causa raíz de infracción se asocian a métricas.

También es posible generar anotaciones de eventos, que son comentarios asociados a los eventos de datos sin procesar, en lugar de a la métrica. Estos dos tipos de comentarios se pueden consultar en los datos de informe.

Hay dos métodos en el objeto "Tools" de la lógica de negocios que permiten crear registros de causa raíz de infracción y de anotaciones de eventos:

• Tools.AddRootCauseComment (Text, Timestamp, [resourceId])
• Guarda un comentario de causa raíz. Esta información puede ser útil posteriormente en informes generados. El comentario de causa raíz guardado explica una situación específica durante la ejecución de la fórmula de lógica de negocios en un momento concreto. El parámetro de información especifica el comentario que se deberá escribir. El método recibe una marca de tiempo que se guardará juntamente con el comentario. También acepta un parámetro ResourceId en el que se especifica el recurso relacionado con el contexto de método. (Este parámetro es opcional y se puede omitir).
• Tools.AddEventAnnotation (EventId, Text)
• Estos métodos se pueden utilizar en cualquier sitio dentro de la lógica de negocios y debe tenerse en cuenta el contexto de dónde se aplicarán. Añadir un comentario de causa raíz puede ser más relevante al final de un período de cálculo, cuando se conoce el motivo por el que el nivel de servicio es inferior a lo esperado para ese período. Supongamos que, por ejemplo, durante el período de un mes se han producido cuatro interrupciones, todas causados por un solo dispositivo. El comentario de causa raíz se podría entonces recopilar a partir de esta información acerca de las interrupciones, para que cuando se consulten los informes para este período, se pueda ver qué ha contribuido a cualquier incumplimiento de nivel de servicio durante este tiempo. El comando AddRootCauseComment es el más recomendable para la rutina del controlador de eventos OnPeriodEnd, o para otra función similar que se ejecute hacia el final del período calculado.
• No obstante, resulta más adecuado agregar una anotación del evento para el procesamiento de eventos de datos sin procesar, además de que facilita el uso para OnXXXEvent (el controlador de eventos personalizado especificado en la declaración de registro). Dentro de este controlador de eventos, todos los campos específicos del evento en sí están disponibles mediante el objeto eventDetails.
• Este sería un ejemplo del aspecto que esto podría tener dentro de la lógica de negocios:

  Sub OnPeriodEnd(Time)
          pctAvailable = (TotalTime-OutageTime) / TotalTime
          Tools.AddRootCauseComment “Incumplimientos causados por los
     elementos siguientes: ” & 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”) & “ no resuelto en el tiempo objetivo
      de 6 horas”
      End If
  End Sub