डायग्नोस्टिक्स फ़्लैग

डायग्नोस्टिक्स फ़्लैग आपको हर जगह वर्बोज़ लॉगिंग चालू किए बिना लक्षित डीबग लॉग सक्षम करने देते हैं। फ़्लैग ऑप्ट-इन हैं और तब तक कोई प्रभाव नहीं डालते जब तक कोई सबसिस्टम उन्हें जांचता नहीं है।

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

• फ़्लैग स्ट्रिंग होते हैं (केस-असंवेदनशील)।
• आप फ़्लैग को कॉन्फ़िग में या env ओवरराइड के ज़रिए सक्षम कर सकते हैं।
• वाइल्डकार्ड समर्थित हैं:
  • telegram.* telegram.http से मेल खाता है
  • * सभी फ़्लैग सक्षम करता है

कॉन्फ़िग के ज़रिए सक्षम करें

{  "diagnostics": {    "flags": ["telegram.http"]  }}

कई फ़्लैग:

{  "diagnostics": {    "flags": ["telegram.http", "brave.http", "gateway.*"]  }}

फ़्लैग बदलने के बाद Gateway को पुनरारंभ करें।

Env ओवरराइड (एक बार के लिए)

OPENCLAW_DIAGNOSTICS=telegram.http,telegram.payload

सभी फ़्लैग अक्षम करें:

OPENCLAW_DIAGNOSTICS=0

OPENCLAW_DIAGNOSTICS=0 एक प्रक्रिया-स्तरीय अक्षम ओवरराइड है: यह उस प्रक्रिया के लिए env और कॉन्फ़िग, दोनों से आने वाले फ़्लैग अक्षम करता है।

प्रोफाइलिंग फ़्लैग

प्रोफाइलर फ़्लैग वैश्विक लॉगिंग स्तर बढ़ाए बिना लक्षित टाइमिंग स्पैन सक्षम करते हैं। वे डिफ़ॉल्ट रूप से अक्षम होते हैं।

एक Gateway रन के लिए सभी प्रोफाइलर-गेटेड स्पैन सक्षम करें:

OPENCLAW_DIAGNOSTICS=profiler openclaw gateway run

केवल reply-dispatch प्रोफाइलर स्पैन सक्षम करें:

OPENCLAW_DIAGNOSTICS=reply.profiler openclaw gateway run

केवल Codex ऐप-सर्वर स्टार्टअप/टूल/थ्रेड प्रोफाइलर स्पैन सक्षम करें:

OPENCLAW_DIAGNOSTICS=codex.profiler openclaw gateway run

कॉन्फ़िग से प्रोफाइलर फ़्लैग सक्षम करें:

{  "diagnostics": {    "flags": ["reply.profiler", "codex.profiler"]  }}

कॉन्फ़िग फ़्लैग बदलने के बाद Gateway को पुनरारंभ करें। किसी प्रोफाइलर फ़्लैग को अक्षम करने के लिए, उसे diagnostics.flags से हटाएं और पुनरारंभ करें। जब कॉन्फ़िग प्रोफाइलर फ़्लैग सक्षम करता हो तब भी हर डायग्नोस्टिक्स फ़्लैग को अस्थायी रूप से अक्षम करने के लिए, प्रक्रिया को इसके साथ शुरू करें:

OPENCLAW_DIAGNOSTICS=0 openclaw gateway run

टाइमलाइन आर्टिफ़ैक्ट

timeline फ़्लैग बाहरी QA हार्नेस के लिए संरचित स्टार्टअप और रनटाइम टाइमिंग इवेंट लिखता है:

OPENCLAW_DIAGNOSTICS=timeline \OPENCLAW_DIAGNOSTICS_TIMELINE_PATH=/tmp/openclaw-timeline.jsonl \openclaw gateway run

आप इसे कॉन्फ़िग में भी सक्षम कर सकते हैं:

{  "diagnostics": {    "flags": ["timeline"]  }}

