👹 🔜 👂🏾 Apache ऊंट के लिए रूट ग्राफ़ 📜 👶🏽 💝

इस लेख में मैं आपको बताऊंगा कि कैसे आप अपाचे कैमल के साथ अनुप्रयोगों के लिए एक रूट ग्राफ बना सकते हैं, इन मार्गों की स्थिति को ट्रैक कर सकते हैं और उनके लिए मैट्रिक्स एकत्र कर सकते हैं।
हम वसंत अनुप्रयोगों में और अपाचे सेवामिक्स में अपाचे ऊंट का उपयोग करते हैं। और अगर एक अलग सेवा में मार्ग समझ में आते हैं और आसानी से दिखाई देते हैं, तो डेटा बस के भीतर, जहां ऐसे कई मार्ग हैं, यह इतना सरल नहीं है।

Apache ServiceMix क्या है

अपाचे कैमल सरल डीएसएल के उपयोग के माध्यम से अनुप्रयोगों को एकीकृत करने और तैयार-निर्मित एक्सेस एक्सेस घटकों के एक समृद्ध सेट के लिए एक ओपन-सोर्स फ्रेमवर्क है।

Apache ServiceMix, Apache ActiveMQ, Camel, CXF, Karaf पर आधारित एक खुला स्रोत समाधान है, जो आपको एकीकरण समाधान के लिए एक मंच बनाने की अनुमति देता है। अपाचे सर्विसमिक्स का उपयोग एंटरप्राइज सर्विस बस के रूप में किया जा सकता है। इस मामले में ऊंट xml, जावा, स्काला, आदि के रूप में dsl का उपयोग करके बस में मार्गों के निर्माण को सरल करेगा। उदाहरण के लिए, यदि हमें संदेशों को एक कतार से दूसरी पंक्ति में स्थानांतरित करने की आवश्यकता है (चलो यह नहीं सोचते कि हमें इसकी आवश्यकता क्यों है), हम xml फ़ाइल में मार्ग का वर्णन कर सकते हैं (उदाहरण के लिए नीचे), इसे वांछित सेवा निर्देशिका में छोड़ दें और इसे तैनात किया जाएगा।

<?xml version="1.0" encoding="UTF-8"?> <blueprint xmlns="http://www.osgi.org/xmlns/blueprint/v1.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.osgi.org/xmlns/blueprint/v1.0.0 http://www.osgi.org/xmlns/blueprint/v1.0.0/blueprint.xsd"> <camelContext xmlns="http://camel.apache.org/schema/blueprint"> <route> <from uri="file:camel/input"/> <log message="Moving ${file:name} to the output directory"/> <to uri="file:camel/output"/> </route> </camelContext> </blueprint>

वर्णित मार्ग एक निर्देशिका से दूसरे में फ़ाइलों को स्थानांतरित करता है।

उपयोग के वर्षों में, टायर ने बदलती जटिलता के सौ से अधिक मार्गों को जमा किया है, और हम यह समझ गए हैं कि इन सभी कनेक्शनों को याद रखना कठिन और कठिन होता जा रहा है। अपने हाथों से मार्ग योजनाओं को आकर्षित करना या उन्हें तालिकाओं के रूप में वर्णन करना एक सुविधाजनक और आसानी से समर्थित समाधान प्रतीत होता है। लेकिन ऐसा लगने लगा कि रूट ग्राफ के स्वत: निर्माण से सभी को बचाया जा सकेगा।

एक ग्राफ बनाने के लिए, आपको कोने और किनारों की आवश्यकता होती है। और इनमें से, हम कुछ सुंदर अंधा करते हैं!

मार्ग तत्व

मार्ग के लिए प्रवेश बिंदु (यह एक है) का वर्णन समापन बिंदु के संकेत के साथ कथन from किया गया from । यानी के लिए

 <from uri="file:camel/input"/>

एंडपॉइंट file:camel/input होगी file:camel/input वह हमें बताता है कि मार्ग की शुरुआत में फ़ाइलें camel/input निर्देशिका से ली जाएंगी।

मार्ग से बाहर निकलने के बिंदु (उनमें से कई हैं, यही वजह है कि मैंने बहुवचन को इंगित किया है) अलग-अलग निर्धारित किए जाते हैं - संदेश टेम्पलेट के आधार पर भी इंगित किए गए समापन बिंदु के साथ। उपरोक्त उदाहरण में, इस तरह के एक बिंदु का वर्णन किया to । यानी के लिए

 <to uri="file:camel/output"/>

