लॉगिंग। "बॉक्स से बाहर"

लॉगिंग का उपयोग प्रत्येक सॉफ़्टवेयर उत्पाद में किया जाता है जो उत्पादन स्तर तक बच गया है। एरलैंग प्रोग्रामर्स को संपूर्ण पारिस्थितिकी तंत्र प्रदान करता है जिसमें एप्लिकेशन ट्रैकिंग तंत्र शामिल हैं। इस भाग में, मैं "बॉक्स से बाहर" कार्यक्षमता पर विचार करूंगा।

0. यह कैसे काम करता है

अन्य अंतर्निहित उपयोगिताओं की तरह, लॉगिंग OTP के सिद्धांतों पर आधारित है।

Erlang त्रुटि लकड़हारा एक इवेंट मैनेजर है (gen_event (3)) error_logger के रूप में पंजीकृत। त्रुटि, चेतावनी और जानकारी की घटनाओं को एरलांग आरटीएस और विभिन्न अनुप्रयोगों से error_logger पर भेजा जाता है। डिफ़ॉल्ट रूप से, वे कंसोल में प्रदर्शित होते हैं।

प्रारंभ में, error_logger सबसे सरल ईवेंट हैंडलर का उपयोग करता है, जो बफ़र करता है और कच्चे ईवेंट संदेशों को प्रिंट करता है। लॉन्च के समय, कर्नेल एप्लिकेशन इसे अपने इवेंट हैंडलर से बदल देता है।

सार्वभौमिक रिपोर्ट प्राप्त करने के लिए अपने अनुप्रयोगों में error_logger का उपयोग करने की अनुशंसा की जाती है। उपयोगकर्ता अपने स्वयं के ईवेंट हैंडलर (add_report_handler / 1,2) जोड़ सकता है।

1. एसएएसएल

हर एर्लैंग प्रोग्रामर जानता है कि एसएएसएल क्या है। अधिकांश ट्यूटोरियल इसका उपयोग करके लिखे गए हैं। हम अनुप्रयोगों को डीबग करते समय निश्चित रूप से एसएएसएल को सक्षम करते हैं।

एसएएसएल पर्यवेक्षकों के कार्य और होने वाली त्रुटियों से संबंधित विभिन्न रिपोर्टों की एक विस्तृत रिपोर्ट प्रदान करता है।

root@37221-1:~# erl -boot start_sasl Erlang R13B03 (erts-5.7.4) [source] [rq:1] [async-threads:0] [hipe] [kernel-poll:false] =PROGRESS REPORT==== 11-Mar-2011::19:34:39 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.35.0>}, {name,alarm_handler}, {mfa,{alarm_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:34:39 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.36.0>}, {name,overload}, {mfa,{overload,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:34:39 === supervisor: {local,sasl_sup} started: [{pid,<0.34.0>}, {name,sasl_safe_sup}, {mfa, {supervisor,start_link, [{local,sasl_safe_sup},sasl,safe]}}, {restart_type,permanent}, {shutdown,infinity}, {child_type,supervisor}] =PROGRESS REPORT==== 11-Mar-2011::19:34:39 === supervisor: {local,sasl_sup} started: [{pid,<0.37.0>}, {name,release_handler}, {mfa,{release_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:34:39 === application: sasl started_at: nonode@nohost Eshell V5.7.4 (abort with ^G) 1> application:start(crypto). =PROGRESS REPORT==== 11-Mar-2011::19:34:54 === supervisor: {local,crypto_sup} started: [{pid,<0.49.0>}, {name,crypto_server}, {mfa,{crypto_server,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:34:54 === application: crypto started_at: nonode@nohost ok 2> rb:start(). {error,{"cannot locate report directory", {child,undefined,rb_server, {rb,start_link,[[]]}, temporary,brutal_kill,worker, [rb]}}} 3> =CRASH REPORT==== 11-Mar-2011::19:35:16 === crasher: initial call: rb:init/1 pid: <0.51.0> registered_name: [] exception exit: "cannot locate report directory" in function gen_server:init_it/6 ancestors: [sasl_sup,<0.32.0>] messages: [] links: [<0.33.0>] dictionary: [] trap_exit: true status: running heap_size: 233 stack_size: 24 reductions: 109 neighbours: 

