netconfcentral logo

openconfig-alarms

HTML

openconfig-alarms@2017-08-24



  module openconfig-alarms {

    yang-version 1;

    namespace
      "http://openconfig.net/yang/alarms";

    prefix oc-alarms;

    import openconfig-extensions {
      prefix oc-ext;
    }
    import openconfig-types {
      prefix oc-types;
    }
    import openconfig-platform {
      prefix oc-platform;
    }

    organization "OpenConfig working group";

    contact
      "OpenConfig working group
    www.openconfig.net";

    description
      "This module defines operational state data related to alarms
    that the device is reporting.

    This model reuses some data items defined in the draft IETF
    YANG Alarm Module:
    https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02

    Portions of this code were derived from the draft IETF YANG Alarm
    Module. Please reproduce this note if possible.

    IETF code is subject to the following copyright and license:
    Copyright (c) IETF Trust and the persons identified as authors of
    the code.
    All rights reserved.

    Redistribution and use in source and binary forms, with or without
    modification, is permitted pursuant to, and subject to the license
    terms contained in, the Simplified BSD License set forth in
    Section 4.c of the IETF Trust's Legal Provisions Relating
    to IETF Documents (http://trustee.ietf.org/license-info).";

    revision "2017-08-24" {
      description "Initial public release";
      reference
        "0.1.0";

    }

    oc-ext:openconfig-version "0.1.0";

    identity OPENCONFIG_ALARM_TYPE_ID {
      base 
      description
        "Base identity for alarm type ID profiles";
    }

    identity AIS {
      base OPENCONFIG_ALARM_TYPE_ID;
      description
        "Defines an alarm indication signal type of alarm";
    }

    identity EQPT {
      base OPENCONFIG_ALARM_TYPE_ID;
      description
        "Defines an equipment related type of alarm that is specific
       to the physical hardware";
    }

    identity LOS {
      base OPENCONFIG_ALARM_TYPE_ID;
      description
        "Defines a loss of signal type of alarm";
    }

    identity OTS {
      base OPENCONFIG_ALARM_TYPE_ID;
      description
        "Defines a optical transport signal type of alarm";
    }

    identity OPENCONFIG_ALARM_SEVERITY {
      base 
      description
        "Base identity for alarm severity profiles. Derived
      identities are based on contents of the draft
      IETF YANG Alarm Module";
      reference
        "IETF YANG Alarm Module: Draft - typedef severity
        https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02";

    }

    identity UNKNOWN {
      base OPENCONFIG_ALARM_SEVERITY;
      description
        "Indicates that the severity level could not be determined.
      This level SHOULD be avoided.";
    }

    identity MINOR {
      base OPENCONFIG_ALARM_SEVERITY;
      description
        "Indicates the existence of a non-service affecting fault
      condition and that corrective action should be taken in
      order to prevent a more serious (for example, service
      affecting) fault. Such a severity can be reported, for
      example, when the detected alarm condition is not currently
      degrading the capacity of the resource";
    }

    identity WARNING {
      base OPENCONFIG_ALARM_SEVERITY;
      description
        "Indicates the detection of a potential or impending service
      affecting fault, before any significant effects have been felt.
      Action should be taken to further diagnose (if necessary) and
      correct the problem in order to prevent it from becoming a more
      serious service affecting fault.";
    }

    identity MAJOR {
      base OPENCONFIG_ALARM_SEVERITY;
      description
        "Indicates that a service affecting condition has developed
      and an urgent corrective action is required. Such a severity
      can be reported, for example, when there is a severe
      degradation in the capability of the resource and its full
      capability must be restored.";
    }

    identity CRITICAL {
      base OPENCONFIG_ALARM_SEVERITY;
      description
        "Indicates that a service affecting condition has occurred
      and an immediate corrective action is required. Such a
      severity can be reported, for example, when a resource becomes
      totally out of service and its capability must be restored.";
    }

    grouping alarm-state {
      description
        "Operational state data for device alarms";
      leaf resource {
        type string;
        description
          "The item that is under alarm within the device. The
        resource may be a reference to an item which is
        defined elsewhere in the model. For example, it
        may be a platform/component, interfaces/interface,
        terminal-device/logical-channels/channel, etc. In this
        case the system should match the name of the referenced
        item exactly. The referenced item could alternatively be
        the path of the item within the model.";
        reference
          "IETF YANG Alarm Module: Draft - typedef resource
          https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02";

      }

      leaf text {
        type string;
        description
          "The string used to inform operators about the alarm. This
         MUST contain enough information for an operator to be able
         to understand the problem. If this string contains structure,
         this format should be clearly documented for programs to be
         able to parse that information";
        reference
          "IETF YANG Alarm Module: Draft - typedef alarm-text
          https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02";

      }

      leaf time-created {
        type oc-types:timeticks64;
        description
          "The time at which the alarm was raised by the system.
        This value is expressed as nanoseconds since the Unix Epoch";
      }

      leaf severity {
        type identityref {
          base OPENCONFIG_ALARM_SEVERITY;
        }
        description
          "The severity level indicating the criticality and impact
        of the alarm";
        reference
          "IETF YANG Alarm Module: Draft - typedef severity
          https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02";

      }

      leaf type-id {
        type union {
          type string;
          type identityref {
            base OPENCONFIG_ALARM_TYPE_ID;
          }
        }
        description
          "The abbreviated name of the alarm, for example LOS,
        EQPT, or OTS. Also referred to in different systems as
        condition type, alarm identifier, or alarm mnemonic. It
        is recommended to use the OPENCONFIG_ALARM_TYPE_ID
        identities where possible and only use the string type
        when the desired identityref is not yet defined";
        reference
          "IETF YANG Alarm Module: Draft - typedef alarm-type-id
          https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02";

      }
    }  // grouping alarm-state

    grouping alarm-config {
      description
        "Configuration data for device alarms";
      leaf id {
        type string;
        description
          "Unique ID for the alarm -- this will not be a
        configurable parameter on many implementations";
      }
    }  // grouping alarm-config

    grouping alarms-top {
      description
        "Top-level grouping for device alarms";
      container alarms {
        description
          "Top-level container for device alarms";
        list alarm {
          key "id";
          description
            "List of alarms, keyed by a unique id";
          leaf id {
            type leafref {
              path "../config/id";
            }
            description
              "References the unique alarm id";
          }

          container config {
            description
              "Configuration data for each alarm";
            uses alarm-config;
          }  // container config

          container state {
            config false;
            description
              "Operational state data for a device alarm";
            uses alarm-config;

            uses alarm-state;
          }  // container state
        }  // list alarm
      }  // container alarms
    }  // grouping alarms-top

    augment /oc-platform:components/oc-platform:component/oc-platform:state {
      description
        "Adds specific alarms related to a component.";
      leaf equipment-failure {
        type boolean;
        default "false";
        description
          "If true, the hardware indicates that the component's physical equipment
        has failed";
      }

      leaf equipment-mismatch {
        type boolean;
        default "false";
        description
          "If true, the hardware indicates that the component inserted into the
        affected component's physical location is of a different type than what
        is configured";
      }
    }
  }  // module openconfig-alarms

Summary

  
  
Organization OpenConfig working group
  
Module openconfig-alarms
Version 2017-08-24
File openconfig-alarms.yang
  
Prefix oc-alarms
Namespace http://openconfig.net/yang/alarms
  
Cooked /cookedmodules/openconfig-alarms/2017-08-24
YANG /src/openconfig-alarms@2017-08-24.yang
XSD /xsd/openconfig-alarms@2017-08-24.xsd
  
Abstract This module defines operational state data related to alarms that the device is reporting. This model reuses some data items de...
  
Contact
OpenConfig working group
www.openconfig.net

Description

 
This module defines operational state data related to alarms
that the device is reporting.

This model reuses some data items defined in the draft IETF
YANG Alarm Module:
https://tools.ietf.org/html/draft-vallin-netmod-alarm-module-02

Portions of this code were derived from the draft IETF YANG Alarm
Module. Please reproduce this note if possible.

IETF code is subject to the following copyright and license:
Copyright (c) IETF Trust and the persons identified as authors of
the code.
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, is permitted pursuant to, and subject to the license
terms contained in, the Simplified BSD License set forth in
Section 4.c of the IETF Trust's Legal Provisions Relating
to IETF Documents (http://trustee.ietf.org/license-info).

Groupings

Grouping Objects Abstract
alarm-config id Configuration data for device alarms
alarm-state resource text time-created severity type-id Operational state data for device alarms
alarms-top alarms Top-level grouping for device alarms