समापन बिंदु file:camel/output होगा file:camel/output । वह हमें बताता है कि मार्ग के अंत में, फ़ाइलें camel/output निर्देशिका में सहेजी जाएंगी।

समापन बिंदु हम सबसे ऊपर हैं। पसलियां स्वयं मार्गों का निर्धारण करेंगी।

मार्ग का वर्णन प्राप्त करना

Servicemix JMX का उपयोग करके विभिन्न सूचनाओं को एक्सेस करने की क्षमता प्रदान करता है और हम http के माध्यम से इस जानकारी तक पहुँचने के लिए jolोकिया का उपयोग करेंगे।

एक उदाहरण के रूप में, मार्गों का यह विवरण लें

 <?xml version="1.0" encoding="UTF-8"?> <beans xmlns="http://www.springframework.org/schema/beans" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation=" http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-2.0.xsd http://camel.apache.org/schema/spring http://camel.apache.org/schema/spring/camel-spring.xsd"> <camelContext xmlns="http://camel.apache.org/schema/spring"> <route id="the-clock-is-ticking"> <from uri="timer://foo?fixedRate=true&amp;period=1000"/> <to uri="jms:topic:timer?connectionFactory=demo"/> </route> <route id="service-a"> <from uri="jms:topic:timer?connectionFactory=demo"/> <to uri="jms:queue:service-a?connectionFactory=demo"/> </route> <route id="service-a-log"> <from uri="jms:queue:service-a?connectionFactory=demo"/> <to uri="log:service-a"/> </route> </camelContext> </beans>

मार्ग सूची

विधि http://host:8181/jolokia/read/org.apache.camel:type=routes,* विवरण के साथ मार्गों की एक सूची देता है।

service-a मार्ग के लिए उदाहरण रिटर्न डेटा:

 "org.apache.camel:context=a.xml,name=\"service-a\",type=routes": { "StatisticsEnabled": true, "EndpointUri": "jms:\/\/topic:timer?connectionFactory=demo", "CamelManagementName": "a.xml", "ExchangesCompleted": 173, "LastProcessingTime": 2, "ExchangesFailed": 0, "Description": null, "FirstExchangeCompletedExchangeId": "ID-...", "StartTimestamp": "2018-12-17T07:01:12Z", "FirstExchangeCompletedTimestamp": "2018-12-17T07:01:13Z", "LastExchangeFailureTimestamp": null, "MaxProcessingTime": 35, "LastExchangeCompletedTimestamp": "2018-12-17T07:04:05Z", "Load15": "", "DeltaProcessingTime": -8, "OldestInflightDuration": null, "ExternalRedeliveries": 0, "ExchangesTotal": 173, "ResetTimestamp": "2018-12-17T07:01:12Z", "ExchangesInflight": 0, "MeanProcessingTime": 4, "LastExchangeFailureExchangeId": null, "FirstExchangeFailureExchangeId": null, "Uptime": "2 minutes", "CamelId": "camel-3", "TotalProcessingTime": 827, "FirstExchangeFailureTimestamp": null, "RouteId": "service-a", "RoutePolicyList": "", "FailuresHandled": 0, "MessageHistory": true, "Load05": "", "OldestInflightExchangeId": null, "State": "Started", "InflightExchanges": 0, "Redeliveries": 0, "MinProcessingTime": 0, "LastExchangeCompletedExchangeId": "ID-...", "Tracing": false, "Load01": "" }

बहुत सारे RouteId और उनमें से, RouteId , Context , EndpointUri , State , Uptime , ग्राफ निर्माण के लिए विशेष रुचि रखते हैं।

यह उल्लेख करना महत्वपूर्ण है कि विधि मार्ग के साथ मैट्रिक्स लौटाती है: ExchangesTotal , ExchangesCompleted , ExchangesFailed , ExchangesInflight , आदि।

उपरोक्त विधि हमारी डेटा जरूरतों का 90% कवर करती है, लेकिन यह क्या नहीं है जो मार्ग से बाहर निकलने के बिंदुओं के बारे में जानकारी है। इस जानकारी को प्राप्त करने के लिए आपको मार्ग विवरण प्राप्त करने की विधि और योजना प्राप्त करने की विधि का उपयोग करने की आवश्यकता है। विधियों में से एक पर्याप्त नहीं है, क्योंकि कुछ मामलों में विधियाँ निकास बिंदुओं की सूची बनाने के लिए आवश्यक सभी डेटा वापस नहीं करती हैं।

