2 * Copyright (c) 2020 AT&T Intellectual Property.
3 * Copyright (c) 2020 Nokia.
5 * Licensed under the Apache License, Version 2.0 (the "License");
6 * you may not use this file except in compliance with the License.
7 * You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
17 * This source code is part of the near-RT RIC (RAN Intelligent Controller)
18 * platform project (RICP).
38 #cgo LDFLAGS: -lrmr_si
44 // InitAlarm is the init routine which returns a new alarm instance.
45 // The MO and APP identities are given as a parameters.
46 // The identities are used when raising/clearing alarms, unless provided by the applications.
47 func InitAlarm(mo, id string) (*RICAlarm, error) {
54 // http service information (used in case of no rmr connectivity)
56 namespace := os.Getenv("PLT_NAMESPACE")
58 if os.Getenv("ALARM_MANAGER_URL") != "" {
59 r.managerUrl = os.Getenv("ALARM_MANAGER_URL")
60 } else if namespace != "" {
61 r.managerUrl = fmt.Sprintf("http://service-%s-alarmmanager-http.%s:8080", namespace, namespace)
63 r.managerUrl = "http://127.0.0.1:8080"
69 rmrservname := os.Getenv("ALARM_MANAGER_SERVICE_NAME")
70 rmrservport := os.Getenv("ALARM_MANAGER_SERVICE_PORT")
72 if rmrservname != "" && rmrservport != "" {
73 go InitRMR(r, rmrservname+":"+rmrservport)
74 } else if namespace != "" {
75 go InitRMR(r, fmt.Sprintf("service-%s-alarmmanager-rmr.%s:4560", namespace, namespace))
83 // Create a new Alarm instance
84 func (r *RICAlarm) NewAlarm(sp int, severity Severity, ainfo, iinfo string) Alarm {
86 ManagedObjectId: r.moId,
87 ApplicationId: r.appId,
89 PerceivedSeverity: severity,
90 IdentifyingInfo: iinfo,
91 AdditionalInfo: ainfo,
95 // Create a new AlarmMessage instance
96 func (r *RICAlarm) NewAlarmMessage(a Alarm, alarmAction AlarmAction) AlarmMessage {
97 alarmTime := time.Now().UnixNano()
98 return AlarmMessage{a, alarmAction, alarmTime}
101 func (r *RICAlarm) SetManagedObjectId(mo string) {
105 func (r *RICAlarm) SetApplicationId(app string) {
110 func (r *RICAlarm) Raise(a Alarm) error {
112 defer r.mutex.Unlock()
114 m := r.NewAlarmMessage(a, AlarmActionRaise)
115 return r.sendAlarmUpdateReq(m)
119 func (r *RICAlarm) Clear(a Alarm) error {
121 defer r.mutex.Unlock()
123 m := r.NewAlarmMessage(a, AlarmActionClear)
124 return r.sendAlarmUpdateReq(m)
127 // Re-raise a RIC alarm
128 func (r *RICAlarm) Reraise(a Alarm) error {
130 defer r.mutex.Unlock()
132 m := r.NewAlarmMessage(a, AlarmActionClear)
133 if err := r.sendAlarmUpdateReq(m); err != nil {
134 return errors.New(fmt.Sprintf("Reraise failed: %v", err))
137 return r.sendAlarmUpdateReq(r.NewAlarmMessage(a, AlarmActionRaise))
140 // Clear all alarms raised by the application
141 func (r *RICAlarm) ClearAll() error {
143 defer r.mutex.Unlock()
145 a := r.NewAlarm(0, SeverityDefault, "", "")
146 m := r.NewAlarmMessage(a, AlarmActionClearAll)
148 return r.sendAlarmUpdateReq(m)
151 func (r *RICAlarm) AlarmString(a AlarmMessage) string {
152 s := "MOId=%s AppId=%s SP=%d severity=%s IA=%s"
153 return fmt.Sprintf(s, a.ManagedObjectId, a.ApplicationId, a.SpecificProblem, a.PerceivedSeverity, a.IdentifyingInfo)
156 func (r *RICAlarm) sendAlarmUpdateReq(a AlarmMessage) error {
158 payload, err := json.Marshal(a)
160 log.Println("json.Marshal failed with error: ", err)
163 log.Println("Sending alarm: ", fmt.Sprintf("%s", payload))
165 if r.rmrCtx == nil || !r.rmrReady {
166 url := fmt.Sprintf("%s/%s", r.managerUrl, "ric/v1/alarms")
167 resp, err := http.Post(url, "application/json", bytes.NewReader(payload))
168 if err != nil || resp == nil {
169 return fmt.Errorf("Unable to send alarm: %v", err)
171 log.Printf("Alarm posted to %s [status=%d]", url, resp.StatusCode)
175 datap := C.CBytes(payload)
177 meid := C.CString("ric")
178 defer C.free(unsafe.Pointer(meid))
180 if state := C.rmrSend(r.rmrCtx, RIC_ALARM_UPDATE, datap, C.int(len(payload)), meid); state != C.RMR_OK {
181 log.Println("rmrSend failed with error: ", state)
182 return errors.New(fmt.Sprintf("rmrSend failed with error: %d", state))
188 func (r *RICAlarm) ReceiveMessage(cb func(AlarmMessage)) error {
189 if rbuf := C.rmrRcv(r.rmrCtx); rbuf != nil {
190 payload := C.GoBytes(unsafe.Pointer(rbuf.payload), C.int(rbuf.len))
192 if err := json.Unmarshal(payload, &a); err == nil {
196 return errors.New("rmrRcv failed!")
199 func InitRMR(r *RICAlarm, endpoint string) error {
200 // Setup static RT for alarm system
202 if r.moId == "my-pod" {
203 endpoint = "127.0.0.1:4560"
204 } else if r.moId == "my-pod-lib" {
205 endpoint = "127.0.0.1:4588"
209 alarmRT := fmt.Sprintf("newrt|start\nrte|13111|%s\nnewrt|end\n", endpoint)
210 alarmRTFile := "/tmp/alarm.rt"
212 if err := ioutil.WriteFile(alarmRTFile, []byte(alarmRT), 0644); err != nil {
213 log.Println("ioutil.WriteFile failed with error: ", err)
217 os.Setenv("RMR_SEED_RT", alarmRTFile)
218 os.Setenv("RMR_RTG_SVC", "-1")
220 if ctx := C.rmrInit(); ctx != nil {
226 return errors.New("rmrInit failed!")
229 func (r *RICAlarm) IsRMRReady() bool {