यदि आप अपने लाखों (या अरबों!) इलास्टिक्स खोज दस्तावेज़ों को आकर्षक चार्ट, ग्राफ़ और तालिकाओं में बदलना चाहते हैं, तो किबाना इसका उत्तर है। इलास्टिक उत्पाद के रूप में, यह इलास्टिक्स खोज के साथ निकटता से जुड़ता है और डेटा के ढेर को समझने के लिए उपयोग में आसान इंटरफ़ेस प्रदान करता है।
वर्तमान में, सभी ObjectRocket Elasticsearch इंस्टेंसेस Kibana 3 के साथ प्री-लोडेड आते हैं, जिन्हें आप अपने किसी भी Elasticsearch HTTP एंडपॉइंट पर /_plugin/kibana पर एक्सेस कर सकते हैं। हालाँकि, Kibana 4 कई सुधार और नई सुविधाएँ पेश करता है, इसलिए हम आपके द्वारा ObjectRocket के साथ बनाए गए प्रत्येक Elasticsearch उदाहरण के साथ इसे प्रदान करने के लिए कड़ी मेहनत कर रहे हैं। इस बीच, यह ट्यूटोरियल आपको डॉकर कंटेनर में चल रहे Kibana 4 का उपयोग करके आपके Elasticsearch उदाहरण से कनेक्ट करने में मदद करेगा।
आवश्यकताएं
यदि आपके पास पहले से ही डॉकर स्थापित है और हमारे पास इलास्टिक्स खोज उदाहरण है, तो आप जाने के लिए अच्छे हैं। बस सुनिश्चित करें कि आपके डॉकर होस्ट का आईपी पता इलास्टिक्स खोज उदाहरण पर श्वेतसूची में है और अपनी कनेक्शन जानकारी को नीचे "डॉकर में किबाना 4 चलाना" अनुभाग में ले जाएं।
इलास्टिक्स खोज
आरंभ करने के लिए, आपको ObjectRocket पर Elasticsearch उदाहरण की आवश्यकता होगी। यदि आपके पास पहले से एक नहीं है, तो हमारे पास Elasticsearch के साथ आरंभ करने के लिए उत्कृष्ट दस्तावेज हैं। हम स्थानीय रूप से डॉकर चलाने जा रहे हैं, इसलिए एसीएल में अपने वर्तमान आईपी पते (icanhazip.com से) को श्वेतसूची में रखना सुनिश्चित करें। एक बार आपका इंस्टेंस तैयार हो जाने के बाद, आपको किबाना 4 से जुड़ने के लिए निम्नलिखित जानकारी की आवश्यकता होगी:
- आपके उदाहरण के लिए HTTPS कनेक्शन स्ट्रिंग, उदा. https://iad1-19999-0.es.objectrocket.com:29999। HA उद्देश्यों के लिए, प्रत्येक इंस्टेंस में चार क्लाइंट नोड होते हैं जिनसे आप कनेक्ट हो सकते हैं, हालांकि इस मामले में आपको केवल एक की आवश्यकता होगी।
- उदाहरण के लिए एक व्यवस्थापक उपयोगकर्ता के लिए एक उपयोगकर्ता नाम/पासवर्ड संयोजन।
डॉकर
इन दिनों डॉकर के साथ शुरुआत करने का सबसे आसान तरीका डॉकर मशीन है। इसे स्थापित और कॉन्फ़िगर करना इस लेख के दायरे से बाहर है, लेकिन उनकी आरंभ करने की मार्गदर्शिका शुरू करने के लिए एक अच्छी जगह है।
डॉकर में किबाना 4 चलाना
अब जब आपके पास ऑनलाइन इलास्टिक्स खोज इंस्टेंस है और डॉकर इंस्टॉल हो गया है, तो किबाना 4 को चालू करने और चलाने का समय आ गया है!
यदि आप डॉकर मशीन का उपयोग कर रहे हैं, तो अपने परिवेश को उचित रूप से स्थापित करना सुनिश्चित करें:
$ docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM
dockerbox virtualbox Running tcp://192.168.99.100:2376
$ eval "$(docker-machine env dockerbox)"
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
पर्यावरण फ़ाइल बनाएं
किबाना 4 डॉकर छवि जिसका हम उपयोग कर रहे हैं (ऑब्जेक्ट्रोकेट/किबाना) के लिए आवश्यक है कि ELASTICSEARCH_URL पर्यावरण चर सेट किया जाए ताकि यह जान सके कि इलास्टिक्स खोज से कैसे जुड़ना है। इस उदाहरण में, हम होस्ट iad1-19999-3.es.objectrocket.com को पोर्ट 29999 (HTTPS) पर यूज़रनेम एलिस और पासवर्ड पासवर्ड के साथ कनेक्ट कर रहे हैं।
$ echo 'ELASTICSEARCH_URL=https://alice:[email protected]:29999' > kibana4.env
नोट :आप इन पर्यावरण चरों में -e ध्वज के साथ आसानी से पारित कर सकते हैं, लेकिन चूंकि उनमें संवेदनशील क्रेडेंशियल होते हैं, इसलिए उन्हें एक env फ़ाइल में रखना बुद्धिमानी है।
कंटेनर शुरू करें
अब हम अपना किबाना 4 कंटेनर शुरू कर सकते हैं:
# Use `-p $PORT:5601` if you wish to change the bind port
$ docker run -d --name kibana4 -p 5601:5601 --env-file kibana4.env objectrocket/kibana:4.1.2
Unable to find image 'objectrocket/kibana:4.1.2' locally
4.1.2: Pulling from objectrocket/kibana
8a648f689ddb: Pull complete
6a9f09112d11: Pull complete
98c91eb0b06a: Pull complete
f5030fbbffc3: Pull complete
0a7a2d9eb5d6: Pull complete
1f9563800fc7: Pull complete
f43ab0bd66e0: Pull complete
Digest: sha256:352e95077d0312fa12de6cec3bc66d221391952b8cf98e890cd7324b6b6605ce
Status: Downloaded newer image for objectrocket/kibana:4.1.2
cc341ff14d492a30e106007896201639964bdef6a93d03d497957a2738f5ac24
अपडेट करें :यदि आप Elasticsearch 2.0+ चला रहे हैं, तो आपको objectrocket/kibana:4.2.0 (या उच्चतर) छवि का उपयोग करना होगा।
आपका कंटेनर बनने के बाद, यह docker ps के आउटपुट में दिखाई देना चाहिए:
$ docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
cc341ff14d49 objectrocket/kibana "/opt/kibana/run.sh" About a minute ago Up About a minute 0.0.0.0:5601->5601/tcp kibana4
यदि आपको कंटेनर को चलाने में समस्या हो रही है, तो अपने ELASTICSEARCH_URL वैरिएबल की दोबारा जांच करें और सुनिश्चित करें कि URL का प्रत्येक भाग सही है। यह भी ध्यान देने योग्य है कि @ या :जैसे प्रतीकों वाले पासवर्ड URL योजना को तोड़ सकते हैं। आप किसी भी त्रुटि संदेश को दिखाने के लिए docker logs kibana4 भी चला सकते हैं, जिसे किबाना ने stdout या stderr को भेजा है।
किबाना 4 से कनेक्ट करें
अब आप अपने डॉकर होस्ट पर पोर्ट 5601 (या पिछले चरण में आपने जो भी पोर्ट चुना है) पर किबाना 4 से कनेक्ट करने में सक्षम होना चाहिए। यदि आप स्थानीय रूप से चल रहे हैं, तो https://localhost:5601 का उपयोग करें। यदि आप डॉकर मशीन चला रहे हैं, तो डॉकर-मशीन आईपी से अपने डॉकर मशीन वीएम के आईपी पते का उपयोग करें, उदा। https://192.168.99.100:5601.
सफलतापूर्वक कनेक्ट होने के बाद, आपको अपने इलास्टिक्स खोज उदाहरण से सूचकांकों का उपयोग करने के लिए किबाना को कॉन्फ़िगर करने की आवश्यकता है। अधिक जानकारी के लिए इलास्टिक से इलास्टिक्स खोज दस्तावेज़ के साथ कनेक्ट किबाना देखें। किबाना 4 की कुछ प्रमुख विशेषताओं के बारे में अधिक जानने के लिए आप उनकी किबाना गाइड के साथ शुरुआत करना भी पढ़ सकते हैं।
रैपिंग अप
जब आप किबाना में विज़ुअलाइज़ेशन तैयार कर लेते हैं, तो आप निम्न कमांड चलाकर डॉकर कंटेनर को रोक सकते हैं:
$ docker stop kibana4
kibana4
और फिर अगली बार जब आप दोबारा कनेक्ट करना चाहें, तो बस docker start kibana4 चलाएँ और आप जाने के लिए तैयार हैं।
जैसा कि पहले उल्लेख किया गया है, होस्ट किया गया किबाना 4 पहले से ही हमारे इलास्टिक्स खोज उत्पाद की पेशकश के लिए काम कर रहा है, लेकिन किबाना को स्थानीय रूप से चलाने से आप इस बीच जल्दी से आरंभ कर सकेंगे। और चूंकि किबाना अपने सभी कॉन्फ़िगरेशन को इलास्टिक्स खोज सूचकांकों में संग्रहीत करता है, इसलिए जब आप स्विच करते हैं तो आप अपना कोई भी कीमती डैशबोर्ड या विज़ुअलाइज़ेशन नहीं खोते हैं!