Ceph एजेंट

Status200 Ceph एजेंट एक Ceph क्लस्टर की निगरानी करता है: उसकी हेल्थ, मॉनिटर क्वोरम, OSD, पूल और प्लेसमेंट ग्रुप। यह हर mgr डेमन पर Ceph mgr के prometheus मॉड्यूल को स्क्रैप करता है, हर मेट्रिक पर आपके क्लस्टर का नाम लगाता है और उसे Status200 को भेजता है, जहाँ क्लस्टर अपने OSD, पूल और डेमन के साथ दिखता है। Ceph मॉनिटर आने वाले डेटा पर अलर्ट करते हैं।

यह कैसे काम करता है#

एजेंट दो कंटेनर हैं जिन्हें आप एक मशीन पर Docker Compose से चलाते हैं। एक OpenTelemetry Collector हर 30 सेकंड में हर mgr डेमन पर mgr के prometheus मॉड्यूल को स्क्रैप करता है। मेट्रिक्स के साथ सिर्फ़ सक्रिय mgr जवाब देता है, इसलिए जब वह किसी स्टैंडबाय पर फ़ेलओवर करता है, तो बिना किसी बदलाव के मेट्रिक्स आते रहते हैं। इसके बगल का Ceph AI एजेंट Status200 AI को किसी घटना या अलर्ट की जाँच करते समय केवल-पढ़ने वाले ceph कमांड चलाने देता है।

क्लस्टर अपने पहले डेटा के साथ, उस नाम के अंतर्गत खुद को रजिस्टर करता है जिसे एजेंट हर मेट्रिक पर ceph.cluster.name के रूप में लगाता है।

शुरू करने से पहले#

• Docker Compose v2 प्लगइन के साथ Docker Engine 20.10 या बाद का, ऐसी मशीन पर जो पोर्ट 9283 पर आपके Ceph mgr डेमन तक पहुँच सके।
• एक Ceph एडमिन नोड पर एक शेल, जहाँ ceph CLI एडमिन अधिकारों के साथ काम करता हो।
• एक इंजेशन कुंजी। प्रोजेक्ट सेटिंग्स → टेलीमेट्री और APM → इंजेशन कुंजियाँ के अंतर्गत एक बनाएँ और उसका मान कॉपी करें।
• उस मशीन से आपके Status200 URL तक आउटबाउंड HTTPS।

एजेंट इंस्टॉल करें#

1. mgr prometheus मॉड्यूल चालू करें#

   एक Ceph एडमिन नोड पर:

   Bash

   ceph mgr module enable prometheus

   इसके बाद हर mgr डेमन पोर्ट 9283 पर /metrics में Prometheus मेट्रिक्स देता है। मेट्रिक्स सिर्फ़ सक्रिय mgr लौटाता है: स्टैंडबाय mgr खाली जवाब देते हैं, या mgr/prometheus/standby_behaviour के error पर सेट होने पर HTTP त्रुटि देते हैं। इसीलिए एजेंट हर mgr को स्क्रैप करता है। उनकी सूची देखें:

   Bash

   ceph mgr stat                    # active mgr
   ceph orch ps --daemon-type mgr   # all mgrs (cephadm clusters)

2. एजेंट इंस्टॉल करें और शुरू करें#

   install.shDocker Compose

   install.sh

   इंस्टॉल स्क्रिप्ट डाउनलोड करें और उसे उस मशीन पर चलाएँ जो एजेंट को होस्ट करेगी:

   Bash

   curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/install.sh -o install.sh
   bash install.sh

   स्क्रिप्ट आपका Status200 URL, इंजेशन कुंजी, क्लस्टर का नाम और mgr एंडपॉइंट पूछती है, और यह भी कि क्या AI एजेंट सुधार लागू कर सकता है। जहाँ ceph एडमिन अधिकारों के साथ काम करता है, वहाँ यह AI एजेंट का अपना Ceph क्लाइंट बनाने की पेशकश भी करती है। यह /opt/status200-ceph-agent में इंस्टॉल करती है, 0600 अनुमति वाली एक .env फ़ाइल लिखती है, और Docker Compose से एजेंट शुरू करती है। स्क्रिप्ट को फिर से चलाने पर वह दोबारा पूछने के बजाय उस .env की हर चीज़ फिर से उपयोग करती है, और इसी तरह आप एजेंट अपग्रेड करते हैं।

   Docker Compose

   [CephAgent डायरेक्टरी](<YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent) से docker-compose.yml और otel-collector-config.yaml एक नए फ़ोल्डर में डाउनलोड करें:

   Bash

   mkdir status200-ceph-agent && cd status200-ceph-agent
   curl -fsSLO <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/docker-compose.yml
   curl -fsSLO <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/otel-collector-config.yaml

   उनके बगल में एक .env फ़ाइल बनाएँ:

   .envBash

   STATUS200_URL=YOUR_STATUS200_URL
   STATUS200_TELEMETRY_INGESTION_KEY=YOUR_TELEMETRY_INGESTION_TOKEN
   CEPH_CLUSTER_NAME=my-ceph-cluster
   CEPH_MGR_ENDPOINTS=[ceph-mon-1:9283,ceph-mon-2:9283,ceph-mon-3:9283]

   हर mgr डेमन की सूची दें, सक्रिय और स्टैंडबाय दोनों, कॉमा से अलग और वर्गाकार कोष्ठकों में: कोष्ठकों के कारण कलेक्टर मान को स्क्रैप लक्ष्यों की सूची के रूप में पढ़ता है। एजेंट शुरू करें:

   Bash

   docker compose up -d

   AI एजेंट का कंटेनर भी शुरू होता है, और अपने खुद के Ceph क्लाइंट का इंतज़ार करता है: AI एजेंट देखें।