मार्ग का विवरण

मार्ग का विवरण विधि से प्राप्त किया जाता है
http://host:8181/jolokia/exec/org.apache.camel:context=a.xml,type=routes,name="service-a"/createRouteStaticEndpointJson(boolean)/true

लौटाए गए डेटा का उदाहरण:

 { "request": { "mbean": "org.apache.camel:context=a.xml,name=\"service-a\",type=routes", "arguments": ["true"], "type": "exec", "operation": "createRouteStaticEndpointJson(boolean)" }, "value": "{\"routes\": { \"service-a\": { \"inputs\": [ { \"uri\": \"jms:\/\/topic:timer?connectionFactory=demo\" } ], \"outputs\": [ { \"uri\": \"jms:\/\/queue:service-a?connectionFactory=demo\" } ] }}\n}\n", "timestamp": 1545040570, "status": 200 }

मार्ग का नक्शा

मार्ग आरेख विधि से प्राप्त किया जाता है
http://host:8181/jolokia/exec/org.apache.camel:context=a.xml,type=routes,name="service-a"/dumpRouteAsXml(boolean)/true ।

यह विधि xml फॉर्म में रूट आरेख को केवल तभी लौटाती है जब इसमें इसे तैयार किया गया था। उदाहरण के लिए, यदि org.apache.camel.builder.RouteBuilder (वसंत एप्लिकेशन में मार्गों का वर्णन करते समय उपयोग किया जाता है) का उपयोग करके किसी मार्ग का वर्णन किया जाता है, तो विधि कुछ भी वापस नहीं करेगी।

लौटाए गए डेटा का उदाहरण:

 { "request": { "mbean": "org.apache.camel:context=a.xml,name=\"service-a\",type=routes", "arguments": ["true"], "type": "exec", "operation": "dumpRouteAsXml(boolean)" }, "value": "<?xml version=\"1.0\" encoding=\"UTF-8\" standalone=\"yes\"?>\n<route customId=\"true\" id=\"service-a\" xmlns=\"http:\/\/camel.apache.org\/schema\/spring\">\n <from uri=\"jms:topic:timer?connectionFactory=demo\"\/>\n <to uri=\"jms:queue:service-a?connectionFactory=demo\" id=\"to5\"\/>\n<\/route>\n", "timestamp": 1545040727, "status": 200 }

एक ग्राफ बनाएं

प्राप्त सभी जानकारी को vis.js हुए, आप सुरक्षित रूप से एक ग्राफ खींच सकते हैं, मैंने vis.js उपयोग किया और यह परिणाम मिला

पॉइंट्स एंट्री और एग्जिट पॉइंट्स हैं, एड़ियाँ रूट हैं, और रूट्स पर ग्रे नंबर ExchangesTotal मेट्रिक हैं।

कई सेवाओं के लिए रेखांकन

ग्राफ निर्माण के लिए वर्णित दृष्टिकोण उस स्थिति के लिए भी उपयुक्त है जब ऊंट का उपयोग न केवल डेटा बस में किया जाता है, बल्कि अनुप्रयोगों में भी किया जाता है। उदाहरण के लिए, आवेदन में मार्ग का वर्णन इस प्रकार है:

 @Component public class EventRoutes extends RouteBuilder { @Override public void configure() throws Exception { from("jms:topic:timer") .inOnly("bean:service?method=handle"); } }

आप servicemix और एप्लिकेशन से मार्गों के सभी डेटा को जोड़ सकते हैं और एक सामान्य ग्राफ खींच सकते हैं

ध्यान दें कि jms:topic:timer से bean:service एक नया मार्ग आरेख पर दिखाई दिया है।

निष्कर्ष

मार्ग ग्राफ़ का निर्माण करने के लिए वर्णित दृष्टिकोण को लागू करने से, हम बस और एकीकृत सेवाओं दोनों के लिए एक समग्र चित्र प्राप्त करने में सक्षम थे। दरअसल हमारे टायर का ग्राफ कुछ इस तरह दिखता है

कॉन्सेप्ट ऐप्स के सबूत यहां देखे जा सकते हैं - github

Apache ऊंट के लिए रूट ग्राफ़