alarm.hpp

   1 // vi: ts=4 sw=4 noet:
   2 /*
   3 ==================================================================================
   4         Copyright (c) 2020 Nokia
   5         Copyright (c) 2020 AT&T Intellectual Property.
   6
   7    Licensed under the Apache License, Version 2.0 (the "License");
   8    you may not use this file except in compliance with the License.
   9    You may obtain a copy of the License at
  10
  11        http://www.apache.org/licenses/LICENSE-2.0
  12
  13    Unless required by applicable law or agreed to in writing, software
  14    distributed under the License is distributed on an "AS IS" BASIS,
  15    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  16    See the License for the specific language governing permissions and
  17    limitations under the License.
  18 ==================================================================================
  19 */
  20
  21 /*
  22         Mnemonic:       alarm.hpp
  23         Abstract:       Headers for the alarm class.
  24                                 This class provides for an alarm API.
  25
  26         Date:           15 July 2020
  27         Author:         E. Scott Daniels
  28 */
  29
  30 #ifndef _XAPP_ALARM_HPP
  31 #define _XAPP_ALARM_HPP
  32
  33
  34 #include <iostream>
  35 #include <string>
  36
  37 #include "msg_component.hpp"
  38
  39 namespace xapp {
  40
  41 // ------------------------------------------------------------------------
  42
  43 class Alarm {
  44         private:
  45                 std::shared_ptr<Message> msg;           // message to send
  46                 std::shared_ptr<char> psp;                      // shared pointer to the payload to give out
  47                 std::string endpoint =  "";                     // the ip:port addr:port of the alarm collector
  48                 int                     whid = -1;
  49
  50                                                                                         // data for the payload
  51                 std::string     me_id = "";                             // managed element ID
  52                 std::string app_id = "";                        // application ID
  53                 int                     problem_id  = -1;               // problem ID (specific problem)
  54                 std::string     severity = "";                  // set_sev() xlates from SEV_* consts to collector's string values
  55                 std::string info = "";                          // info string supplied by user
  56                 std::string add_info = "";                      // additional information supplied by user
  57
  58                 int build_alarm( int action_id, xapp::Msg_component payload, int payload_len );
  59
  60         public:
  61                 static const int        SEV_CRIT = 1;                   // allow translation to string on send/gen
  62                 static const int        SEV_MAJOR = 2;
  63                 static const int        SEV_MINOR = 3;
  64                 static const int        SEV_WARN = 4;
  65                 static const int        SEV_CLEAR = 5;
  66                 static const int        SEV_DEFAULT = 6;
  67
  68                 static const int        ACT_RAISE = 1;                  // action const map to alarm manager strings
  69                 static const int        ACT_CLEAR = 2;
  70                 static const int        ACT_CLEAR_ALL = 3;
  71
  72                 explicit Alarm( std::shared_ptr<Message> msg );         // builders
  73                 Alarm( std::shared_ptr<Message> msg, const std::string& meid  );
  74                 Alarm( std::shared_ptr<Message> msg, int prob_id, const std::string& meid  );
  75
  76                 Alarm( const Alarm& soi );                                      // copy to newly created instance
  77                 Alarm& operator=( const Alarm& soi );           // copy operator
  78                 Alarm( Alarm&& soi );                                           // mover
  79                 Alarm& operator=( Alarm&& soi ) noexcept;                       // move operator
  80                 ~Alarm();                                                                       // destroyer
  81
  82
  83                 std::string Get_endpoint( ) const;
  84
  85                 void Set_additional( const std::string& new_info );
  86                 void Set_appid( const std::string& new_id );
  87                 void Set_info( const std::string& new_info );
  88                 void Set_meid( const std::string& new_meid );
  89                 void Set_problem( int new_id );
  90                 void Set_severity( int new_sev );
  91                 void Set_whid( int whid );
  92
  93
  94                 bool Raise( );
  95                 bool Raise( int severity, int problem, const std::string& info );
  96                 bool Raise( int severity, int problem, const std::string& info, const std::string& additional_info );
  97                 bool Raise_again( );
  98
  99                 bool Clear( );
 100                 bool Clear( int severity, int problem, const std::string& info );
 101                 bool Clear( int severity, int problem, const std::string& info, const std::string& additional_info );
 102                 bool Clear_all( );
 103
 104
 105                 void Dump() const;
 106 };
 107
 108 } // namespace
 109
 110 #endif