3. जाँचें कि एजेंट चल रहा है#

   Bash

   docker compose ps
   docker logs -f status200-ceph-agent

   docker compose ps कलेक्टर (status200-ceph-agent) और AI एजेंट (status200-ceph-ai-agent) दिखाता है। कलेक्टर शुरू होने के बाद उसके लॉग में यह पंक्ति दिखनी चाहिए:

   Everything is ready. Begin running and processing data.

4. Status200 में क्लस्टर खोजें#

   उत्पाद → बुनियादी ढांचा → Ceph → सभी क्लस्टर खोलें। लगभग एक मिनट में क्लस्टर अपने CEPH_CLUSTER_NAME के अंतर्गत अपने OSD, पूल और डेमन के साथ दिखाई देता है। इसका टोपोलॉजी पेज इन्हें एक मैप पर दिखाता है: देखें टोपोलॉजी।

एनवायरनमेंट वेरिएबल#

इंस्टॉल स्क्रिप्ट इन्हें /opt/status200-ceph-agent/.env में लिखती है; Docker Compose इंस्टॉल इन्हें docker-compose.yml के बगल की .env से पढ़ता है। कोई मान बदलने के बाद उस फ़ोल्डर में docker compose up -d चलाएँ।

AI एजेंट की अपनी सेटिंग्स AI एजेंट के अंतर्गत हैं।

एजेंट कैसे स्क्रैप करता है#

• हर mgr, हर 30 सेकंड में। mgr का prometheus मॉड्यूल हर स्क्रैप को mgr/prometheus/scrape_interval (डिफ़ॉल्ट रूप से 15 सेकंड) तक कैश करता है। इससे ज़्यादा बार कभी स्क्रैप न करें: आप बस कैश को फिर से पढ़ेंगे।
• honor_labels: true। Ceph जो लेबल एक्सपोर्ट करता है (ceph_daemon, pool_id, हर डेमन के इंस्टेंस लेबल) वे जैसे हैं वैसे ही रखे जाते हैं। इसके बिना instance लेबल हर स्क्रैप लक्ष्य के लिए फिर से लिखा जाता और सक्रिय mgr बदलने पर हर बार बदल जाता, जिससे हर सीरीज़ टूट जाती है।

एजेंट क्या इकट्ठा करता है#

एजेंट वह सब भेजता है जो mgr का prometheus मॉड्यूल एक्सपोर्ट करता है। Status200 के Ceph पेज, मेट्रिक कैटलॉग और अलर्ट टेम्पलेट इन सीरीज़ पर बने हैं:

और स्क्रैप लक्ष्य#

mgr मॉड्यूल क्लस्टर की हेल्थ और क्षमता को कवर करता है। करीब से देखने के लिए, otel-collector-config.yaml में scrape_configs के अंतर्गत और जॉब जोड़ें:

• ceph-exporter (Reef 18.2 और बाद के)। cephadm हर क्लस्टर होस्ट पर एक ceph-exporter डेमन चलाता है, जो पोर्ट 9926 पर हर डेमन के परफ़ॉर्मेंस काउंटर देता है। हर होस्ट के लिए एक लक्ष्य जोड़ें।
• node_exporter। हर Ceph होस्ट के CPU, मेमोरी, डिस्क और नेटवर्क मेट्रिक्स के लिए सामान्य साथी, डिफ़ॉल्ट रूप से पोर्ट 9100 पर।

दोनों को साथ आने वाले resource प्रोसेसर से ceph.cluster.name रिसोर्स एट्रिब्यूट मिलता है, इसलिए वे Status200 में उसी क्लस्टर पर पहुँचते हैं।

वैकल्पिक — Ceph क्लस्टर लॉग भेजें#