एसएएसएल में 3 इवेंट हैंडलर शामिल हैं:

• sasl_report_tty_h - पर्यवेक्षक रिपोर्ट, क्रैश रिपोर्ट और प्रगति कंसोल में प्रदर्शित होती हैं।
• sasl_report_file_h - पर्यवेक्षक रिपोर्ट, क्रैश रिपोर्ट और प्रगति एक अलग फ़ाइल में प्रदर्शित की जाती हैं।
• error_logger_mf_h - यह लकड़हारा सभी घटनाओं को संसाधित करता है। यह error_logger में इवेंट हैंडलर log_mf_h (अधिक नीचे) सेट करता है।

एसएएसएल विशिष्ट विन्यास का समर्थन करता है, जिसे प्रलेखन में विस्तार से वर्णित किया गया है। Sasl_report_file_h और sasl_error_logger = {फ़ाइल सेट करना, FileName} संचालकों को अलग लॉग फ़ाइल में आउटपुट जानकारी की अनुमति देगा। हालाँकि, जब आप अनुप्रयोग को पुनरारंभ करते हैं, तो सभी पुरानी जानकारी हटा दी जाएगी (!)।

2. log_mf_h

log_mf_h एक gen_event हैंडलर है जिसे किसी भी gen_event प्रक्रिया में स्थापित किया जा सकता है। यह सभी घटनाओं को डिस्क पर सहेजता है। प्रत्येक घटना को बाइनरी प्रारूप में सहेजा जाता है। इन लॉग को पढ़ने के लिए रिपोर्ट ब्राउजर (आरबी) जैसे एप्लिकेशन का उपयोग किया जा सकता है।

log_mf_h: init / 3,4 gen_event के लिए कॉन्फ़िगरेशन कॉन्फ़िगरेशन तर्क: add_handler (EventMgr, log_mf_h, Args)। उनका उपयोग किसी भी इवेंट मैनेजर में किया जा सकता है।

 root@37221-1:/home/user# erl -boot start_sasl Erlang R13B03 (erts-5.7.4) [source] [rq:1] [async-threads:0] [hipe] [kernel-poll:false] =PROGRESS REPORT==== 11-Mar-2011::19:48:22 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.35.0>}, {name,alarm_handler}, {mfa,{alarm_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:48:22 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.36.0>}, {name,overload}, {mfa,{overload,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:48:22 === supervisor: {local,sasl_sup} started: [{pid,<0.34.0>}, {name,sasl_safe_sup}, {mfa, {supervisor,start_link, [{local,sasl_safe_sup},sasl,safe]}}, {restart_type,permanent}, {shutdown,infinity}, {child_type,supervisor}] =PROGRESS REPORT==== 11-Mar-2011::19:48:22 === supervisor: {local,sasl_sup} started: [{pid,<0.37.0>}, {name,release_handler}, {mfa,{release_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:48:22 === application: sasl started_at: nonode@nohost Eshell V5.7.4 (abort with ^G) 1> Conf = log_mf_h:init(".", 1024, 10). {".",1024,10,#Fun<log_mf_h.0.56828844>} 2> gen_event:add_handler(error_logger, log_mf_h, Conf). ok 3> F = fun(N) -> N() end. #Fun<erl_eval.6.13229925> 4> spawn(F). =ERROR REPORT==== 11-Mar-2011::19:49:59 === Error in process <0.48.0> with exit value: {{badarity,{#Fun<erl_eval.6.13229925>,[]}},[{erlang,apply,2}]} <0.48.0> 5> application:start(crypto). =PROGRESS REPORT==== 11-Mar-2011::19:50:29 === supervisor: {local,crypto_sup} started: [{pid,<0.54.0>}, {name,crypto_server}, {mfa,{crypto_server,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::19:50:29 === application: crypto started_at: nonode@nohost ok 6> rb:start([{report_dir, "."}]). rb: reading report...done. =PROGRESS REPORT==== 11-Mar-2011::19:50:53 === supervisor: {local,sasl_sup} started: [{pid,<0.56.0>}, {name,rb_server}, {mfa,{rb,start_link,[[{report_dir,"."}]]}}, {restart_type,temporary}, {shutdown,brutal_kill}, {child_type,worker}] {ok,<0.56.0>} 7> rb:list(). No Type Process Date Time == ==== ======= ==== ==== 3 error <0.25.0> 2011-03-11 19:49:59 2 progress <0.51.0> 2011-03-11 19:50:29 1 progress <0.24.0> 2011-03-11 19:50:29 ok 8> rb:list(error). No Type Process Date Time == ==== ======= ==== ==== 3 error <0.25.0> 2011-03-11 19:49:59 ok 9> rb:show(3). ERROR REPORT emulator 2011-03-11 19:49:59 =============================================================================== Error in process <0.48.0> with exit value: {{badarity,{#Fun<erl_eval.6.13229925>,[]}},[{erlang,apply,2}]} ok 10> halt(). root@37221-1:/home/user# ls -1 1 2 index mboga root@37221-1:/home/user# 

