yaml/xyz/openbmc_project/Telemetry/Trigger.interface.yaml

description: >
    Implement this interface to provide trigger inspection features. An
    implementation service should additionally implement
    xyz.openbmc_project.Object.Delete for deletion of individual trigger.

properties:
    - name: Discrete
      type: boolean
      description: >
          If true than trigger uses discrete thresholds as threshold conditions.
          Otherwise numeric thresholds is used.
      flags:
          - const
    - name: TriggerActions
      type: array[enum[self.TriggerAction]]
      description: >
          Defines actions which are taken when threshold conditions are met.
      flags:
          - const
    - name: Persistent
      type: boolean
      description: Defines if Trigger is stored in non volatile memory.
    - name: Reports
      type: array[object_path]
      description: >
          Collection of Report objects that are updated when threshold
          conditions are met. List is ignored if TriggerActions property does
          not contain 'UpdateReport' action.
    - name: Sensors
      type: array[dict[object_path,string]]
      description: >
          Map of sensors that is monitored within trigger. D-Bus sensor path is
          used as map's key. Its value is a metadata that is used to store user
          data about sensor. In Redfish, metadata will be set to endpoint
          corresponding to that sensor.
    - name: numericThresholds
      type: array[struct[enum[self.Type],uint64,enum[self.Direction],double]]
      description: >
          A collection of numeric thresholds that has following fields - type,
          dwell time, direction and threshold value. Array is limited by Type
          enumeration, only 4 elements are allowed. Dwell time specifies for how
          long condition has to persist to trigger an action.
    - name: discreteThresholds
      type: array[struct[string,enum[self.Severity],uint64,string]]
      description: >
          A collection of discrete thresholds that contains following fields -
          user id, severity, dwell time and threshold value. Discrete value does
          not need to be a number. Array size is not limited. If discrete
          threshold array is empty then every value change is taken into account
          of threshold condition. Dwell time specifies for how long condition
          has to persist to trigger an action.
    - name: Name
      type: string
      description: >
          Defines the name of trigger to be exposed over D-Bus.

enumerations:
    - name: TriggerAction
      description: >
          Defines a action which is taken once threshold condition is met.
      values:
          - name: LogToJournal
            description: Trigger will log to journal.
          - name: LogToRedfishEventLog
            description: Trigger will log Redfish message.
          - name: UpdateReport
            description: >
                Trigger will update reports. Reports that will be updated are
                specified in ReportNames property.
    - name: Type
      description: >
          Defines a context of a message that is logged when numeric threshold
          condition is met.
      values:
          - name: LowerCritical
          - name: LowerWarning
          - name: UpperWarning
          - name: UpperCritical
    - name: Direction
      description: >
          Defines in which direction threshold value is crossed to fulfill
          numeric threshold condition.
      values:
          - name: Either
            description: >
                Crossing threshold value fulfill numeric threshold condition.
          - name: Decreasing
            description: >
                If threshold value is crossed and previous sensor value was
                greater then threshold value then numeric threshold condition is
                met.
          - name: Increasing
            description: >
                If threshold value is crossed and previous sensor value was less
                then threshold value then numeric threshold condition is met.
    - name: Severity
      description: >
          Defines a context of a message that is logged when discrete threshold
          condition is met.
      values:
          - name: OK
          - name: Warning
          - name: Critical