एजेंट /var/log/ceph/ceph.log को फ़ॉलो करके Status200 को भेज सकता है, जिससे क्लस्टर का Cluster Log पेज भरता है। यह डिफ़ॉल्ट रूप से बंद है क्योंकि तब एजेंट को ऐसे होस्ट पर चलना होगा जिस पर क्लस्टर लॉग हो: डिफ़ॉल्ट रूप से एक मॉनिटर होस्ट।

1. रिसीवर चालू करें#

   otel-collector-config.yaml में filelog रिसीवर और logs पाइपलाइन को अनकमेंट करें।

2. लॉग डायरेक्टरी माउंट करें#

   docker-compose.yml में वह वॉल्यूम अनकमेंट करें जो डायरेक्टरी को कलेक्टर में माउंट करता है:

   YAML

   - /var/log/ceph:/var/log/ceph:ro

3. एजेंट फिर से शुरू करें#

   Bash

   docker compose up -d

पंक्तियाँ लिखे जाते ही भेजी जाती हैं। Status200 उन्हें दिखाते समय ceph.log फ़ॉर्मैट (समय, डेमन, INF/WRN/ERR स्तर, संदेश) पढ़ता है, और resource प्रोसेसर ceph.cluster.name लगाता है, इसलिए लॉग इसी क्लस्टर पर पहुँचता है।

क्लस्टर पर प्रोजेक्ट लेबल लगाएँ#

status200.label. से शुरू होने वाला रिसोर्स एट्रिब्यूट क्लस्टर पर एक प्रोजेक्ट लेबल बन जाता है: status200.label.<dimension>=<value> लेबल <dimension>:<value> है। एट्रिब्यूट को otel-collector-config.yaml में resource प्रोसेसर में, ceph.cluster.name के बगल में जोड़ें:

processors:
  resource:
    attributes:
      # ...existing attributes...
      - key: status200.label.team
        value: storage
        action: upsert
      - key: status200.label.env
        value: production
        action: upsert

कलेक्टर अपना कॉन्फ़िगरेशन सिर्फ़ शुरू होते समय पढ़ता है: docker compose restart status200-ceph-agent चलाएँ। इसके बाद क्लस्टर team:storage और env:production लेबल दिखाता है। लेबल का मिलान अक्षरों के बड़े-छोटे होने की परवाह किए बिना होता है, इसलिए मौजूदा Production लेबल दोहराया नहीं जाता बल्कि फिर से उपयोग होता है, और एजेंट कभी वह लेबल नहीं हटाता जिसे किसी ने Status200 में जोड़ा हो।

systemd सेवा के रूप में चलाएँ#

एजेंट को मशीन के साथ शुरू करने और विफल होने पर फिर से शुरू करने के लिए उसकी systemd यूनिट इंस्टॉल करें। यह मानती है कि एजेंट /opt/status200-ceph-agent में है, जहाँ इंस्टॉल स्क्रिप्ट उसे रखती है:

sudo curl -fsSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/systemd/status200-ceph-agent.service -o /etc/systemd/system/status200-ceph-agent.service
sudo systemctl daemon-reload
sudo systemctl enable --now status200-ceph-agent

एजेंट अपग्रेड करना#

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

कलेक्टर इमेज docker-compose.yml में पिन है और उसका कॉन्फ़िगरेशन उसके बगल की एक फ़ाइल है, इसलिए सिर्फ़ पुल करने से एजेंट आगे नहीं बढ़ता। install.sh फिर से चलाएँ: यह आपकी मौजूदा .env का हर मान दोबारा उपयोग करती है (कुछ भी फिर से नहीं पूछा जाता), docker-compose.yml और otel-collector-config.yaml ताज़ा करती है (आपकी संपादित फ़ाइल <file>.bak.<timestamp> के रूप में रखी जाती है), इमेज पुल करती है और एजेंट दोबारा बनाती है ताकि कलेक्टर अपना नया कॉन्फ़िगरेशन पढ़े। AI एजेंट का ceph/ फ़ोल्डर जैसा है वैसा ही रहता है।

curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/install.sh -o install.sh
bash install.sh

इसके बजाय Docker Compose से इंस्टॉल किया था? एजेंट के फ़ोल्डर में दोनों फ़ाइलें फिर से डाउनलोड करें (और उनमें किए गए बदलाव फिर से करें), फिर इमेज पुल करें और एजेंट दोबारा बनाएँ:

curl -fsSLO <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/docker-compose.yml
curl -fsSLO <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/otel-collector-config.yaml
docker compose pull
docker compose up -d --force-recreate

एजेंट अनइंस्टॉल करना#

cd /opt/status200-ceph-agent
docker compose down

अगर आपने AI एजेंट का Ceph क्लाइंट बनाया था, तो उसे किसी एडमिन नोड पर ceph auth del client.status200-ai से हटाएँ।

