emqx.schema 61 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023
  1. %%-*- mode: erlang -*-
  2. %% EMQ X R3.0 config mapping
  3. %%--------------------------------------------------------------------
  4. %% Cluster
  5. %%--------------------------------------------------------------------
  6. %% @doc Cluster name
  7. {mapping, "cluster.name", "ekka.cluster_name", [
  8. {default, emqxcl},
  9. {datatype, atom}
  10. ]}.
  11. %% @doc Cluster discovery
  12. {mapping, "cluster.discovery", "ekka.cluster_discovery", [
  13. {default, manual},
  14. {datatype, atom}
  15. ]}.
  16. %% @doc Clean down node from the cluster
  17. {mapping, "cluster.autoclean", "ekka.cluster_autoclean", [
  18. {datatype, {duration, ms}}
  19. ]}.
  20. %% @doc Cluster autoheal
  21. {mapping, "cluster.autoheal", "ekka.cluster_autoheal", [
  22. {datatype, flag},
  23. {default, off}
  24. ]}.
  25. %%--------------------------------------------------------------------
  26. %% Cluster by static node list
  27. {mapping, "cluster.static.seeds", "ekka.cluster_discovery", [
  28. {datatype, string}
  29. ]}.
  30. %%--------------------------------------------------------------------
  31. %% Cluster by UDP Multicast
  32. {mapping, "cluster.mcast.addr", "ekka.cluster_discovery", [
  33. {default, "239.192.0.1"},
  34. {datatype, string}
  35. ]}.
  36. {mapping, "cluster.mcast.ports", "ekka.cluster_discovery", [
  37. {default, "4369"},
  38. {datatype, string}
  39. ]}.
  40. {mapping, "cluster.mcast.iface", "ekka.cluster_discovery", [
  41. {datatype, string},
  42. {default, "0.0.0.0"}
  43. ]}.
  44. {mapping, "cluster.mcast.ttl", "ekka.cluster_discovery", [
  45. {datatype, integer},
  46. {default, 255}
  47. ]}.
  48. {mapping, "cluster.mcast.loop", "ekka.cluster_discovery", [
  49. {datatype, flag},
  50. {default, on}
  51. ]}.
  52. {mapping, "cluster.mcast.sndbuf", "ekka.cluster_discovery", [
  53. {datatype, bytesize},
  54. {default, "16KB"}
  55. ]}.
  56. {mapping, "cluster.mcast.recbuf", "ekka.cluster_discovery", [
  57. {datatype, bytesize},
  58. {default, "16KB"}
  59. ]}.
  60. {mapping, "cluster.mcast.buffer", "ekka.cluster_discovery", [
  61. {datatype, bytesize},
  62. {default, "32KB"}
  63. ]}.
  64. %%--------------------------------------------------------------------
  65. %% Cluster by DNS A Record
  66. {mapping, "cluster.dns.name", "ekka.cluster_discovery", [
  67. {datatype, string}
  68. ]}.
  69. %% @doc The erlang distributed protocol
  70. {mapping, "cluster.proto_dist", "ekka.proto_dist", [
  71. {default, "inet_tcp"},
  72. {datatype, {enum, [inet_tcp, inet6_tcp, inet_tls]}},
  73. hidden
  74. ]}.
  75. {mapping, "cluster.dns.app", "ekka.cluster_discovery", [
  76. {datatype, string}
  77. ]}.
  78. %%--------------------------------------------------------------------
  79. %% Cluster using etcd
  80. {mapping, "cluster.etcd.server", "ekka.cluster_discovery", [
  81. {datatype, string}
  82. ]}.
  83. {mapping, "cluster.etcd.prefix", "ekka.cluster_discovery", [
  84. {datatype, string}
  85. ]}.
  86. {mapping, "cluster.etcd.node_ttl", "ekka.cluster_discovery", [
  87. {datatype, {duration, ms}},
  88. {default, "1m"}
  89. ]}.
  90. {mapping, "cluster.etcd.ssl.keyfile", "ekka.cluster_discovery", [
  91. {datatype, string}
  92. ]}.
  93. {mapping, "cluster.etcd.ssl.certfile", "ekka.cluster_discovery", [
  94. {datatype, string}
  95. ]}.
  96. {mapping, "cluster.etcd.ssl.cacertfile", "ekka.cluster_discovery", [
  97. {datatype, string}
  98. ]}.
  99. %%--------------------------------------------------------------------
  100. %% Cluster on K8s
  101. {mapping, "cluster.k8s.apiserver", "ekka.cluster_discovery", [
  102. {datatype, string}
  103. ]}.
  104. {mapping, "cluster.k8s.service_name", "ekka.cluster_discovery", [
  105. {datatype, string}
  106. ]}.
  107. {mapping, "cluster.k8s.address_type", "ekka.cluster_discovery", [
  108. {datatype, {enum, [ip, dns, hostname]}}
  109. ]}.
  110. {mapping, "cluster.k8s.app_name", "ekka.cluster_discovery", [
  111. {datatype, string}
  112. ]}.
  113. {mapping, "cluster.k8s.namespace", "ekka.cluster_discovery", [
  114. {datatype, string}
  115. ]}.
  116. {mapping, "cluster.k8s.suffix", "ekka.cluster_discovery", [
  117. {datatype, string},
  118. {default, ""}
  119. ]}.
  120. {translation, "ekka.cluster_discovery", fun(Conf) ->
  121. Strategy = cuttlefish:conf_get("cluster.discovery", Conf),
  122. Filter = fun(Opts) -> [{K, V} || {K, V} <- Opts, V =/= undefined] end,
  123. IpPort = fun(S) ->
  124. [Addr, Port] = string:tokens(S, ":"),
  125. {ok, Ip} = inet:parse_address(Addr),
  126. {Ip, Port}
  127. end,
  128. Options = fun(static) ->
  129. [{seeds, [list_to_atom(S) || S <- string:tokens(cuttlefish:conf_get("cluster.static.seeds", Conf, ""), ",")]}];
  130. (mcast) ->
  131. {ok, Addr} = inet:parse_address(cuttlefish:conf_get("cluster.mcast.addr", Conf)),
  132. {ok, Iface} = inet:parse_address(cuttlefish:conf_get("cluster.mcast.iface", Conf)),
  133. Ports = [list_to_integer(S) || S <- string:tokens(cuttlefish:conf_get("cluster.mcast.ports", Conf), ",")],
  134. [{addr, Addr}, {ports, Ports}, {iface, Iface},
  135. {ttl, cuttlefish:conf_get("cluster.mcast.ttl", Conf, 1)},
  136. {loop, cuttlefish:conf_get("cluster.mcast.loop", Conf, true)}];
  137. (dns) ->
  138. [{name, cuttlefish:conf_get("cluster.dns.name", Conf)},
  139. {app, cuttlefish:conf_get("cluster.dns.app", Conf)}];
  140. (etcd) ->
  141. SslOpts = fun(Conf) ->
  142. Options = cuttlefish_variable:filter_by_prefix("cluster.etcd.ssl", Conf),
  143. lists:map(fun({["cluster", "etcd", "ssl", Name], Value}) ->
  144. {list_to_atom(Name), Value}
  145. end, Options)
  146. end,
  147. [{server, string:tokens(cuttlefish:conf_get("cluster.etcd.server", Conf), ",")},
  148. {prefix, cuttlefish:conf_get("cluster.etcd.prefix", Conf, "emqcl")},
  149. {node_ttl, cuttlefish:conf_get("cluster.etcd.node_ttl", Conf, 60)},
  150. {ssl_options, SslOpts(Conf)}];
  151. (k8s) ->
  152. [{apiserver, cuttlefish:conf_get("cluster.k8s.apiserver", Conf)},
  153. {service_name, cuttlefish:conf_get("cluster.k8s.service_name", Conf)},
  154. {address_type, cuttlefish:conf_get("cluster.k8s.address_type", Conf, ip)},
  155. {app_name, cuttlefish:conf_get("cluster.k8s.app_name", Conf)},
  156. {namespace, cuttlefish:conf_get("cluster.k8s.namespace", Conf)},
  157. {suffix, cuttlefish:conf_get("cluster.k8s.suffix", Conf, "")}];
  158. (manual) ->
  159. [ ]
  160. end,
  161. {Strategy, Filter(Options(Strategy))}
  162. end}.
  163. %%--------------------------------------------------------------------
  164. %% Node
  165. %%--------------------------------------------------------------------
  166. %% @doc Node name
  167. {mapping, "node.name", "vm_args.-name", [
  168. {default, "emqx@127.0.0.1"}
  169. ]}.
  170. %% @doc Specify SSL Options in the file if using SSL for erlang distribution
  171. {mapping, "node.ssl_dist_optfile", "vm_args.-ssl_dist_optfile", [
  172. {datatype, string},
  173. hidden
  174. ]}.
  175. %% @doc Secret cookie for distributed erlang node
  176. {mapping, "node.cookie", "vm_args.-setcookie", [
  177. {default, "emqxsecretcookie"}
  178. ]}.
  179. {mapping, "node.data_dir", "emqx.data_dir", [
  180. {datatype, string}
  181. ]}.
  182. %% @doc http://erlang.org/doc/man/heart.html
  183. {mapping, "node.heartbeat", "vm_args.-heart", [
  184. {datatype, flag},
  185. hidden
  186. ]}.
  187. {translation, "vm_args.-heart", fun(Conf) ->
  188. case cuttlefish:conf_get("node.heartbeat", Conf) of
  189. true -> "";
  190. false -> cuttlefish:invalid("should be 'on' or comment the line!")
  191. end
  192. end}.
  193. %% @doc More information at: http://erlang.org/doc/man/erl.html
  194. {mapping, "node.async_threads", "vm_args.+A", [
  195. {default, 64},
  196. {datatype, integer},
  197. {validators, ["range:0-1024"]}
  198. ]}.
  199. %% @doc Erlang Process Limit
  200. {mapping, "node.process_limit", "vm_args.+P", [
  201. {datatype, integer},
  202. {default, 256000},
  203. hidden
  204. ]}.
  205. %% Note: OTP R15 and earlier uses -env ERL_MAX_PORTS, R16+ uses +Q
  206. %% @doc The number of concurrent ports/sockets
  207. %% Valid range is 1024-134217727
  208. {mapping, "node.max_ports",
  209. cuttlefish:otp("R16", "vm_args.+Q", "vm_args.-env ERL_MAX_PORTS"), [
  210. {default, 262144},
  211. {datatype, integer},
  212. {validators, ["range4ports"]}
  213. ]}.
  214. {validator, "range4ports", "must be 1024 to 134217727",
  215. fun(X) -> X >= 1024 andalso X =< 134217727 end}.
  216. %% @doc http://www.erlang.org/doc/man/erl.html#%2bzdbbl
  217. {mapping, "node.dist_buffer_size", "vm_args.+zdbbl", [
  218. {datatype, bytesize},
  219. {commented, "32MB"},
  220. hidden,
  221. {validators, ["zdbbl_range"]}
  222. ]}.
  223. {translation, "vm_args.+zdbbl",
  224. fun(Conf) ->
  225. ZDBBL = cuttlefish:conf_get("node.dist_buffer_size", Conf, undefined),
  226. case ZDBBL of
  227. undefined -> undefined;
  228. X when is_integer(X) -> cuttlefish_util:ceiling(X / 1024); %% Bytes to Kilobytes;
  229. _ -> undefined
  230. end
  231. end}.
  232. {validator, "zdbbl_range", "must be between 1KB and 2097151KB",
  233. fun(ZDBBL) ->
  234. %% 2097151KB = 2147482624
  235. ZDBBL >= 1024 andalso ZDBBL =< 2147482624
  236. end
  237. }.
  238. %% @doc http://www.erlang.org/doc/man/erlang.html#system_flag-2
  239. {mapping, "node.fullsweep_after", "vm_args.-env ERL_FULLSWEEP_AFTER", [
  240. {default, 1000},
  241. {datatype, integer},
  242. hidden,
  243. {validators, ["positive_integer"]}
  244. ]}.
  245. {validator, "positive_integer", "must be a positive integer",
  246. fun(X) -> X >= 0 end}.
  247. %% Note: OTP R15 and earlier uses -env ERL_MAX_ETS_TABLES,
  248. %% R16+ uses +e
  249. %% @doc The ETS table limit
  250. {mapping, "node.max_ets_tables",
  251. cuttlefish:otp("R16", "vm_args.+e", "vm_args.-env ERL_MAX_ETS_TABLES"), [
  252. {default, 256000},
  253. {datatype, integer},
  254. hidden
  255. ]}.
  256. %% @doc Set the location of crash dumps
  257. {mapping, "node.crash_dump", "vm_args.-env ERL_CRASH_DUMP", [
  258. {default, "{{crash_dump}}"},
  259. {datatype, file},
  260. hidden
  261. ]}.
  262. %% @doc http://www.erlang.org/doc/man/kernel_app.html#net_ticktime
  263. {mapping, "node.dist_net_ticktime", "vm_args.-kernel net_ticktime", [
  264. {commented, 60},
  265. {datatype, integer},
  266. hidden
  267. ]}.
  268. %% @doc http://www.erlang.org/doc/man/kernel_app.html
  269. {mapping, "node.dist_listen_min", "kernel.inet_dist_listen_min", [
  270. {commented, 6369},
  271. {datatype, integer},
  272. hidden
  273. ]}.
  274. %% @see node.dist_listen_min
  275. {mapping, "node.dist_listen_max", "kernel.inet_dist_listen_max", [
  276. {commented, 6369},
  277. {datatype, integer},
  278. hidden
  279. ]}.
  280. %%--------------------------------------------------------------------
  281. %% RPC
  282. %%--------------------------------------------------------------------
  283. %% RPC Mode.
  284. {mapping, "rpc.mode", "emqx.rpc_mode", [
  285. {default, async},
  286. {datatype, {enum, [sync, async]}}
  287. ]}.
  288. {mapping, "rpc.async_batch_size", "gen_rpc.max_batch_size", [
  289. {default, 256},
  290. {datatype, integer}
  291. ]}.
  292. %% RPC server port.
  293. {mapping, "rpc.tcp_server_port", "gen_rpc.tcp_server_port", [
  294. {default, 5369},
  295. {datatype, integer}
  296. ]}.
  297. %% Default TCP port for outgoing connections
  298. {mapping, "rpc.tcp_client_port", "gen_rpc.tcp_client_port", [
  299. {default, 5369},
  300. {datatype, integer}
  301. ]}.
  302. %% Default TCP port for outgoing connections
  303. {mapping, "rpc.tcp_client_num", "gen_rpc.tcp_client_num", [
  304. {default, 32},
  305. {datatype, integer},
  306. {validators, ["range:gt_0_lt_256"]}
  307. ]}.
  308. %% Client connect timeout
  309. {mapping, "rpc.connect_timeout", "gen_rpc.connect_timeout", [
  310. {default, "5s"},
  311. {datatype, {duration, ms}}
  312. ]}.
  313. %% Client and Server send timeout
  314. {mapping, "rpc.send_timeout", "gen_rpc.send_timeout", [
  315. {default, 5000},
  316. {datatype, {duration, ms}}
  317. ]}.
  318. %% Authentication timeout
  319. {mapping, "rpc.authentication_timeout", "gen_rpc.authentication_timeout", [
  320. {default, 5000},
  321. {datatype, {duration, ms}}
  322. ]}.
  323. %% Default receive timeout for call() functions
  324. {mapping, "rpc.call_receive_timeout", "gen_rpc.call_receive_timeout", [
  325. {default, 15000},
  326. {datatype, {duration, ms}}
  327. ]}.
  328. %% Socket keepalive configuration
  329. {mapping, "rpc.socket_keepalive_idle", "gen_rpc.socket_keepalive_idle", [
  330. {default, 7200},
  331. {datatype, {duration, s}}
  332. ]}.
  333. %% Seconds between probes
  334. {mapping, "rpc.socket_keepalive_interval", "gen_rpc.socket_keepalive_interval", [
  335. {default, 75},
  336. {datatype, {duration, s}}
  337. ]}.
  338. %% Probes lost to close the connection
  339. {mapping, "rpc.socket_keepalive_count", "gen_rpc.socket_keepalive_count", [
  340. {default, 9},
  341. {datatype, integer}
  342. ]}.
  343. %% Size of TCP send buffer
  344. {mapping, "rpc.socket_sndbuf", "gen_rpc.socket_sndbuf", [
  345. {default, "1MB"},
  346. {datatype, bytesize}
  347. ]}.
  348. %% Size of TCP receive buffer
  349. {mapping, "rpc.socket_recbuf", "gen_rpc.socket_recbuf", [
  350. {default, "1MB"},
  351. {datatype, bytesize}
  352. ]}.
  353. %% Size of TCP receive buffer
  354. {mapping, "rpc.socket_buffer", "gen_rpc.socket_buffer", [
  355. {default, "1MB"},
  356. {datatype, bytesize}
  357. ]}.
  358. {validator, "range:gt_0_lt_256", "must greater than 0 and less than 256",
  359. fun(X) -> X > 0 andalso X < 256 end
  360. }.
  361. %%--------------------------------------------------------------------
  362. %% Log
  363. %%--------------------------------------------------------------------
  364. {mapping, "log.to", "kernel.logger", [
  365. {default, console},
  366. {datatype, {enum, [off, file, console, both]}}
  367. ]}.
  368. {mapping, "log.level", "kernel.logger", [
  369. {default, warning},
  370. {datatype, {enum, [debug, info, notice, warning, error, critical, alert, emergency, all]}}
  371. ]}.
  372. {mapping, "log.primary_log_level", "kernel.logger_level", [
  373. {default, warning},
  374. {datatype, {enum, [debug, info, notice, warning, error, critical, alert, emergency, all]}}
  375. ]}.
  376. {mapping, "log.logger_sasl_compatible", "kernel.logger_sasl_compatible", [
  377. {default, true},
  378. {datatype, {enum, [true, false]}}
  379. ]}.
  380. {mapping, "log.dir", "kernel.logger", [
  381. {default, "log"},
  382. {datatype, string}
  383. ]}.
  384. {mapping, "log.file", "kernel.logger", [
  385. {default, "emqx.log"},
  386. {datatype, file}
  387. ]}.
  388. {mapping, "log.chars_limit", "kernel.logger", [
  389. {default, -1},
  390. {datatype, integer}
  391. ]}.
  392. {mapping, "log.rotation.size", "kernel.logger", [
  393. {default, "10MB"},
  394. {datatype, bytesize}
  395. ]}.
  396. {mapping, "log.rotation.count", "kernel.logger", [
  397. {default, 5},
  398. {datatype, integer}
  399. ]}.
  400. {mapping, "log.$level.file", "kernel.logger", [
  401. {datatype, file}
  402. ]}.
  403. {mapping, "log.sasl", "sasl.sasl_error_logger", [
  404. {default, off},
  405. {datatype, flag},
  406. hidden
  407. ]}.
  408. {mapping, "log.error_logger", "kernel.error_logger", [
  409. {default, silent},
  410. {datatype, {enum, [silent]}},
  411. hidden
  412. ]}.
  413. %% disable lager
  414. {mapping, "lager.handlers", "lager.handlers", [
  415. {default, []},
  416. hidden
  417. ]}.
  418. {mapping, "lager.crash_log", "lager.crash_log", [
  419. {default, off},
  420. {datatype, flag},
  421. hidden
  422. ]}.
  423. {translation, "kernel.logger_level", fun(_, _, Conf) ->
  424. cuttlefish:conf_get("log.level", Conf)
  425. end}.
  426. {translation, "kernel.logger", fun(Conf) ->
  427. LogTo = cuttlefish:conf_get("log.to", Conf),
  428. LogLevel = cuttlefish:conf_get("log.level", Conf),
  429. CharsLimit = case cuttlefish:conf_get("log.chars_limit", Conf) of
  430. -1 -> unlimited;
  431. V -> V
  432. end,
  433. Formatter = {emqx_logger_formatter,
  434. #{template =>
  435. [time," [",level,"] ",
  436. {clientid,
  437. [{peername,
  438. [clientid,"@",peername," "],
  439. [clientid, " "]}],
  440. [{peername,
  441. [peername," "],
  442. []}]},
  443. msg,"\n"],
  444. chars_limit => CharsLimit}},
  445. FileConf = fun(Filename) ->
  446. #{type => wrap,
  447. file => filename:join(cuttlefish:conf_get("log.dir", Conf), Filename),
  448. max_no_files => cuttlefish:conf_get("log.rotation.count", Conf),
  449. max_no_bytes => cuttlefish:conf_get("log.rotation.size", Conf)}
  450. end,
  451. %% For the default logger that outputs to console
  452. DefaultHandler =
  453. if LogTo =:= console orelse LogTo =:= both ->
  454. [{handler, default, logger_std_h,
  455. #{level => LogLevel,
  456. config => #{type => standard_io},
  457. formatter => Formatter}}];
  458. true ->
  459. [{handler, default, undefined}]
  460. end,
  461. %% For the file logger
  462. FileHandler =
  463. if LogTo =:= file orelse LogTo =:= both ->
  464. [{handler, file, logger_disk_log_h,
  465. #{level => LogLevel,
  466. config => FileConf(cuttlefish:conf_get("log.file", Conf)),
  467. formatter => Formatter,
  468. filesync_repeat_interval => no_repeat}}];
  469. true -> []
  470. end,
  471. %% For creating additional log files for specific log levels.
  472. AdditionalLogFiles =
  473. lists:foldl(
  474. fun({[_, Level, _] = K, Filename}, Acc) when LogTo =:= file; LogTo =:= both ->
  475. case cuttlefish_variable:is_fuzzy_match(K, ["log", "$level", "file"]) of
  476. true -> [{Level, Filename} | Acc];
  477. false -> Acc
  478. end;
  479. ({_K, _V}, Acc) ->
  480. Acc
  481. end, [], Conf),
  482. AdditionalHandlers =
  483. [{handler, list_to_atom("file_for_"++Level), logger_disk_log_h,
  484. #{level => list_to_atom(Level),
  485. config => FileConf(Filename),
  486. formatter => Formatter,
  487. filesync_repeat_interval => no_repeat}}
  488. || {Level, Filename} <- AdditionalLogFiles],
  489. DefaultHandler ++ FileHandler ++ AdditionalHandlers
  490. end}.
  491. %%--------------------------------------------------------------------
  492. %% Authentication/ACL
  493. %%--------------------------------------------------------------------
  494. %% @doc Allow anonymous authentication.
  495. {mapping, "allow_anonymous", "emqx.allow_anonymous", [
  496. {default, false},
  497. {datatype, {enum, [true, false]}}
  498. ]}.
  499. %% @doc ACL nomatch.
  500. {mapping, "acl_nomatch", "emqx.acl_nomatch", [
  501. {default, deny},
  502. {datatype, {enum, [allow, deny]}}
  503. ]}.
  504. %% @doc Default ACL file.
  505. {mapping, "acl_file", "emqx.acl_file", [
  506. {datatype, string},
  507. hidden
  508. ]}.
  509. %% @doc Enable ACL cache for publish.
  510. {mapping, "enable_acl_cache", "emqx.enable_acl_cache", [
  511. {default, on},
  512. {datatype, flag}
  513. ]}.
  514. %% @doc ACL cache time-to-live.
  515. {mapping, "acl_cache_ttl", "emqx.acl_cache_ttl", [
  516. {default, "1m"},
  517. {datatype, {duration, ms}}
  518. ]}.
  519. %% @doc ACL cache size.
  520. {mapping, "acl_cache_max_size", "emqx.acl_cache_max_size", [
  521. {default, 32},
  522. {datatype, integer},
  523. {validators, ["range:gt_0"]}
  524. ]}.
  525. %% @doc Action when acl check reject current operation
  526. {mapping, "acl_deny_action", "emqx.acl_deny_action", [
  527. {default, ignore},
  528. {datatype, {enum, [ignore, disconnect]}}
  529. ]}.
  530. %% @doc Flapping detect policy
  531. {mapping, "flapping_detect_policy", "emqx.flapping_detect_policy", [
  532. {datatype, string},
  533. {default, "30,1m,5m"}
  534. ]}.
  535. {translation, "emqx.flapping_detect_policy", fun(Conf) ->
  536. Policy = cuttlefish:conf_get("flapping_detect_policy", Conf),
  537. [Threshold, Duration, Interval] = string:tokens(Policy, ", "),
  538. ParseDuration = fun(S) ->
  539. case cuttlefish_duration:parse(S, ms) of
  540. I when is_integer(I) -> I;
  541. {error, Reason} -> error(Reason)
  542. end
  543. end,
  544. #{threshold => list_to_integer(Threshold),
  545. duration => ParseDuration(Duration),
  546. banned_interval => ParseDuration(Interval)
  547. }
  548. end}.
  549. {validator, "range:gt_0", "must greater than 0",
  550. fun(X) -> X > 0 end
  551. }.
  552. %%--------------------------------------------------------------------
  553. %% MQTT Protocol
  554. %%--------------------------------------------------------------------
  555. %% @doc Max Packet Size Allowed, 1MB by default.
  556. {mapping, "mqtt.max_packet_size", "emqx.max_packet_size", [
  557. {default, "1MB"},
  558. {datatype, bytesize}
  559. ]}.
  560. %% @doc Set the Max ClientId Length Allowed.
  561. {mapping, "mqtt.max_clientid_len", "emqx.max_clientid_len", [
  562. {default, 65535},
  563. {datatype, integer}
  564. ]}.
  565. %% @doc Set the Maximum topic levels.
  566. {mapping, "mqtt.max_topic_levels", "emqx.max_topic_levels", [
  567. {default, 0},
  568. {datatype, integer}
  569. ]}.
  570. %% @doc Set the Maximum QoS allowed.
  571. {mapping, "mqtt.max_qos_allowed", "emqx.max_qos_allowed", [
  572. {default, 2},
  573. {datatype, integer},
  574. {validators, ["range:0-2"]}
  575. ]}.
  576. %% @doc Set the Maximum topic alias.
  577. {mapping, "mqtt.max_topic_alias", "emqx.max_topic_alias", [
  578. {default, 0},
  579. {datatype, integer}
  580. ]}.
  581. %% @doc Whether the server supports MQTT retained messages.
  582. {mapping, "mqtt.retain_available", "emqx.retain_available", [
  583. {default, true},
  584. {datatype, {enum, [true, false]}}
  585. ]}.
  586. %% @doc Whether the Server supports MQTT Wildcard Subscriptions.
  587. {mapping, "mqtt.wildcard_subscription", "emqx.wildcard_subscription", [
  588. {default, true},
  589. {datatype, {enum, [true, false]}}
  590. ]}.
  591. %% @doc Whether the Server supports MQTT Shared Subscriptions.
  592. {mapping, "mqtt.shared_subscription", "emqx.shared_subscription", [
  593. {default, true},
  594. {datatype, {enum, [true, false]}}
  595. ]}.
  596. %% @doc Whether to ignore loop delivery of messages.(for mqtt v3.1.1)
  597. {mapping, "mqtt.ignore_loop_deliver", "emqx.ignore_loop_deliver", [
  598. {default, true},
  599. {datatype, {enum, [true, false]}}
  600. ]}.
  601. %%--------------------------------------------------------------------
  602. %% Zones
  603. %%--------------------------------------------------------------------
  604. %% @doc Idle timeout of the MQTT connection.
  605. {mapping, "zone.$name.idle_timeout", "emqx.zones", [
  606. {default, "15s"},
  607. {datatype, {duration, ms}}
  608. ]}.
  609. %% @doc Hibernate after a duration of idle state.
  610. {mapping, "zone.$name.hibernate_after", "emqx.zones", [
  611. {default, "60s"},
  612. {datatype, {duration, ms}}
  613. ]}.
  614. {mapping, "zone.$name.allow_anonymous", "emqx.zones", [
  615. {datatype, {enum, [true, false]}}
  616. ]}.
  617. {mapping, "zone.$name.acl_nomatch", "emqx.zones", [
  618. {datatype, {enum, [allow, deny]}}
  619. ]}.
  620. %% @doc Enable ACL check.
  621. {mapping, "zone.$name.enable_acl", "emqx.zones", [
  622. {default, off},
  623. {datatype, flag}
  624. ]}.
  625. %% @doc Action when acl check reject current operation
  626. {mapping, "zone.$name.acl_deny_action", "emqx.zones", [
  627. {default, ignore},
  628. {datatype, {enum, [ignore, disconnect]}}
  629. ]}.
  630. %% @doc Enable Ban.
  631. {mapping, "zone.$name.enable_ban", "emqx.zones", [
  632. {default, off},
  633. {datatype, flag}
  634. ]}.
  635. %% @doc Enable per connection statistics.
  636. {mapping, "zone.$name.enable_stats", "emqx.zones", [
  637. {default, off},
  638. {datatype, flag}
  639. ]}.
  640. %% @doc Publish limit of the MQTT connections.
  641. {mapping, "zone.$name.publish_limit", "emqx.zones", [
  642. {datatype, string}
  643. ]}.
  644. %% @doc Max Packet Size Allowed, 64K by default.
  645. {mapping, "zone.$name.max_packet_size", "emqx.zones", [
  646. {datatype, bytesize}
  647. ]}.
  648. %% @doc Set the Max ClientId Length Allowed.
  649. {mapping, "zone.$name.max_clientid_len", "emqx.zones", [
  650. {datatype, integer}
  651. ]}.
  652. %% @doc Set the Maximum topic levels.
  653. {mapping, "zone.$name.max_topic_levels", "emqx.zones", [
  654. {datatype, integer}
  655. ]}.
  656. %% @doc Set the Maximum QoS allowed.
  657. {mapping, "zone.$name.max_qos_allowed", "emqx.zones", [
  658. {datatype, integer},
  659. {validators, ["range:0-2"]}
  660. ]}.
  661. %% @doc Set the Maximum topic alias.
  662. {mapping, "zone.$name.max_topic_alias", "emqx.zones", [
  663. {datatype, integer}
  664. ]}.
  665. %% @doc Whether the server supports retained messages.
  666. {mapping, "zone.$name.retain_available", "emqx.zones", [
  667. {datatype, {enum, [true, false]}}
  668. ]}.
  669. %% @doc Whether the Server supports Wildcard Subscriptions.
  670. {mapping, "zone.$name.wildcard_subscription", "emqx.zones", [
  671. {datatype, {enum, [true, false]}}
  672. ]}.
  673. %% @doc Whether the Server supports Shared Subscriptions.
  674. {mapping, "zone.$name.shared_subscription", "emqx.zones", [
  675. {datatype, {enum, [true, false]}}
  676. ]}.
  677. %% @doc Server Keepalive
  678. {mapping, "zone.$name.server_keepalive", "emqx.zones", [
  679. {datatype, integer}
  680. ]}.
  681. %% @doc Keepalive backoff
  682. {mapping, "zone.$name.keepalive_backoff", "emqx.zones", [
  683. {default, 0.75},
  684. {datatype, float}
  685. ]}.
  686. %% @doc Max Number of Subscriptions Allowed.
  687. {mapping, "zone.$name.max_subscriptions", "emqx.zones", [
  688. {default, 0},
  689. {datatype, integer}
  690. ]}.
  691. %% @doc Upgrade QoS according to subscription?
  692. {mapping, "zone.$name.upgrade_qos", "emqx.zones", [
  693. {default, off},
  694. {datatype, flag}
  695. ]}.
  696. %% @doc Max number of QoS 1 and 2 messages that can be “inflight” at one time.
  697. %% 0 means no limit
  698. {mapping, "zone.$name.max_inflight", "emqx.zones", [
  699. {default, 0},
  700. {datatype, integer}
  701. ]}.
  702. %% @doc Retry interval for redelivering QoS1/2 messages.
  703. {mapping, "zone.$name.retry_interval", "emqx.zones", [
  704. {default, "20s"},
  705. {datatype, {duration, ms}}
  706. ]}.
  707. %% @doc Max Packets that Awaiting PUBREL, 0 means no limit
  708. {mapping, "zone.$name.max_awaiting_rel", "emqx.zones", [
  709. {default, 0},
  710. {datatype, integer}
  711. ]}.
  712. %% @doc Awaiting PUBREL timeout
  713. {mapping, "zone.$name.await_rel_timeout", "emqx.zones", [
  714. {default, "300s"},
  715. {datatype, {duration, ms}}
  716. ]}.
  717. %% @doc Ignore loop delivery of messages
  718. {mapping, "zone.$name.ignore_loop_deliver", "emqx.zones", [
  719. {datatype, {enum, [true, false]}}
  720. ]}.
  721. %% @doc Session Expiry Interval
  722. {mapping, "zone.$name.session_expiry_interval", "emqx.zones", [
  723. {default, "2h"},
  724. {datatype, {duration, s}}
  725. ]}.
  726. %% @doc Max queue length. Enqueued messages when persistent client
  727. %% disconnected, or inflight window is full. 0 means no limit.
  728. {mapping, "zone.$name.max_mqueue_len", "emqx.zones", [
  729. {default, 1000},
  730. {datatype, integer}
  731. ]}.
  732. %% @doc Topic Priorities, comma separated topic=priority pairs,
  733. %% where priority should be integer in range 1-255 (inclusive)
  734. %% 1 being the lowest and 255 being the highest.
  735. %% default value `none` to indicate no priority table, hence all
  736. %% messages are treated equal, which means either highest ('infinity'),
  737. %% or lowest (0) depending on mqueue_default_priority config.
  738. {mapping, "zone.$name.mqueue_priorities", "emqx.zones", [
  739. {default, "none"},
  740. {datatype, string}
  741. ]}.
  742. %% @doc Default priority for topics not in priority table.
  743. {mapping, "zone.$name.mqueue_default_priority", "emqx.zones", [
  744. {default, lowest},
  745. {datatype, {enum, [highest, lowest]}}
  746. ]}.
  747. %% @doc Queue Qos0 messages?
  748. {mapping, "zone.$name.mqueue_store_qos0", "emqx.zones", [
  749. {default, true},
  750. {datatype, {enum, [true, false]}}
  751. ]}.
  752. {mapping, "zone.$name.enable_flapping_detect", "emqx.zones", [
  753. {datatype, flag},
  754. {default, off}
  755. ]}.
  756. %% @doc Force connection/session process GC after this number of
  757. %% messages | bytes passed through.
  758. %% Numbers delimited by `|'. Zero or negative is to disable.
  759. {mapping, "zone.$name.force_gc_policy", "emqx.zones", [
  760. {default, "0 | 0MB"},
  761. {datatype, string}
  762. ]}.
  763. %% @doc Max message queue length and total heap size to force shutdown
  764. %% connection/session process.
  765. %% Message queue here is the Erlang process mailbox, but not the number
  766. %% of queued MQTT messages of QoS 1 and 2.
  767. %% Zero or negative is to disable.
  768. {mapping, "zone.$name.force_shutdown_policy", "emqx.zones", [
  769. {default, "default"},
  770. {datatype, string}
  771. ]}.
  772. {mapping, "zone.$name.mountpoint", "emqx.zones", [
  773. {datatype, string}
  774. ]}.
  775. %% @doc Use username replace client id
  776. {mapping, "zone.$name.use_username_as_clientid", "emqx.zones", [
  777. {default, false},
  778. {datatype, {enum, [true, false]}}
  779. ]}.
  780. {translation, "emqx.zones", fun(Conf) ->
  781. Mapping = fun("retain_available", Val) ->
  782. {retain_available, Val};
  783. ("wildcard_subscription", Val) ->
  784. {wildcard_subscription, Val};
  785. ("shared_subscription", Val) ->
  786. {shared_subscription, Val};
  787. ("publish_limit", Val) ->
  788. [L, D] = string:tokens(Val, ", "),
  789. Limit = list_to_integer(L),
  790. Duration = case cuttlefish_duration:parse(D, s) of
  791. Secs when is_integer(Secs) -> Secs;
  792. {error, Reason} -> error(Reason)
  793. end,
  794. Rate = Limit / Duration,
  795. {publish_limit, {Rate, Limit}};
  796. ("force_gc_policy", Val) ->
  797. [Count, Bytes] = string:tokens(Val, "| "),
  798. GcPolicy = case cuttlefish_bytesize:parse(Bytes) of
  799. {error, Reason} ->
  800. error(Reason);
  801. Bytes1 ->
  802. #{bytes => Bytes1,
  803. count => list_to_integer(Count)}
  804. end,
  805. {force_gc_policy, GcPolicy};
  806. ("force_shutdown_policy", "default") ->
  807. {DefaultLen, DefaultSize} =
  808. case WordSize = erlang:system_info(wordsize) of
  809. 8 -> % arch_64
  810. {8000, cuttlefish_bytesize:parse("800MB")};
  811. 4 -> % arch_32
  812. {1000, cuttlefish_bytesize:parse("100MB")}
  813. end,
  814. {force_shutdown_policy, #{message_queue_len => DefaultLen,
  815. max_heap_size => DefaultSize div WordSize
  816. }};
  817. ("force_shutdown_policy", Val) ->
  818. [Len, Siz] = string:tokens(Val, "| "),
  819. MaxSiz = case WordSize = erlang:system_info(wordsize) of
  820. 8 -> % arch_64
  821. (1 bsl 59) - 1;
  822. 4 -> % arch_32
  823. (1 bsl 27) - 1
  824. end,
  825. ShutdownPolicy =
  826. case cuttlefish_bytesize:parse(Siz) of
  827. {error, Reason} ->
  828. error(Reason);
  829. Siz1 when Siz1 > MaxSiz ->
  830. cuttlefish:invalid(io_lib:format("force_shutdown_policy: heap-size ~s is too large", [Siz]));
  831. Siz1 ->
  832. #{message_queue_len => list_to_integer(Len),
  833. max_heap_size => Siz1 div WordSize}
  834. end,
  835. {force_shutdown_policy, ShutdownPolicy};
  836. ("mqueue_priorities", Val) ->
  837. case Val of
  838. "none" -> {mqueue_priorities, none}; % NO_PRIORITY_TABLE
  839. _ ->
  840. MqueuePriorities = lists:foldl(fun(T, Acc) ->
  841. %% NOTE: space in "= " is intended
  842. [Topic, Prio] = string:tokens(T, "= "),
  843. P = list_to_integer(Prio),
  844. (P < 0 orelse P > 255) andalso error({bad_priority, Topic, Prio}),
  845. maps:put(iolist_to_binary(Topic), P, Acc)
  846. end, #{}, string:tokens(Val, ",")),
  847. {mqueue_priorities, MqueuePriorities}
  848. end;
  849. ("mountpoint", Val) ->
  850. {mountpoint, iolist_to_binary(Val)};
  851. (Opt, Val) ->
  852. {list_to_atom(Opt), Val}
  853. end,
  854. maps:to_list(
  855. lists:foldl(
  856. fun({["zone", Name, Opt], Val}, Zones) ->
  857. maps:update_with(list_to_atom(Name),
  858. fun(Opts) -> [Mapping(Opt, Val)|Opts] end,
  859. [Mapping(Opt, Val)], Zones)
  860. end, #{}, lists:usort(cuttlefish_variable:filter_by_prefix("zone.", Conf))))
  861. end}.
  862. %%--------------------------------------------------------------------
  863. %% Listeners
  864. %%--------------------------------------------------------------------
  865. %%--------------------------------------------------------------------
  866. %% TCP Listeners
  867. {mapping, "listener.tcp.$name", "emqx.listeners", [
  868. {datatype, [integer, ip]}
  869. ]}.
  870. {mapping, "listener.tcp.$name.acceptors", "emqx.listeners", [
  871. {default, 8},
  872. {datatype, integer}
  873. ]}.
  874. {mapping, "listener.tcp.$name.max_connections", "emqx.listeners", [
  875. {default, 1024},
  876. {datatype, integer}
  877. ]}.
  878. {mapping, "listener.tcp.$name.max_conn_rate", "emqx.listeners", [
  879. {datatype, integer}
  880. ]}.
  881. {mapping, "listener.tcp.$name.active_n", "emqx.listeners", [
  882. {default, 100},
  883. {datatype, integer}
  884. ]}.
  885. {mapping, "listener.tcp.$name.zone", "emqx.listeners", [
  886. {datatype, string}
  887. ]}.
  888. {mapping, "listener.tcp.$name.rate_limit", "emqx.listeners", [
  889. {default, undefined},
  890. {datatype, string}
  891. ]}.
  892. {mapping, "listener.tcp.$name.access.$id", "emqx.listeners", [
  893. {datatype, string}
  894. ]}.
  895. {mapping, "listener.tcp.$name.proxy_protocol", "emqx.listeners", [
  896. {datatype, flag}
  897. ]}.
  898. {mapping, "listener.tcp.$name.proxy_protocol_timeout", "emqx.listeners", [
  899. {datatype, {duration, ms}}
  900. ]}.
  901. {mapping, "listener.tcp.$name.peer_cert_as_username", "emqx.listeners", [
  902. {datatype, {enum, [cn, dn, crt]}}
  903. ]}.
  904. {mapping, "listener.tcp.$name.backlog", "emqx.listeners", [
  905. {datatype, integer},
  906. {default, 1024}
  907. ]}.
  908. {mapping, "listener.tcp.$name.send_timeout", "emqx.listeners", [
  909. {datatype, {duration, ms}},
  910. {default, "15s"}
  911. ]}.
  912. {mapping, "listener.tcp.$name.send_timeout_close", "emqx.listeners", [
  913. {datatype, flag},
  914. {default, on}
  915. ]}.
  916. {mapping, "listener.tcp.$name.recbuf", "emqx.listeners", [
  917. {datatype, bytesize},
  918. hidden
  919. ]}.
  920. {mapping, "listener.tcp.$name.sndbuf", "emqx.listeners", [
  921. {datatype, bytesize},
  922. hidden
  923. ]}.
  924. {mapping, "listener.tcp.$name.buffer", "emqx.listeners", [
  925. {datatype, bytesize},
  926. hidden
  927. ]}.
  928. {mapping, "listener.tcp.$name.tune_buffer", "emqx.listeners", [
  929. {datatype, flag},
  930. hidden
  931. ]}.
  932. {mapping, "listener.tcp.$name.nodelay", "emqx.listeners", [
  933. {datatype, {enum, [true, false]}},
  934. hidden
  935. ]}.
  936. {mapping, "listener.tcp.$name.reuseaddr", "emqx.listeners", [
  937. {datatype, {enum, [true, false]}},
  938. hidden
  939. ]}.
  940. %%--------------------------------------------------------------------
  941. %% SSL Listeners
  942. {mapping, "listener.ssl.$name", "emqx.listeners", [
  943. {datatype, [integer, ip]}
  944. ]}.
  945. {mapping, "listener.ssl.$name.acceptors", "emqx.listeners", [
  946. {default, 8},
  947. {datatype, integer}
  948. ]}.
  949. {mapping, "listener.ssl.$name.max_connections", "emqx.listeners", [
  950. {default, 1024},
  951. {datatype, integer}
  952. ]}.
  953. {mapping, "listener.ssl.$name.max_conn_rate", "emqx.listeners", [
  954. {datatype, integer}
  955. ]}.
  956. {mapping, "listener.ssl.$name.active_n", "emqx.listeners", [
  957. {default, 100},
  958. {datatype, integer}
  959. ]}.
  960. {mapping, "listener.ssl.$name.zone", "emqx.listeners", [
  961. {datatype, string}
  962. ]}.
  963. {mapping, "listener.ssl.$name.rate_limit", "emqx.listeners", [
  964. {default, undefined},
  965. {datatype, string}
  966. ]}.
  967. {mapping, "listener.ssl.$name.access.$id", "emqx.listeners", [
  968. {datatype, string}
  969. ]}.
  970. {mapping, "listener.ssl.$name.proxy_protocol", "emqx.listeners", [
  971. {datatype, flag}
  972. ]}.
  973. {mapping, "listener.ssl.$name.proxy_protocol_timeout", "emqx.listeners", [
  974. {datatype, {duration, ms}}
  975. ]}.
  976. {mapping, "listener.ssl.$name.backlog", "emqx.listeners", [
  977. {default, 1024},
  978. {datatype, integer}
  979. ]}.
  980. {mapping, "listener.ssl.$name.send_timeout", "emqx.listeners", [
  981. {datatype, {duration, ms}},
  982. {default, "15s"}
  983. ]}.
  984. {mapping, "listener.ssl.$name.send_timeout_close", "emqx.listeners", [
  985. {datatype, flag},
  986. {default, on}
  987. ]}.
  988. {mapping, "listener.ssl.$name.recbuf", "emqx.listeners", [
  989. {datatype, bytesize},
  990. hidden
  991. ]}.
  992. {mapping, "listener.ssl.$name.sndbuf", "emqx.listeners", [
  993. {datatype, bytesize},
  994. hidden
  995. ]}.
  996. {mapping, "listener.ssl.$name.buffer", "emqx.listeners", [
  997. {datatype, bytesize},
  998. hidden
  999. ]}.
  1000. {mapping, "listener.ssl.$name.tune_buffer", "emqx.listeners", [
  1001. {datatype, flag},
  1002. hidden
  1003. ]}.
  1004. {mapping, "listener.ssl.$name.nodelay", "emqx.listeners", [
  1005. {datatype, {enum, [true, false]}},
  1006. hidden
  1007. ]}.
  1008. {mapping, "listener.ssl.$name.reuseaddr", "emqx.listeners", [
  1009. {datatype, {enum, [true, false]}},
  1010. hidden
  1011. ]}.
  1012. {mapping, "listener.ssl.$name.tls_versions", "emqx.listeners", [
  1013. {datatype, string}
  1014. ]}.
  1015. {mapping, "listener.ssl.$name.ciphers", "emqx.listeners", [
  1016. {datatype, string}
  1017. ]}.
  1018. {mapping, "listener.ssl.$name.psk_ciphers", "emqx.listeners", [
  1019. {datatype, string}
  1020. ]}.
  1021. {mapping, "listener.ssl.$name.handshake_timeout", "emqx.listeners", [
  1022. {default, "15s"},
  1023. {datatype, {duration, ms}}
  1024. ]}.
  1025. {mapping, "listener.ssl.$name.dhfile", "emqx.listeners", [
  1026. {datatype, string}
  1027. ]}.
  1028. {mapping, "listener.ssl.$name.keyfile", "emqx.listeners", [
  1029. {datatype, string}
  1030. ]}.
  1031. {mapping, "listener.ssl.$name.certfile", "emqx.listeners", [
  1032. {datatype, string}
  1033. ]}.
  1034. {mapping, "listener.ssl.$name.cacertfile", "emqx.listeners", [
  1035. {datatype, string}
  1036. ]}.
  1037. {mapping, "listener.ssl.$name.verify", "emqx.listeners", [
  1038. {datatype, atom}
  1039. ]}.
  1040. {mapping, "listener.ssl.$name.fail_if_no_peer_cert", "emqx.listeners", [
  1041. {datatype, {enum, [true, false]}}
  1042. ]}.
  1043. {mapping, "listener.ssl.$name.secure_renegotiate", "emqx.listeners", [
  1044. {datatype, flag}
  1045. ]}.
  1046. {mapping, "listener.ssl.$name.reuse_sessions", "emqx.listeners", [
  1047. {default, on},
  1048. {datatype, flag}
  1049. ]}.
  1050. {mapping, "listener.ssl.$name.honor_cipher_order", "emqx.listeners", [
  1051. {datatype, flag}
  1052. ]}.
  1053. {mapping, "listener.ssl.$name.peer_cert_as_username", "emqx.listeners", [
  1054. {datatype, {enum, [cn, dn, crt]}}
  1055. ]}.
  1056. %%--------------------------------------------------------------------
  1057. %% MQTT/WebSocket Listeners
  1058. {mapping, "listener.ws.$name", "emqx.listeners", [
  1059. {datatype, [integer, ip]}
  1060. ]}.
  1061. {mapping, "listener.ws.$name.mqtt_path", "emqx.listeners", [
  1062. {default, "/mqtt"},
  1063. {datatype, string}
  1064. ]}.
  1065. {mapping, "listener.ws.$name.acceptors", "emqx.listeners", [
  1066. {default, 8},
  1067. {datatype, integer}
  1068. ]}.
  1069. {mapping, "listener.ws.$name.max_connections", "emqx.listeners", [
  1070. {default, 1024},
  1071. {datatype, integer}
  1072. ]}.
  1073. {mapping, "listener.ws.$name.max_conn_rate", "emqx.listeners", [
  1074. {datatype, integer}
  1075. ]}.
  1076. {mapping, "listener.ws.$name.active_n", "emqx.listeners", [
  1077. {default, 100},
  1078. {datatype, integer}
  1079. ]}.
  1080. {mapping, "listener.ws.$name.zone", "emqx.listeners", [
  1081. {datatype, string}
  1082. ]}.
  1083. {mapping, "listener.ws.$name.rate_limit", "emqx.listeners", [
  1084. {default, undefined},
  1085. {datatype, string}
  1086. ]}.
  1087. {mapping, "listener.ws.$name.access.$id", "emqx.listeners", [
  1088. {datatype, string}
  1089. ]}.
  1090. {mapping, "listener.ws.$name.verify_protocol_header", "emqx.listeners", [
  1091. {default, on},
  1092. {datatype, flag}
  1093. ]}.
  1094. {mapping, "listener.ws.$name.proxy_address_header", "emqx.listeners", [
  1095. {datatype, string},
  1096. hidden
  1097. ]}.
  1098. {mapping, "listener.ws.$name.proxy_port_header", "emqx.listeners", [
  1099. {datatype, string},
  1100. hidden
  1101. ]}.
  1102. {mapping, "listener.ws.$name.proxy_protocol", "emqx.listeners", [
  1103. {datatype, flag}
  1104. ]}.
  1105. {mapping, "listener.ws.$name.proxy_protocol_timeout", "emqx.listeners", [
  1106. {datatype, {duration, ms}}
  1107. ]}.
  1108. {mapping, "listener.ws.$name.backlog", "emqx.listeners", [
  1109. {default, 1024},
  1110. {datatype, integer}
  1111. ]}.
  1112. {mapping, "listener.ws.$name.send_timeout", "emqx.listeners", [
  1113. {datatype, {duration, ms}},
  1114. {default, "15s"}
  1115. ]}.
  1116. {mapping, "listener.ws.$name.send_timeout_close", "emqx.listeners", [
  1117. {datatype, flag},
  1118. {default, on}
  1119. ]}.
  1120. {mapping, "listener.ws.$name.recbuf", "emqx.listeners", [
  1121. {datatype, bytesize},
  1122. hidden
  1123. ]}.
  1124. {mapping, "listener.ws.$name.sndbuf", "emqx.listeners", [
  1125. {datatype, bytesize},
  1126. hidden
  1127. ]}.
  1128. {mapping, "listener.ws.$name.buffer", "emqx.listeners", [
  1129. {datatype, bytesize},
  1130. hidden
  1131. ]}.
  1132. {mapping, "listener.ws.$name.tune_buffer", "emqx.listeners", [
  1133. {datatype, flag},
  1134. hidden
  1135. ]}.
  1136. {mapping, "listener.ws.$name.nodelay", "emqx.listeners", [
  1137. {datatype, {enum, [true, false]}},
  1138. hidden
  1139. ]}.
  1140. {mapping, "listener.ws.$name.compress", "emqx.listeners", [
  1141. {datatype, {enum, [true, false]}},
  1142. hidden
  1143. ]}.
  1144. {mapping, "listener.ws.$name.deflate_opts.level", "emqx.listeners", [
  1145. {datatype, {enum, [none, default, best_compression, best_speed]}},
  1146. hidden
  1147. ]}.
  1148. {mapping, "listener.ws.$name.deflate_opts.mem_level", "emqx.listeners", [
  1149. {datatype, integer},
  1150. {validators, ["range:1-9"]},
  1151. hidden
  1152. ]}.
  1153. {mapping, "listener.ws.$name.deflate_opts.strategy", "emqx.listeners", [
  1154. {datatype, {enum, [default, filtered, huffman_only, rle]}},
  1155. hidden
  1156. ]}.
  1157. {mapping, "listener.ws.$name.deflate_opts.server_context_takeover", "emqx.listeners", [
  1158. {datatype, {enum, [takeover, no_takeover]}},
  1159. hidden
  1160. ]}.
  1161. {mapping, "listener.ws.$name.deflate_opts.client_context_takeover", "emqx.listeners", [
  1162. {datatype, {enum, [takeover, no_takeover]}},
  1163. hidden
  1164. ]}.
  1165. {mapping, "listener.ws.$name.deflate_opts.server_max_window_bits", "emqx.listeners", [
  1166. {datatype, integer},
  1167. hidden
  1168. ]}.
  1169. {mapping, "listener.ws.$name.deflate_opts.client_max_window_bits", "emqx.listeners", [
  1170. {datatype, integer},
  1171. hidden
  1172. ]}.
  1173. {mapping, "listener.ws.$name.idle_timeout", "emqx.listeners", [
  1174. {datatype, {duration, ms}},
  1175. hidden
  1176. ]}.
  1177. {mapping, "listener.ws.$name.max_frame_size", "emqx.listeners", [
  1178. {datatype, integer},
  1179. hidden
  1180. ]}.
  1181. %%--------------------------------------------------------------------
  1182. %% MQTT/WebSocket/SSL Listeners
  1183. {mapping, "listener.wss.$name", "emqx.listeners", [
  1184. {datatype, [integer, ip]}
  1185. ]}.
  1186. {mapping, "listener.wss.$name.mqtt_path", "emqx.listeners", [
  1187. {default, "/mqtt"},
  1188. {datatype, string}
  1189. ]}.
  1190. {mapping, "listener.wss.$name.acceptors", "emqx.listeners", [
  1191. {default, 8},
  1192. {datatype, integer}
  1193. ]}.
  1194. {mapping, "listener.wss.$name.max_connections", "emqx.listeners", [
  1195. {default, 1024},
  1196. {datatype, integer}
  1197. ]}.
  1198. {mapping, "listener.wss.$name.max_conn_rate", "emqx.listeners", [
  1199. {datatype, integer}
  1200. ]}.
  1201. {mapping, "listener.wss.$name.active_n", "emqx.listeners", [
  1202. {default, 100},
  1203. {datatype, integer}
  1204. ]}.
  1205. {mapping, "listener.wss.$name.zone", "emqx.listeners", [
  1206. {datatype, string}
  1207. ]}.
  1208. {mapping, "listener.wss.$name.rate_limit", "emqx.listeners", [
  1209. {datatype, string}
  1210. ]}.
  1211. {mapping, "listener.wss.$name.verify_protocol_header", "emqx.listeners", [
  1212. {default, on},
  1213. {datatype, flag}
  1214. ]}.
  1215. {mapping, "listener.wss.$name.access.$id", "emqx.listeners", [
  1216. {datatype, string}
  1217. ]}.
  1218. {mapping, "listener.wss.$name.proxy_address_header", "emqx.listeners", [
  1219. {datatype, string},
  1220. hidden
  1221. ]}.
  1222. {mapping, "listener.wss.$name.proxy_port_header", "emqx.listeners", [
  1223. {datatype, string},
  1224. hidden
  1225. ]}.
  1226. {mapping, "listener.wss.$name.proxy_protocol", "emqx.listeners", [
  1227. {datatype, flag}
  1228. ]}.
  1229. {mapping, "listener.wss.$name.proxy_protocol_timeout", "emqx.listeners", [
  1230. {datatype, {duration, ms}}
  1231. ]}.
  1232. %%{mapping, "listener.wss.$name.handshake_timeout", "emqx.listeners", [
  1233. %% {default, "15s"},
  1234. %% {datatype, {duration, ms}}
  1235. %%]}.
  1236. {mapping, "listener.wss.$name.backlog", "emqx.listeners", [
  1237. {default, 1024},
  1238. {datatype, integer}
  1239. ]}.
  1240. {mapping, "listener.wss.$name.send_timeout", "emqx.listeners", [
  1241. {datatype, {duration, ms}},
  1242. {default, "15s"}
  1243. ]}.
  1244. {mapping, "listener.wss.$name.send_timeout_close", "emqx.listeners", [
  1245. {datatype, flag},
  1246. {default, on}
  1247. ]}.
  1248. {mapping, "listener.wss.$name.recbuf", "emqx.listeners", [
  1249. {datatype, bytesize},
  1250. hidden
  1251. ]}.
  1252. {mapping, "listener.wss.$name.sndbuf", "emqx.listeners", [
  1253. {datatype, bytesize},
  1254. hidden
  1255. ]}.
  1256. {mapping, "listener.wss.$name.buffer", "emqx.listeners", [
  1257. {datatype, bytesize},
  1258. hidden
  1259. ]}.
  1260. {mapping, "listener.wss.$name.tune_buffer", "emqx.listeners", [
  1261. {datatype, flag},
  1262. hidden
  1263. ]}.
  1264. {mapping, "listener.wss.$name.nodelay", "emqx.listeners", [
  1265. {datatype, {enum, [true, false]}},
  1266. hidden
  1267. ]}.
  1268. {mapping, "listener.wss.$name.tls_versions", "emqx.listeners", [
  1269. {datatype, string}
  1270. ]}.
  1271. {mapping, "listener.wss.$name.ciphers", "emqx.listeners", [
  1272. {datatype, string}
  1273. ]}.
  1274. {mapping, "listener.wss.$name.psk_ciphers", "emqx.listeners", [
  1275. {datatype, string}
  1276. ]}.
  1277. {mapping, "listener.wss.$name.keyfile", "emqx.listeners", [
  1278. {datatype, string}
  1279. ]}.
  1280. {mapping, "listener.wss.$name.certfile", "emqx.listeners", [
  1281. {datatype, string}
  1282. ]}.
  1283. {mapping, "listener.wss.$name.cacertfile", "emqx.listeners", [
  1284. {datatype, string}
  1285. ]}.
  1286. {mapping, "listener.wss.$name.verify", "emqx.listeners", [
  1287. {datatype, atom}
  1288. ]}.
  1289. {mapping, "listener.wss.$name.fail_if_no_peer_cert", "emqx.listeners", [
  1290. {datatype, {enum, [true, false]}}
  1291. ]}.
  1292. {mapping, "listener.wss.$name.secure_renegotiate", "emqx.listeners", [
  1293. {datatype, flag}
  1294. ]}.
  1295. {mapping, "listener.wss.$name.reuse_sessions", "emqx.listeners", [
  1296. {default, on},
  1297. {datatype, flag}
  1298. ]}.
  1299. {mapping, "listener.wss.$name.honor_cipher_order", "emqx.listeners", [
  1300. {datatype, flag}
  1301. ]}.
  1302. {mapping, "listener.wss.$name.peer_cert_as_username", "emqx.listeners", [
  1303. {datatype, {enum, [cn, dn, crt]}}
  1304. ]}.
  1305. {mapping, "listener.wss.$name.compress", "emqx.listeners", [
  1306. {datatype, {enum, [true, false]}},
  1307. hidden
  1308. ]}.
  1309. {mapping, "listener.wss.$name.deflate_opts.level", "emqx.listeners", [
  1310. {datatype, {enum, [none, default, best_compression, best_speed]}},
  1311. hidden
  1312. ]}.
  1313. {mapping, "listener.wss.$name.deflate_opts.mem_level", "emqx.listeners", [
  1314. {datatype, integer},
  1315. {validators, ["range:1-9"]},
  1316. hidden
  1317. ]}.
  1318. {mapping, "listener.wss.$name.deflate_opts.strategy", "emqx.listeners", [
  1319. {datatype, {enum, [default, filtered, huffman_only, rle]}},
  1320. hidden
  1321. ]}.
  1322. {mapping, "listener.wss.$name.deflate_opts.server_context_takeover", "emqx.listeners", [
  1323. {datatype, {enum, [takeover, no_takeover]}},
  1324. hidden
  1325. ]}.
  1326. {mapping, "listener.wss.$name.deflate_opts.client_context_takeover", "emqx.listeners", [
  1327. {datatype, {enum, [takeover, no_takeover]}},
  1328. hidden
  1329. ]}.
  1330. {mapping, "listener.wss.$name.deflate_opts.server_max_window_bits", "emqx.listeners", [
  1331. {datatype, integer},
  1332. {validators, ["range:8-15"]},
  1333. hidden
  1334. ]}.
  1335. {mapping, "listener.wss.$name.deflate_opts.client_max_window_bits", "emqx.listeners", [
  1336. {datatype, integer},
  1337. {validators, ["range:8-15"]},
  1338. hidden
  1339. ]}.
  1340. {mapping, "listener.wss.$name.idle_timeout", "emqx.listeners", [
  1341. {datatype, {duration, ms}},
  1342. hidden
  1343. ]}.
  1344. {mapping, "listener.wss.$name.max_frame_size", "emqx.listeners", [
  1345. {datatype, integer},
  1346. hidden
  1347. ]}.
  1348. {translation, "emqx.listeners", fun(Conf) ->
  1349. Filter = fun(Opts) -> [{K, V} || {K, V} <- Opts, V =/= undefined] end,
  1350. Atom = fun(undefined) -> undefined; (S) -> list_to_atom(S) end,
  1351. Access = fun(S) ->
  1352. [A, CIDR] = string:tokens(S, " "),
  1353. {list_to_atom(A), case CIDR of "all" -> all; _ -> CIDR end}
  1354. end,
  1355. AccOpts = fun(Prefix) ->
  1356. case cuttlefish_variable:filter_by_prefix(Prefix ++ ".access", Conf) of
  1357. [] -> [];
  1358. Rules -> [{access_rules, [Access(Rule) || {_, Rule} <- Rules]}]
  1359. end
  1360. end,
  1361. RateLimit = fun(undefined) ->
  1362. undefined;
  1363. (Val) ->
  1364. [L, D] = string:tokens(Val, ", "),
  1365. Limit = case cuttlefish_bytesize:parse(L) of
  1366. Sz when is_integer(Sz) -> Sz;
  1367. {error, Reason} -> error(Reason)
  1368. end,
  1369. Duration = case cuttlefish_duration:parse(D, s) of
  1370. Secs when is_integer(Secs) -> Secs;
  1371. {error, Reason1} -> error(Reason1)
  1372. end,
  1373. Rate = Limit / Duration,
  1374. {Rate, Limit}
  1375. end,
  1376. LisOpts = fun(Prefix) ->
  1377. Filter([{acceptors, cuttlefish:conf_get(Prefix ++ ".acceptors", Conf)},
  1378. {mqtt_path, cuttlefish:conf_get(Prefix ++ ".mqtt_path", Conf, undefined)},
  1379. {max_connections, cuttlefish:conf_get(Prefix ++ ".max_connections", Conf)},
  1380. {max_conn_rate, cuttlefish:conf_get(Prefix ++ ".max_conn_rate", Conf, undefined)},
  1381. {active_n, cuttlefish:conf_get(Prefix ++ ".active_n", Conf, undefined)},
  1382. {tune_buffer, cuttlefish:conf_get(Prefix ++ ".tune_buffer", Conf, undefined)},
  1383. {zone, Atom(cuttlefish:conf_get(Prefix ++ ".zone", Conf, undefined))},
  1384. {rate_limit, RateLimit(cuttlefish:conf_get(Prefix ++ ".rate_limit", Conf, undefined))},
  1385. {proxy_protocol, cuttlefish:conf_get(Prefix ++ ".proxy_protocol", Conf, undefined)},
  1386. {proxy_protocol_timeout, cuttlefish:conf_get(Prefix ++ ".proxy_protocol_timeout", Conf, undefined)},
  1387. {verify_protocol_header, cuttlefish:conf_get(Prefix ++ ".verify_protocol_header", Conf, undefined)},
  1388. {peer_cert_as_username, cuttlefish:conf_get(Prefix ++ ".peer_cert_as_username", Conf, undefined)},
  1389. {proxy_port_header, cuttlefish:conf_get(Prefix ++ ".proxy_port_header", Conf, undefined)},
  1390. {compress, cuttlefish:conf_get(Prefix ++ ".compress", Conf, undefined)},
  1391. {idle_timeout, cuttlefish:conf_get(Prefix ++ ".idle_timeout", Conf, undefined)},
  1392. {max_frame_size, cuttlefish:conf_get(Prefix ++ ".max_frame_size", Conf, undefined)},
  1393. {proxy_address_header, cuttlefish:conf_get(Prefix ++ ".proxy_address_header", Conf, undefined)} | AccOpts(Prefix)])
  1394. end,
  1395. DeflateOpts = fun(Prefix) ->
  1396. Filter([{level, cuttlefish:conf_get(Prefix ++ ".deflate_opts.level", Conf, undefined)},
  1397. {mem_level, cuttlefish:conf_get(Prefix ++ ".deflate_opts.mem_level", Conf, undefined)},
  1398. {strategy, cuttlefish:conf_get(Prefix ++ ".deflate_opts.strategy", Conf, undefined)},
  1399. {server_context_takeover, cuttlefish:conf_get(Prefix ++ ".deflate_opts.server_context_takeover", Conf, undefined)},
  1400. {client_context_takeover, cuttlefish:conf_get(Prefix ++ ".deflate_opts.client_context_takeover", Conf, undefined)},
  1401. {server_max_windows_bits, cuttlefish:conf_get(Prefix ++ ".deflate_opts.server_max_window_bits", Conf, undefined)},
  1402. {client_max_windows_bits, cuttlefish:conf_get(Prefix ++ ".deflate_opts.client_max_window_bits", Conf, undefined)}])
  1403. end,
  1404. TcpOpts = fun(Prefix) ->
  1405. Filter([{backlog, cuttlefish:conf_get(Prefix ++ ".backlog", Conf, undefined)},
  1406. {send_timeout, cuttlefish:conf_get(Prefix ++ ".send_timeout", Conf, undefined)},
  1407. {send_timeout_close, cuttlefish:conf_get(Prefix ++ ".send_timeout_close", Conf, undefined)},
  1408. {recbuf, cuttlefish:conf_get(Prefix ++ ".recbuf", Conf, undefined)},
  1409. {sndbuf, cuttlefish:conf_get(Prefix ++ ".sndbuf", Conf, undefined)},
  1410. {buffer, cuttlefish:conf_get(Prefix ++ ".buffer", Conf, undefined)},
  1411. {nodelay, cuttlefish:conf_get(Prefix ++ ".nodelay", Conf, true)},
  1412. {reuseaddr, cuttlefish:conf_get(Prefix ++ ".reuseaddr", Conf, undefined)}])
  1413. end,
  1414. SplitFun = fun(undefined) -> undefined; (S) -> string:tokens(S, ",") end,
  1415. MapPSKCiphers = fun(PSKCiphers) ->
  1416. lists:map(
  1417. fun("PSK-AES128-CBC-SHA") -> {psk, aes_128_cbc, sha};
  1418. ("PSK-AES256-CBC-SHA") -> {psk, aes_256_cbc, sha};
  1419. ("PSK-3DES-EDE-CBC-SHA") -> {psk, '3des_ede_cbc', sha};
  1420. ("PSK-RC4-SHA") -> {psk, rc4_128, sha}
  1421. end, PSKCiphers)
  1422. end,
  1423. SslOpts = fun(Prefix) ->
  1424. Versions = case SplitFun(cuttlefish:conf_get(Prefix ++ ".tls_versions", Conf, undefined)) of
  1425. undefined -> undefined;
  1426. L -> [list_to_atom(V) || V <- L]
  1427. end,
  1428. TLSCiphers = cuttlefish:conf_get(Prefix++".ciphers", Conf, undefined),
  1429. PSKCiphers = cuttlefish:conf_get(Prefix++".psk_ciphers", Conf, undefined),
  1430. Ciphers =
  1431. case {TLSCiphers, PSKCiphers} of
  1432. {undefined, undefined} ->
  1433. cuttlefish:invalid(Prefix++".ciphers or "++Prefix++".psk_ciphers is absent");
  1434. {TLSCiphers, undefined} ->
  1435. SplitFun(TLSCiphers);
  1436. {undefined, PSKCiphers} ->
  1437. MapPSKCiphers(SplitFun(PSKCiphers));
  1438. {_TLSCiphers, _PSKCiphers} ->
  1439. cuttlefish:invalid(Prefix++".ciphers and "++Prefix++".psk_ciphers cannot be configured at the same time")
  1440. end,
  1441. UserLookupFun =
  1442. case PSKCiphers of
  1443. undefined -> undefined;
  1444. _ -> {fun emqx_psk:lookup/3, <<>>}
  1445. end,
  1446. Filter([{versions, Versions},
  1447. {ciphers, Ciphers},
  1448. {user_lookup_fun, UserLookupFun},
  1449. {handshake_timeout, cuttlefish:conf_get(Prefix ++ ".handshake_timeout", Conf, undefined)},
  1450. {dhfile, cuttlefish:conf_get(Prefix ++ ".dhfile", Conf, undefined)},
  1451. {keyfile, cuttlefish:conf_get(Prefix ++ ".keyfile", Conf, undefined)},
  1452. {certfile, cuttlefish:conf_get(Prefix ++ ".certfile", Conf, undefined)},
  1453. {cacertfile, cuttlefish:conf_get(Prefix ++ ".cacertfile", Conf, undefined)},
  1454. {verify, cuttlefish:conf_get(Prefix ++ ".verify", Conf, undefined)},
  1455. {fail_if_no_peer_cert, cuttlefish:conf_get(Prefix ++ ".fail_if_no_peer_cert", Conf, undefined)},
  1456. {secure_renegotiate, cuttlefish:conf_get(Prefix ++ ".secure_renegotiate", Conf, undefined)},
  1457. {reuse_sessions, cuttlefish:conf_get(Prefix ++ ".reuse_sessions", Conf, undefined)},
  1458. {honor_cipher_order, cuttlefish:conf_get(Prefix ++ ".honor_cipher_order", Conf, undefined)}])
  1459. end,
  1460. TcpListeners = fun(Type, Name) ->
  1461. Prefix = string:join(["listener", Type, Name], "."),
  1462. case cuttlefish:conf_get(Prefix, Conf, undefined) of
  1463. undefined -> [];
  1464. ListenOn ->
  1465. [{Atom(Type), ListenOn, [{deflate_options, DeflateOpts(Prefix)},
  1466. {tcp_options, TcpOpts(Prefix)} | LisOpts(Prefix)]}]
  1467. end
  1468. end,
  1469. SslListeners = fun(Type, Name) ->
  1470. Prefix = string:join(["listener", Type, Name], "."),
  1471. case cuttlefish:conf_get(Prefix, Conf, undefined) of
  1472. undefined ->
  1473. [];
  1474. ListenOn ->
  1475. [{Atom(Type), ListenOn, [{deflate_options, DeflateOpts(Prefix)},
  1476. {tcp_options, TcpOpts(Prefix)},
  1477. {ssl_options, SslOpts(Prefix)} | LisOpts(Prefix)]}]
  1478. end
  1479. end,
  1480. lists:flatten([TcpListeners(Type, Name) || {["listener", Type, Name], ListenOn}
  1481. <- cuttlefish_variable:filter_by_prefix("listener.tcp", Conf)
  1482. ++ cuttlefish_variable:filter_by_prefix("listener.ws", Conf)]
  1483. ++
  1484. [SslListeners(Type, Name) || {["listener", Type, Name], ListenOn}
  1485. <- cuttlefish_variable:filter_by_prefix("listener.ssl", Conf)
  1486. ++ cuttlefish_variable:filter_by_prefix("listener.wss", Conf)])
  1487. end}.
  1488. %%--------------------------------------------------------------------
  1489. %% Modules
  1490. %%--------------------------------------------------------------------
  1491. {mapping, "module.presence", "emqx.modules", [
  1492. {default, off},
  1493. {datatype, flag}
  1494. ]}.
  1495. {mapping, "module.presence.qos", "emqx.modules", [
  1496. {default, 1},
  1497. {datatype, integer},
  1498. {validators, ["range:0-2"]}
  1499. ]}.
  1500. {mapping, "module.subscription", "emqx.modules", [
  1501. {default, off},
  1502. {datatype, flag}
  1503. ]}.
  1504. {mapping, "module.subscription.$id.topic", "emqx.modules", [
  1505. {datatype, string}
  1506. ]}.
  1507. {mapping, "module.subscription.$id.qos", "emqx.modules", [
  1508. {default, 1},
  1509. {datatype, integer},
  1510. {validators, ["range:0-2"]}
  1511. ]}.
  1512. {mapping, "module.rewrite", "emqx.modules", [
  1513. {default, off},
  1514. {datatype, flag}
  1515. ]}.
  1516. {mapping, "module.rewrite.rule.$id", "emqx.modules", [
  1517. {datatype, string}
  1518. ]}.
  1519. {translation, "emqx.modules", fun(Conf) ->
  1520. Subscriptions = fun() ->
  1521. List = cuttlefish_variable:filter_by_prefix("module.subscription", Conf),
  1522. QosList = [Qos || {_, Qos} <- lists:sort([{I, Qos} || {[_,"subscription", I,"qos"], Qos} <- List])],
  1523. TopicList = [iolist_to_binary(Topic) || {_, Topic} <-
  1524. lists:sort([{I, Topic} || {[_,"subscription", I, "topic"], Topic} <- List])],
  1525. lists:zip(TopicList, QosList)
  1526. end,
  1527. Rewrites = fun() ->
  1528. Rules = cuttlefish_variable:filter_by_prefix("module.rewrite.rule", Conf),
  1529. lists:map(fun({[_, "rewrite", "rule", I], Rule}) ->
  1530. [Topic, Re, Dest] = string:tokens(Rule, " "),
  1531. {rewrite, list_to_binary(Topic), list_to_binary(Re), list_to_binary(Dest)}
  1532. end, Rules)
  1533. end,
  1534. lists:append([
  1535. case cuttlefish:conf_get("module.presence", Conf) of %% Presence
  1536. true -> [{emqx_mod_presence, [{qos, cuttlefish:conf_get("module.presence.qos", Conf, 1)}]}];
  1537. false -> []
  1538. end,
  1539. case cuttlefish:conf_get("module.subscription", Conf) of %% Subscription
  1540. true -> [{emqx_mod_subscription, Subscriptions()}];
  1541. false -> []
  1542. end,
  1543. case cuttlefish:conf_get("module.rewrite", Conf) of %% Rewrite
  1544. true -> [{emqx_mod_rewrite, Rewrites()}];
  1545. false -> []
  1546. end
  1547. ])
  1548. end}.
  1549. %%-------------------------------------------------------------------
  1550. %% Plugins
  1551. %%-------------------------------------------------------------------
  1552. {mapping, "plugins.etc_dir", "emqx.plugins_etc_dir", [
  1553. {datatype, string}
  1554. ]}.
  1555. {mapping, "plugins.loaded_file", "emqx.plugins_loaded_file", [
  1556. {datatype, string}
  1557. ]}.
  1558. {mapping, "plugins.expand_plugins_dir", "emqx.expand_plugins_dir", [
  1559. {datatype, string}
  1560. ]}.
  1561. %%--------------------------------------------------------------------
  1562. %% Broker
  1563. %%--------------------------------------------------------------------
  1564. {mapping, "broker.sys_interval", "emqx.broker_sys_interval", [
  1565. {datatype, {duration, ms}},
  1566. {default, "1m"}
  1567. ]}.
  1568. {mapping, "broker.sys_heartbeat", "emqx.broker_sys_heartbeat", [
  1569. {datatype, {duration, ms}},
  1570. {default, "30s"}
  1571. ]}.
  1572. {mapping, "broker.enable_session_registry", "emqx.enable_session_registry", [
  1573. {default, on},
  1574. {datatype, flag}
  1575. ]}.
  1576. {mapping, "broker.session_locking_strategy", "emqx.session_locking_strategy", [
  1577. {default, quorum},
  1578. {datatype, {enum, [local,one,quorum,all]}}
  1579. ]}.
  1580. %% @doc Shared Subscription Dispatch Strategy.
  1581. {mapping, "broker.shared_subscription_strategy", "emqx.shared_subscription_strategy", [
  1582. {default, round_robin},
  1583. {datatype,
  1584. {enum,
  1585. [random, %% randomly pick a subscriber
  1586. round_robin, %% round robin alive subscribers one message after another
  1587. sticky, %% pick a random subscriber and stick to it
  1588. hash %% hash client ID to a group member
  1589. ]}}
  1590. ]}.
  1591. %% @doc Enable or disable shared dispatch acknowledgement for QoS1 and QoS2 messages
  1592. {mapping, "broker.shared_dispatch_ack_enabled", "emqx.shared_dispatch_ack_enabled",
  1593. [ {default, false},
  1594. {datatype, {enum, [true, false]}}
  1595. ]}.
  1596. {mapping, "broker.route_batch_clean", "emqx.route_batch_clean", [
  1597. {default, on},
  1598. {datatype, flag}
  1599. ]}.
  1600. %%--------------------------------------------------------------------
  1601. %% System Monitor
  1602. %%--------------------------------------------------------------------
  1603. %% @doc Long GC, don't monitor in production mode for:
  1604. %% https://github.com/erlang/otp/blob/feb45017da36be78d4c5784d758ede619fa7bfd3/erts/emulator/beam/erl_gc.c#L421
  1605. {mapping, "sysmon.long_gc", "emqx.sysmon", [
  1606. {default, 0},
  1607. {datatype, [integer, {duration, ms}]}
  1608. ]}.
  1609. %% @doc Long Schedule(ms)
  1610. {mapping, "sysmon.long_schedule", "emqx.sysmon", [
  1611. {default, 240},
  1612. {datatype, [integer, {duration, ms}]}
  1613. ]}.
  1614. %% @doc Large Heap
  1615. {mapping, "sysmon.large_heap", "emqx.sysmon", [
  1616. {default, "8MB"},
  1617. {datatype, bytesize}
  1618. ]}.
  1619. %% @doc Monitor Busy Port
  1620. {mapping, "sysmon.busy_port", "emqx.sysmon", [
  1621. {default, false},
  1622. {datatype, {enum, [true, false]}}
  1623. ]}.
  1624. %% @doc Monitor Busy Dist Port
  1625. {mapping, "sysmon.busy_dist_port", "emqx.sysmon", [
  1626. {default, true},
  1627. {datatype, {enum, [true, false]}}
  1628. ]}.
  1629. {translation, "emqx.sysmon", fun(Conf) ->
  1630. Configs = cuttlefish_variable:filter_by_prefix("sysmon", Conf),
  1631. [{list_to_atom(Name), Value} || {[_, Name], Value} <- Configs]
  1632. end}.
  1633. %%--------------------------------------------------------------------
  1634. %% Operating System Monitor
  1635. %%--------------------------------------------------------------------
  1636. {mapping, "os_mon.cpu_check_interval", "emqx.os_mon", [
  1637. {default, 60},
  1638. {datatype, {duration, s}}
  1639. ]}.
  1640. {mapping, "os_mon.cpu_high_watermark", "emqx.os_mon", [
  1641. {default, "80%"},
  1642. {datatype, {percent, float}}
  1643. ]}.
  1644. {mapping, "os_mon.cpu_low_watermark", "emqx.os_mon", [
  1645. {default, "60%"},
  1646. {datatype, {percent, float}}
  1647. ]}.
  1648. {mapping, "os_mon.mem_check_interval", "emqx.os_mon", [
  1649. {default, 60},
  1650. {datatype, {duration, s}}
  1651. ]}.
  1652. {mapping, "os_mon.sysmem_high_watermark", "emqx.os_mon", [
  1653. {default, "70%"},
  1654. {datatype, {percent, float}}
  1655. ]}.
  1656. {mapping, "os_mon.procmem_high_watermark", "emqx.os_mon", [
  1657. {default, "5%"},
  1658. {datatype, {percent, float}}
  1659. ]}.
  1660. {translation, "emqx.os_mon", fun(Conf) ->
  1661. Configs = cuttlefish_variable:filter_by_prefix("os_mon", Conf),
  1662. [{list_to_atom(Name), Value} || {[_, Name], Value} <- Configs]
  1663. end}.
  1664. %%--------------------------------------------------------------------
  1665. %% VM Monitor
  1666. %%--------------------------------------------------------------------
  1667. {mapping, "vm_mon.check_interval", "emqx.vm_mon", [
  1668. {default, 30},
  1669. {datatype, {duration, s}}
  1670. ]}.
  1671. {mapping, "vm_mon.process_high_watermark", "emqx.vm_mon", [
  1672. {default, "80%"},
  1673. {datatype, {percent, float}}
  1674. ]}.
  1675. {mapping, "vm_mon.process_low_watermark", "emqx.vm_mon", [
  1676. {default, "60%"},
  1677. {datatype, {percent, float}}
  1678. ]}.
  1679. {translation, "emqx.vm_mon", fun(Conf) ->
  1680. Configs = cuttlefish_variable:filter_by_prefix("vm_mon", Conf),
  1681. [{list_to_atom(Name), Value} || {[_, Name], Value} <- Configs]
  1682. end}.