टाइमलाइन फ़ाइल पथ अब भी OPENCLAW_DIAGNOSTICS_TIMELINE_PATH से आता है। जब timeline केवल कॉन्फ़िग से सक्षम होता है, तो सबसे शुरुआती कॉन्फ़िग-लोडिंग स्पैन उत्सर्जित नहीं होते क्योंकि OpenClaw ने अभी तक कॉन्फ़िग नहीं पढ़ा होता; बाद के स्टार्टअप स्पैन कॉन्फ़िग फ़्लैग का उपयोग करते हैं।

OPENCLAW_DIAGNOSTICS=1, OPENCLAW_DIAGNOSTICS=all, और OPENCLAW_DIAGNOSTICS=* भी टाइमलाइन सक्षम करते हैं क्योंकि वे हर डायग्नोस्टिक्स फ़्लैग सक्षम करते हैं। जब आपको केवल JSONL टाइमिंग आर्टिफ़ैक्ट चाहिए हो, तो timeline को प्राथमिकता दें।

टाइमलाइन रिकॉर्ड openclaw.diagnostics.v1 एनवेलप का उपयोग करते हैं। इवेंट में प्रोसेस आईडी, चरण नाम, स्पैन नाम, अवधि, Plugin आईडी, निर्भरता की गिनती, इवेंट-लूप विलंब नमूने, प्रोवाइडर ऑपरेशन नाम, चाइल्ड-प्रोसेस एग्ज़िट स्थिति, और स्टार्टअप त्रुटि नाम/संदेश शामिल हो सकते हैं। टाइमलाइन फ़ाइलों को स्थानीय डायग्नोस्टिक्स आर्टिफ़ैक्ट मानें; उन्हें अपनी मशीन के बाहर साझा करने से पहले समीक्षा करें।

लॉग कहां जाते हैं

फ़्लैग मानक डायग्नोस्टिक्स लॉग फ़ाइल में लॉग उत्सर्जित करते हैं। डिफ़ॉल्ट रूप से:

/tmp/openclaw/openclaw-YYYY-MM-DD.log

यदि आप logging.file सेट करते हैं, तो उसके बजाय उस पथ का उपयोग करें। लॉग JSONL होते हैं (हर पंक्ति में एक JSON ऑब्जेक्ट)। logging.redactSensitive के आधार पर रेडैक्शन अब भी लागू होता है।

लॉग निकालें

नवीनतम लॉग फ़ाइल चुनें:

ls -t /tmp/openclaw/openclaw-*.log | head -n 1

Telegram HTTP डायग्नोस्टिक्स के लिए फ़िल्टर करें:

rg "telegram http error" /tmp/openclaw/openclaw-*.log

Brave Search HTTP डायग्नोस्टिक्स के लिए फ़िल्टर करें:

rg "brave http" /tmp/openclaw/openclaw-*.log

या पुनरुत्पादन करते समय tail करें:

tail -f /tmp/openclaw/openclaw-$(date +%F).log | rg "telegram http error"

रिमोट Gateway के लिए, आप openclaw logs --follow का भी उपयोग कर सकते हैं (/cli/logs देखें)।

नोट्स

• यदि logging.level warn से ऊंचा सेट है, तो ये लॉग दब सकते हैं। डिफ़ॉल्ट info ठीक है।
• brave.http Brave Search अनुरोध URL/क्वेरी पैराम, प्रतिक्रिया स्थिति/टाइमिंग, और कैश hit/miss/write इवेंट लॉग करता है। यह API कुंजियां या प्रतिक्रिया बॉडी लॉग नहीं करता, लेकिन खोज क्वेरी संवेदनशील हो सकती हैं।
• फ़्लैग सक्षम छोड़ना सुरक्षित है; वे केवल विशिष्ट सबसिस्टम के लिए लॉग वॉल्यूम को प्रभावित करते हैं।
• लॉग गंतव्य, स्तर, और रेडैक्शन बदलने के लिए /logging का उपयोग करें।

संबंधित

• Gateway डायग्नोस्टिक्स
• Gateway समस्या निवारण