3. SASL + log_mf_h

जैसा कि मैंने ऊपर लिखा है, SASL सेटिंग्स आपको इवेंट प्रोसेसिंग के लिए log_mf_h का उपयोग करने की अनुमति देती हैं। ऐसा करने के लिए, एसएएसएल कॉन्फ़िगरेशन में निम्नलिखित पैरामीटर निर्दिष्ट करें:

 [{sasl, [ {sasl_error_logger, false}, {error_logger_mf_dir, "/home/user/mboga/log/log_mf_h"}, {error_logger_mf_maxbytes, 1024}, {error_logger_mf_maxfiles, 10} ]}]. 

अब सभी घटनाओं को निर्दिष्ट निर्देशिका में लिखा जाएगा। जब आपका एप्लिकेशन चल रहा होता है, तो आप rb उपयोगिता का उपयोग करके दूसरे शेल में जा सकते हैं और व्यू (एक अलग लॉग में रिपोर्ट प्रिंट कर सकते हैं)

 root@37221-1:~# ps aux | grep erlang root 27943 0.0 0.1 1980 368 ? S Mar08 0:01 /usr/lib/erlang/erts-5.7.4/bin/epmd -daemon root 31714 0.5 3.0 13912 8092 ? S 07:37 3:45 /usr/lib/erlang/erts-5.7.4/bin/beam -- -root /usr/lib/erlang -progname erl -- -home /root -- -noshell -pa ebin edit deps/erldis/ebin deps/mochiweb/ebin -boot logging -sname mboga_web_dev -s mboga_web -s reloader root 31944 0.0 0.2 1888 700 pts/1 S+ 20:05 0:00 grep --color=auto erlang root@37221-1:~# erl -boot start_sasl Erlang R13B03 (erts-5.7.4) [source] [rq:1] [async-threads:0] [hipe] [kernel-poll:false] =PROGRESS REPORT==== 11-Mar-2011::20:05:43 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.35.0>}, {name,alarm_handler}, {mfa,{alarm_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::20:05:43 === supervisor: {local,sasl_safe_sup} started: [{pid,<0.36.0>}, {name,overload}, {mfa,{overload,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::20:05:43 === supervisor: {local,sasl_sup} started: [{pid,<0.34.0>}, {name,sasl_safe_sup}, {mfa, {supervisor,start_link, [{local,sasl_safe_sup},sasl,safe]}}, {restart_type,permanent}, {shutdown,infinity}, {child_type,supervisor}] =PROGRESS REPORT==== 11-Mar-2011::20:05:43 === supervisor: {local,sasl_sup} started: [{pid,<0.37.0>}, {name,release_handler}, {mfa,{release_handler,start_link,[]}}, {restart_type,permanent}, {shutdown,2000}, {child_type,worker}] =PROGRESS REPORT==== 11-Mar-2011::20:05:43 === application: sasl started_at: nonode@nohost Eshell V5.7.4 (abort with ^G) 1> rb:start([{report_dir, "/home/user/mboga/log/log_mf_h"}]). rb: reading report...done. rb: reading report...done. rb: reading report...done. rb: reading report...done. rb: reading report...done. rb: reading report...done. =PROGRESS REPORT==== 11-Mar-2011::20:07:02 === supervisor: {local,sasl_sup} started: [{pid,<0.47.0>}, {name,rb_server}, {mfa, {rb,start_link, [[{report_dir, "/home/user/mboga/log/log_mf_h"}]]}}, {restart_type,temporary}, {shutdown,brutal_kill}, {child_type,worker}] {ok,<0.47.0>} 2> rb:start_log("/home/user/mboga/log/rb.log"). ok 3> rb:list(). No Type Process Date Time == ==== ======= ==== ==== ... 29 progress <6800.8.0> 2011-03-10 23:00:44 28 error_report <6800.50.0> 2011-03-10 23:01:10 27 error_report <6800.50.0> 2011-03-10 23:01:10 26 error_report <6800.50.0> 2011-03-10 23:01:11 25 progress <6800.34.0> 2011-03-10 23:02:52 24 progress <6800.34.0> 2011-03-10 23:02:52 ... 4 progress <6800.50.0> 2011-03-11 07:37:50 3 progress <6800.29.0> 2011-03-11 07:37:50 2 progress <6800.8.0> 2011-03-11 07:37:50 1 crash_report mochiweb_acceptor 2011-03-11 10:08:03 ok 4> rb:list(crash_report). No Type Process Date Time == ==== ======= ==== ==== 48 crash_report mochiweb_acceptor 2011-03-10 15:29:26 44 crash_report supervisor_bridge 2011-03-10 22:46:40 41 crash_report reloader 2011-03-10 22:55:04 1 crash_report mochiweb_acceptor 2011-03-11 10:08:03 ok 5> rb:show(1). ok 6> rb:list(error_report). No Type Process Date Time == ==== ======= ==== ==== 47 error_report <6800.50.0> 2011-03-10 22:46:40 28 error_report <6800.50.0> 2011-03-10 23:01:10 27 error_report <6800.50.0> 2011-03-10 23:01:10 26 error_report <6800.50.0> 2011-03-10 23:01:11 ok 7> rb:show(27). ok 8> rb:stop(). ok 

 root@37221-1:~# cat /home/user/mboga/log/rb.log CRASH REPORT <6768.60.0> 2011-03-11 10:08:03 =============================================================================== Crashing process initial_call {mochiweb_acceptor,init,['Argument__1','Argument__2','Argument__3']} pid <6768.60.0> registered_name [] error_info {error,function_clause, [{mochiweb,new_request, [{#Port<6768.1465>, {"CONNECT",{scheme,"www.google.com","443"},{1,0}}, []}]}, {mochiweb_http,headers,5}, {proc_lib,init_p_do_apply,3}]} ancestors [mboga_web_web,mboga_web_sup,<6768.51.0>] messages [] links [<6768.56.0>,#Port<6768.1465>] dictionary [] trap_exit false status running heap_size 2584 stack_size 24 reductions 59064 ERROR REPORT <6768.75.0> 2011-03-10 23:01:10 =============================================================================== "web request failed" path upload/ type exit what could_not_open_file_for_writing trace [{mboga_web_web,callback,2}, {mochiweb_multipart,feed_mp,2}, {mboga_web_web,upload,2}, {mboga_web_web,loop,3}, {mochiweb_http,headers,5}, {proc_lib,init_p_do_apply,3}] root@37221-1:~# 

4. ...

यह उन उपकरणों का वर्णन करता है जो अनुप्रयोग विकास की सुविधा प्रदान करते हैं और सरल सिस्टम के लॉगिंग की अनुमति देते हैं। बड़ी परियोजनाओं के लिए, कई तृतीय-पक्ष अनुप्रयोग हैं जो एरलंग (उदाहरण के लिए, वितरण या वेब इंटरफ़ेस) का लाभ उठाते हैं, और अन्य प्लेटफार्मों की सामान्य कार्यक्षमता प्रदान करते हैं (उदाहरण के लिए, लॉग स्तर)। लेकिन अगली बार के बारे में और अधिक।