sink_node.go 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393
  1. package nodes
  2. import (
  3. "bytes"
  4. "encoding/json"
  5. "fmt"
  6. "github.com/emqx/kuiper/common"
  7. "github.com/emqx/kuiper/common/templates"
  8. "github.com/emqx/kuiper/plugins"
  9. "github.com/emqx/kuiper/xstream/api"
  10. "github.com/emqx/kuiper/xstream/sinks"
  11. "sync"
  12. "text/template"
  13. "time"
  14. )
  15. type SinkNode struct {
  16. *defaultSinkNode
  17. //static
  18. sinkType string
  19. mutex sync.RWMutex
  20. //configs (also static for sinks)
  21. options map[string]interface{}
  22. isMock bool
  23. //states varies after restart
  24. sinks []api.Sink
  25. tch chan struct{} //channel to trigger cache saved, will be trigger by checkpoint only
  26. }
  27. func NewSinkNode(name string, sinkType string, props map[string]interface{}) *SinkNode {
  28. bufferLength := 1024
  29. if c, ok := props["bufferLength"]; ok {
  30. if t, err := common.ToInt(c); err != nil || t <= 0 {
  31. //invalid property bufferLength
  32. } else {
  33. bufferLength = t
  34. }
  35. }
  36. return &SinkNode{
  37. defaultSinkNode: &defaultSinkNode{
  38. input: make(chan interface{}, bufferLength),
  39. defaultNode: &defaultNode{
  40. name: name,
  41. concurrency: 1,
  42. ctx: nil,
  43. },
  44. },
  45. sinkType: sinkType,
  46. options: props,
  47. }
  48. }
  49. //Only for mock source, do not use it in production
  50. func NewSinkNodeWithSink(name string, sink api.Sink, props map[string]interface{}) *SinkNode {
  51. return &SinkNode{
  52. defaultSinkNode: &defaultSinkNode{
  53. input: make(chan interface{}, 1024),
  54. defaultNode: &defaultNode{
  55. name: name,
  56. concurrency: 1,
  57. ctx: nil,
  58. },
  59. },
  60. sinks: []api.Sink{sink},
  61. options: props,
  62. isMock: true,
  63. }
  64. }
  65. func (m *SinkNode) Open(ctx api.StreamContext, result chan<- error) {
  66. m.ctx = ctx
  67. logger := ctx.GetLogger()
  68. logger.Debugf("open sink node %s", m.name)
  69. if m.qos >= api.AtLeastOnce {
  70. m.tch = make(chan struct{})
  71. }
  72. go func() {
  73. if c, ok := m.options["concurrency"]; ok {
  74. if t, err := common.ToInt(c); err != nil || t <= 0 {
  75. logger.Warnf("invalid type for concurrency property, should be positive integer but found %t", c)
  76. } else {
  77. m.concurrency = t
  78. }
  79. }
  80. runAsync := false
  81. if c, ok := m.options["runAsync"]; ok {
  82. if t, ok := c.(bool); !ok {
  83. logger.Warnf("invalid type for runAsync property, should be bool but found %t", c)
  84. } else {
  85. runAsync = t
  86. }
  87. }
  88. retryInterval := 1000
  89. if c, ok := m.options["retryInterval"]; ok {
  90. if t, err := common.ToInt(c); err != nil || t < 0 {
  91. logger.Warnf("invalid type for retryInterval property, should be positive integer but found %t", c)
  92. } else {
  93. retryInterval = t
  94. }
  95. }
  96. cacheLength := 1024
  97. if c, ok := m.options["cacheLength"]; ok {
  98. if t, err := common.ToInt(c); err != nil || t < 0 {
  99. logger.Warnf("invalid type for cacheLength property, should be positive integer but found %t", c)
  100. } else {
  101. cacheLength = t
  102. }
  103. }
  104. cacheSaveInterval := 1000
  105. if c, ok := m.options["cacheSaveInterval"]; ok {
  106. if t, err := common.ToInt(c); err != nil || t < 0 {
  107. logger.Warnf("invalid type for cacheSaveInterval property, should be positive integer but found %t", c)
  108. } else {
  109. cacheSaveInterval = t
  110. }
  111. }
  112. omitIfEmpty := false
  113. if c, ok := m.options["omitIfEmpty"]; ok {
  114. if t, ok := c.(bool); !ok {
  115. logger.Warnf("invalid type for omitIfEmpty property, should be a bool value 'true/false'.", c)
  116. } else {
  117. omitIfEmpty = t
  118. }
  119. }
  120. sendSingle := false
  121. if c, ok := m.options["sendSingle"]; ok {
  122. if t, ok := c.(bool); !ok {
  123. logger.Warnf("invalid type for sendSingle property, should be a bool value 'true/false'.", c)
  124. } else {
  125. sendSingle = t
  126. }
  127. }
  128. var tp *template.Template = nil
  129. if c, ok := m.options["dataTemplate"]; ok {
  130. if t, ok := c.(string); !ok {
  131. logger.Warnf("invalid type for dateTemplate property, should be a string value.", c)
  132. } else {
  133. funcMap := template.FuncMap{
  134. "json": templates.JsonMarshal,
  135. "base64": templates.Base64Encode,
  136. "add": templates.Add,
  137. }
  138. temp, err := template.New("sink").Funcs(funcMap).Parse(t)
  139. if err != nil {
  140. msg := fmt.Sprintf("property dataTemplate %v is invalid: %v", t, err)
  141. result <- fmt.Errorf(msg)
  142. logger.Warnf(msg)
  143. return
  144. } else {
  145. tp = temp
  146. }
  147. }
  148. }
  149. m.reset()
  150. logger.Infof("open sink node %d instances", m.concurrency)
  151. for i := 0; i < m.concurrency; i++ { // workers
  152. go func(instance int) {
  153. var sink api.Sink
  154. var err error
  155. if !m.isMock {
  156. sink, err = getSink(m.sinkType, m.options)
  157. if err != nil {
  158. m.drainError(result, err, ctx, logger)
  159. return
  160. }
  161. m.mutex.Lock()
  162. m.sinks = append(m.sinks, sink)
  163. m.mutex.Unlock()
  164. if err := sink.Open(ctx); err != nil {
  165. m.drainError(result, err, ctx, logger)
  166. return
  167. }
  168. } else {
  169. sink = m.sinks[instance]
  170. }
  171. stats, err := NewStatManager("sink", ctx)
  172. if err != nil {
  173. m.drainError(result, err, ctx, logger)
  174. return
  175. }
  176. m.mutex.Lock()
  177. m.statManagers = append(m.statManagers, stats)
  178. m.mutex.Unlock()
  179. var cache *Cache
  180. if m.qos >= api.AtLeastOnce {
  181. cache = NewCheckpointbasedCache(m.input, cacheLength, m.tch, result, ctx)
  182. } else {
  183. cache = NewTimebasedCache(m.input, cacheLength, cacheSaveInterval, result, ctx)
  184. }
  185. for {
  186. select {
  187. case data := <-cache.Out:
  188. if newdata, processed := m.preprocess(data.data); processed {
  189. break
  190. } else {
  191. data.data = newdata
  192. }
  193. stats.SetBufferLength(int64(cache.Length()))
  194. if runAsync {
  195. go doCollect(sink, data, stats, retryInterval, omitIfEmpty, sendSingle, tp, cache.Complete, ctx)
  196. } else {
  197. doCollect(sink, data, stats, retryInterval, omitIfEmpty, sendSingle, tp, cache.Complete, ctx)
  198. }
  199. case <-ctx.Done():
  200. logger.Infof("sink node %s instance %d done", m.name, instance)
  201. if err := sink.Close(ctx); err != nil {
  202. logger.Warnf("close sink node %s instance %d fails: %v", m.name, instance, err)
  203. }
  204. return
  205. }
  206. }
  207. }(i)
  208. }
  209. }()
  210. }
  211. func (m *SinkNode) reset() {
  212. if !m.isMock {
  213. m.sinks = nil
  214. }
  215. m.statManagers = nil
  216. }
  217. func extractInput(v []byte) ([]map[string]interface{}, error) {
  218. var j []map[string]interface{}
  219. if err := json.Unmarshal(v, &j); err != nil {
  220. return nil, fmt.Errorf("fail to decode the input %s as json: %v", v, err)
  221. }
  222. return j, nil
  223. }
  224. func doCollect(sink api.Sink, item *CacheTuple, stats StatManager, retryInterval int, omitIfEmpty bool, sendSingle bool, tp *template.Template, signalCh chan<- int, ctx api.StreamContext) {
  225. stats.IncTotalRecordsIn()
  226. stats.ProcessTimeStart()
  227. defer stats.ProcessTimeEnd()
  228. logger := ctx.GetLogger()
  229. var outdatas [][]byte
  230. switch val := item.data.(type) {
  231. case []byte:
  232. if omitIfEmpty && string(val) == "[{}]" {
  233. return
  234. }
  235. var (
  236. err error
  237. j []map[string]interface{}
  238. )
  239. if sendSingle || tp != nil {
  240. j, err = extractInput(val)
  241. if err != nil {
  242. stats.IncTotalExceptions()
  243. logger.Warnf("sink node %s instance %d publish %s error: %v", ctx.GetOpId(), ctx.GetInstanceId(), val, err)
  244. return
  245. }
  246. logger.Debugf("receive %d records", len(j))
  247. }
  248. if !sendSingle {
  249. if tp != nil {
  250. var output bytes.Buffer
  251. err := tp.Execute(&output, j)
  252. if err != nil {
  253. logger.Warnf("sink node %s instance %d publish %s decode template error: %v", ctx.GetOpId(), ctx.GetInstanceId(), val, err)
  254. stats.IncTotalExceptions()
  255. return
  256. }
  257. outdatas = append(outdatas, output.Bytes())
  258. } else {
  259. outdatas = [][]byte{val}
  260. }
  261. } else {
  262. for _, r := range j {
  263. if tp != nil {
  264. var output bytes.Buffer
  265. err := tp.Execute(&output, r)
  266. if err != nil {
  267. logger.Warnf("sink node %s instance %d publish %s decode template error: %v", ctx.GetOpId(), ctx.GetInstanceId(), val, err)
  268. stats.IncTotalExceptions()
  269. return
  270. }
  271. outdatas = append(outdatas, output.Bytes())
  272. } else {
  273. if ot, e := json.Marshal(r); e != nil {
  274. logger.Warnf("sink node %s instance %d publish %s marshal error: %v", ctx.GetOpId(), ctx.GetInstanceId(), r, e)
  275. stats.IncTotalExceptions()
  276. return
  277. } else {
  278. outdatas = append(outdatas, ot)
  279. }
  280. }
  281. }
  282. }
  283. case error:
  284. outdatas = [][]byte{[]byte(fmt.Sprintf(`[{"error":"%s"}]`, val.Error()))}
  285. default:
  286. outdatas = [][]byte{[]byte(fmt.Sprintf(`[{"error":"result is not a string but found %#v"}]`, val))}
  287. }
  288. for _, outdata := range outdatas {
  289. outerloop:
  290. for {
  291. select {
  292. case <-ctx.Done():
  293. logger.Infof("sink node %s instance %d stops data resending", ctx.GetOpId(), ctx.GetInstanceId())
  294. return
  295. default:
  296. if err := sink.Collect(ctx, outdata); err != nil {
  297. stats.IncTotalExceptions()
  298. logger.Warnf("sink node %s instance %d publish %s error: %v", ctx.GetOpId(), ctx.GetInstanceId(), outdata, err)
  299. if retryInterval > 0 {
  300. time.Sleep(time.Duration(retryInterval) * time.Millisecond)
  301. logger.Debugf("try again")
  302. } else {
  303. break outerloop
  304. }
  305. } else {
  306. logger.Debugf("success")
  307. stats.IncTotalRecordsOut()
  308. signalCh <- item.index
  309. break outerloop
  310. }
  311. }
  312. }
  313. }
  314. }
  315. func doGetSink(name string, action map[string]interface{}) (api.Sink, error) {
  316. var (
  317. s api.Sink
  318. err error
  319. )
  320. switch name {
  321. case "log":
  322. s = sinks.NewLogSink()
  323. case "logToMemory":
  324. s = sinks.NewLogSinkToMemory()
  325. case "mqtt":
  326. s = &sinks.MQTTSink{}
  327. case "rest":
  328. s = &sinks.RestSink{}
  329. case "nop":
  330. s = &sinks.NopSink{}
  331. default:
  332. s, err = plugins.GetSink(name)
  333. if err != nil {
  334. return nil, err
  335. }
  336. }
  337. err = s.Configure(action)
  338. if err != nil {
  339. return nil, err
  340. }
  341. return s, nil
  342. }
  343. //Override defaultNode
  344. func (m *SinkNode) AddOutput(_ chan<- interface{}, name string) error {
  345. return fmt.Errorf("fail to add output %s, sink %s cannot add output", name, m.name)
  346. }
  347. //Override defaultNode
  348. func (m *SinkNode) Broadcast(_ interface{}) error {
  349. return fmt.Errorf("sink %s cannot add broadcast", m.name)
  350. }
  351. func (m *SinkNode) drainError(errCh chan<- error, err error, ctx api.StreamContext, logger api.Logger) {
  352. go func() {
  353. select {
  354. case errCh <- err:
  355. ctx.GetLogger().Errorf("error in sink %s", err)
  356. case <-ctx.Done():
  357. m.close(ctx, logger)
  358. }
  359. }()
  360. }
  361. func (m *SinkNode) close(ctx api.StreamContext, logger api.Logger) {
  362. for _, s := range m.sinks {
  363. if err := s.Close(ctx); err != nil {
  364. logger.Warnf("close sink fails: %v", err)
  365. }
  366. }
  367. if m.tch != nil {
  368. close(m.tch)
  369. m.tch = nil
  370. }
  371. }
  372. // Only called when checkpoint enabled
  373. func (m *SinkNode) SaveCache() {
  374. m.tch <- struct{}{}
  375. }