AI एजेंट#

एजेंट की docker-compose.yml Ceph AI एजेंट भी चलाती है, status200-ceph-ai-agent (इमेज status200/resource-ai-agent:release)। जब Status200 AI इस क्लस्टर पर किसी घटना या अलर्ट की जाँच करता है, तो वह इसके ज़रिए केवल-पढ़ने वाले ceph कमांड चलाता है — ceph health detail, ceph osd tree, ceph pg dump_stuck, ceph crash ls — और, सिर्फ़ आपकी अनुमति होने पर, सुधार लागू करता है, जैसे किसी OSD को फिर से in चिह्नित करना या noout हटाना। यह कलेक्टर की तरह CEPH_CLUSTER_NAME नाम वाले क्लस्टर के रूप में रजिस्टर होता है, और Status200 में क्लस्टर के एआई → AI एजेंट पेज पर दिखता है।

• AI जाँच डिफ़ॉल्ट रूप से चालू है। एजेंट के कनेक्ट होते ही Status200 AI इस क्लस्टर की घटनाओं और अलर्ट की जाँच इसके साथ करता है, और क्लस्टर का अवलोकन एजेंट की स्थिति दिखाता है। रोकने के लिए, जहाँ एजेंट चलता है वहाँ STATUS200_AI_INVESTIGATION=false सेट करें (AI एजेंट पेज पर AI क्या कर सकता है के अंतर्गत बदलें तरीका दिखाता है), या एजेंट को छोड़ दें।
• इसका अपना Ceph क्लाइंट ही पक्की सीमा है। यह client.status200-ai के रूप में कनेक्ट होता है, क्लस्टर के न्यूनतम ceph.conf और उस क्लाइंट के कीरिंग के साथ, जो docker-compose.yml के बगल में एक ceph/ फ़ोल्डर में होते हैं (/etc/ceph पर केवल-पढ़ने के लिए माउंट)। पढ़ने वाले caps के साथ, यह जो भी चलाए, क्लस्टर को बदल नहीं सकता। नए इंस्टॉल पर install.sh क्लाइंट बनाने की पेशकश करती है; दोबारा चलाने पर कभी नहीं बनाती। उस फ़ोल्डर में एडमिन कीरिंग कभी न रखें।
• यह केवल-पढ़ने वाला है, जब तक आप STATUS200_AI_ALLOW_WRITES=true सेट न करें और क्लाइंट को सुधारों के लिए caps न दें (एजेंट का README उनकी सूची देता है); STATUS200_AI_WRITE_TARGETS (उदाहरण के लिए osd.*,cluster) सीमित करता है कि कोई सुधार किसे छू सकता है। उसी .env में STATUS200_AI_FIXES बताता है कि सुधार कैसे चलते हैं — ask-for-approval (हर एक को कोई व्यक्ति स्वीकृत करता है), automatic या bypass-approval — और AI एजेंट पेज इसे केवल-पढ़ने के रूप में दिखाता है (AI क्या कर सकता है, एजेंट द्वारा तय)।
• यह मॉनिटर (TCP 3300 और 6789) और mgr व OSD डेमन (TCP 6800–7300) से बाहर की ओर कनेक्ट होता है, बिना capabilities के UID 1000 के रूप में चलता है, और कभी auth, config-key, tell या डेटा मिटाने वाली कोई चीज़ नहीं चलाता। अगर आप Status200 AI का उपयोग नहीं करते, तो docker-compose.yml से status200-ceph-ai-agent सेवा हटा दें।

क्लाइंट को हाथ से बनाने के लिए, इसे किसी Ceph एडमिन नोड पर, एजेंट के फ़ोल्डर में चलाएँ (अगर एजेंट की मशीन कोई और है, तो दोनों फ़ाइलें उस मशीन के ceph/ फ़ोल्डर में कॉपी करें):

mkdir -p ceph
ceph config generate-minimal-conf > ceph/ceph.conf
ceph auth get-or-create client.status200-ai mon 'allow r' mgr 'allow r' osd 'allow r' -o ceph/ceph.client.status200-ai.keyring
sudo chown 1000:1000 ceph/ceph.client.status200-ai.keyring
sudo chmod 600 ceph/ceph.client.status200-ai.keyring
docker compose up -d

यह क्या चला सकता है, सुधार कैसे काम करते हैं और इसकी समस्याएँ कैसे हल करें: Infrastructure AI Agents।

समस्या निवारण#

curl -sSL <YOUR_STATUS200_URL>/docs/static/scripts/agents/CephAgent/troubleshoot.sh -o troubleshoot.sh
bash troubleshoot.sh    # add -d <dir> if you installed outside /opt/status200-ceph-agent

अगले कदम#