rootly-ai-labs/rootly-graphify-importerRootly की घटनाओं, अलर्ट्स और टीमों को एक खोजने योग्य ज्ञान ग्राफ में बदलें। सेवा निर्भरताओं, ऑन-कॉल कवरेज अंतराल और क्रॉस-इंसिडेंट पैटर्न की कल्पना करें।
graphify पर आधारित, यह एक ऐसा टूल है जो Andrej Karpathy के LLM Wiki विचार से प्रेरित है — हर क्वेरी पर शुरू से ज्ञान को फिर से खोजने के बजाय, एक LLM को एक स्थायी, संरचित ज्ञान ग्राफ बनाने दें जो समय के साथ समृद्ध होता जाता है। Graphify फ़ाइलों के किसी भी फ़ोल्डर को लेता है और उसे समुदायों, कनेक्शनों और आत्मविश्वास स्कोर के साथ एक क्वेरी करने योग्य ग्राफ में बदल देता है। यह फोर्क इसे Rootly API पर इंगित करता है।
Rootly API से कनेक्ट करें, एक चयनित समय विंडो के लिए घटनाओं (incidents), चेतावनियों (alerts), टीमों और सेवा सूची को एकत्र करें, उन्हें एक स्थानीय कॉर्पस में निर्यात करें, और उस कॉर्पस को एक क्वेरी करने योग्य ज्ञान ग्राफ में बदलें। संग्रह के लिए graphify rootly और गहरे सिमैंटिक विश्लेषण के लिए Claude Code या Codex में /graphify का उपयोग करें।
नई स्थापना (Graphify + Rootly इम्पोर्टर):
pip install "graphifyy[rootly]"
graphify install # Claude Code
graphify install --platform codex # Codex
मौजूदा Graphify सेटअप में Rootly इम्पोर्टर जोड़ना:
pip install "graphifyy[rootly]" --upgrade
अपने प्रोजेक्ट रूट में एक .env फ़ाइल बनाएं:
ROOTLY_API_KEY=rootly_...
घटनाओं (incidents), ट्रिगर की गई चेतावनियों और टीमों को लाता है। गंभीरता रंग, चेतावनी फ़िल्टर और टीम/सेवा परतों के साथ प्रारंभिक ग्राफ बनाता है।
graphify rootly
गैर-इंटरैक्टिव:
graphify rootly --api-key-env ROOTLY_API_KEY --days 30 --mode standard
आउटपुट graphify-rootly-data/graphify-out/ में लिखा जाता है:
graph.html — ग्राफ देखने के लिए ब्राउज़र में खोलेंGRAPH_REPORT.md — गॉड नोड्स, समुदाय, सुझाए गए प्रश्नgraph.json — क्वेरी करने के लिए कच्चा ग्राफघटना कॉर्पस पर क्रॉस-इवेंट थीम, आवर्ती पैटर्न और मूल कारण संबंधों का अनुमान लगाने के लिए समानांतर उप-एजेंट चलाता है।
Claude Code — चैट में टाइप करें:
/graphify graphify-rootly-data --mode deep
Codex — चैट में टाइप करें:
run graphify on graphify-rootly-data --mode deep
| पैटर्न | यह क्या दिखाता है | ग्राफ़ क्यों मददगार है |
|---|---|---|
| सेवा घटना हीटमैप | कौन सी सेवाएं जल रही हैं और कितनी बुरी तरह। नोड का आकार = घटना गणना, रंग = सबसे खराब गंभीरता। | उन सेवाओं को समूहित करता है जो एक साथ विफल होती हैं, छिपी हुई बुनियादी ढाँचा निर्भरता को प्रकट करता है। |
| टीम ऑन-कॉल और एस्केलेशन मैप | एक दृश्य में सभी शेड्यूल और एस्केलेशन नीतियों पर कौन क्या कवर करता है। | विफलता के एकल बिंदुओं को उजागर करता है — वह व्यक्ति जो 3 टीमों में 4 शेड्यूल पर है — और कवरेज अंतराल। |
| चेतावनी-से-घटना फ़नल | कौन से चेतावनी स्रोत वास्तविक घटनाएँ उत्पन्न करते हैं बनाम शुद्ध शोर। | 200 चेतावनियों और 0 घटनाओं वाला एक चेतावनी स्रोत तुरंत नोड आकार से दिखता है। |
| घटना → कार्य वस्तु अनुवर्तन | क्या हम वास्तव में जो टूटता है उसे ठीक कर रहे हैं? ठोस किनारे = पूर्ण, डैश = खुला। | एक टीम या सेवा के आसपास खुली कार्य वस्तुओं के समूह व्यवस्थित अनुवर्तन समस्याओं को उजागर करते हैं। |
| क्रॉस-सेवा विफलता सहसंबंध | कौन सी सेवाएँ एक ही समय विंडो में एक साथ विफल होती हैं। | समुदाय का पता लगाना साझा-भाग्य समूहों को ढूंढता है जो संभवतः एक ही अंतर्निहित बुनियादी ढाँचे पर निर्भर करते हैं। |
| संसाधन | क्या | फ़िल्टर |
|---|---|---|
| घटनाएँ (Incidents) | शीर्षक, गंभीरता, स्थिति, समयरेखा, सेवाएँ, टीमें, विवरण | दिनांक विंडो (--days) |
| चेतावनियाँ (Alerts) | सारांश, स्थिति, स्रोत, शोर फ़्लैग, समयरेखा | केवल ट्रिगर की गई (एक घटना से जुड़ी) |
| टीमें (Teams) | नाम, स्लग, सेवा स्वामित्व | खाते की सभी टीमें |
एक बार graph.html ब्राउज़र में खुलने पर:
rootly-graphify में एक Rootly संग्रह चरण और एक ग्राफ विश्लेषण चरण है।
निर्धारक (Deterministic) Rootly संग्रह। API कुंजी सत्यापित करें, 7, 30, या 90 दिनों की विंडो चुनें, उन घटनाओं को लाएं जिनका started_at उस विंडो के अंतर्गत आता है, प्रति-घटना उप-संसाधन के माध्यम से उनकी ट्रिगर की गई चेतावनियाँ लाएं, सभी टीम डेटा लाएं, और सब कुछ एक स्थानीय कॉर्पस निर्देशिका में लिखें।
प्रारंभिक Rootly ग्राफ निर्माण। अंतर्निहित Rootly रनर घटनाओं, चेतावनियों, टीमों और सेवाओं के लिए नोड्स बनाता है, उन्हें टाइप किए गए किनारों (triggered, affects, owns, responded_by, targets) से जोड़ता है, ग्राफ को क्लस्टर करता है, और graph.html, GRAPH_REPORT.md, और graph.json लिखता है। HTML में गंभीरता रंग कोडिंग, टीम/सेवा परतें और चेतावनी फ़िल्टर शामिल हैं।
वैकल्पिक गहरी समृद्धि (Deep enrichment)। क्रॉस-इवेंट थीम, तर्क और अवधारणात्मक लिंक का अनुमान लगाने के लिए मार्कडाउन फ़ाइलों पर समानांतर उप-एजेंट भेजने के लिए /graphify ./graphify-rootly-data --mode deep चलाएं।
वर्तमान शीर्ष-स्तरीय आउटपुट का उपयोग करें। सिमैंटिक समृद्धि के बाद, graphify-out/graph.html खोलें। वर्तमान सामान्य निर्यातक में पहले से ही सीधे बनाए गए फ़िल्टर और दृश्य शामिल हैं, इसलिए किसी अलग पुनः-आवेदन चरण की आवश्यकता नहीं है।
क्लस्टरिंग ग्राफ-टोपोलॉजी-आधारित है — कोई एम्बेडिंग नहीं। Leiden किनारे घनत्व द्वारा समुदाय ढूंढता है। सिमैंटिक समानता किनारे (semantically_similar_to, INFERRED चिह्नित) समुदाय का पता लगाने को सीधे प्रभावित करते हैं। कोई अलग एम्बेडिंग चरण या वेक्टर डेटाबेस की आवश्यकता नहीं है।
हर संबंध को EXTRACTED (सीधे स्रोत में पाया गया), INFERRED (उचित अनुमान, आत्मविश्वास स्कोर के साथ), या AMBIGUOUS (समीक्षा के लिए चिह्नित) के रूप में टैग किया गया है।
गॉड नोड्स (God nodes) — सबसे उच्च-डिग्री घटनाएँ या सेवाएँ (वह सब कुछ जिसके माध्यम से जुड़ता है)
आश्चर्यजनक कनेक्शन — समग्र स्कोर द्वारा क्रमबद्ध क्रॉस-इवेंट लिंक, प्रत्येक सादे-अंग्रेज़ी स्पष्टीकरण के साथ
सुझाए गए प्रश्न — 4–5 प्रश्न जिनका उत्तर देने के लिए ग्राफ़ आपकी घटना के इतिहास के बारे में विशिष्ट रूप से उपयुक्त है
आत्मविश्वास स्कोर — हर INFERRED किनारे का confidence_score (0.0–1.0) है। EXTRACTED किनारे हमेशा 1.0 होते हैं।
सिमैंटिक समानता किनारे — बिना किसी संरचनात्मक संबंध के क्रॉस-इवेंट अवधारणात्मक लिंक। दो घटनाएँ जो सेवाओं या टीमों को साझा किए बिना एक ही मूल पैटर्न के कारण होती हैं।
टोकन दक्षता — पहला रन निकालता है और ग्राफ बनाता है (टोकन की लागत)। हर बाद की क्वेरी कच्चे मार्कडाउन के बजाय कॉम्पैक्ट ग्राफ पढ़ती है — यहीं पर बचत बढ़ती है। SHA256 कैश का मतलब है कि पुन: रन केवल बदली हुई फाइलों को पुन: संसाधित करते हैं।
# --- Rootly वर्कफ़्लो (टर्मिनल) ---
graphify rootly # इंटरैक्टिव Rootly इम्पोर्ट फ्लो
graphify rootly --days 30 # पिछले 30 दिनों की घटनाएँ एकत्र करें
graphify rootly --api-key-env ROOTLY_API_KEY # env से गैर-इंटरैक्टिव कुंजी लुकअप
graphify rootly --output ./my-rootly-corpus # कॉर्पस को कस्टम फ़ोल्डर में लिखें
# --- सिमैंटिक समृद्धि (एजेंट: Claude Code / Codex) ---
/graphify ./graphify-rootly-data # Rootly कॉर्पस का विश्लेषण करें
/graphify ./graphify-rootly-data --mode deep # अधिक आक्रामक INFERRED किनारे
/graphify ./graphify-rootly-data --update # केवल बदली हुई फ़ाइलों को पुनः निकालें
# --- ग्राफ को क्वेरी करें (एजेंट) ---
/graphify query "which services have the most recurring incidents?"
/graphify query "what patterns connect the SEV1 incidents?"
/graphify path "payment-api" "auth-service"
/graphify explain "Incident: Database connection pool exhausted"
# --- वैकल्पिक निर्यात ---
/graphify ./graphify-rootly-data --wiki # प्रति समुदाय एजेंट-क्रॉल करने योग्य विकी
/graphify ./graphify-rootly-data --no-viz # HTML छोड़ें, केवल रिपोर्ट + JSON
/graphify ./graphify-rootly-data --obsidian # Obsidian वॉल्ट
# --- हमेशा चालू सहायक निर्देश ---
graphify claude install # CLAUDE.md + PreToolUse हुक (Claude Code)
graphify codex install # AGENTS.md (Codex)
# ताज़ा डेटा लाएँ और पुनः बनाएँ
graphify rootly --api-key-env ROOTLY_API_KEY --days 30 --mode standard
# सिमैंटिक चरण के साथ पुनः समृद्ध करें (Claude Code)
/graphify graphify-rootly-data --update