मीडियाविकि एक्सटेंशन मैन्युअल

ApiFeatureUsage प्रकाशन की स्थिति: स्थिरCategory:Stable extensions/hi
कार्यान्वयन	विशेष पृष्ठ Category:Special page extensions/hi, API Category:API extensions/hi
विवरण	API सुविधा के प्रयोगों के लॉग का सारांश देखें
लेखक	Brad Jorsch (Anomieवार्ता)
नवीनतम संस्करण	1.0 (2016-12-07)
संगतता नीति	मीडियाविकि के साथ प्रकाशित स्नैपशॉट्स। Master में पीछे की तरफ से संगतता नहीं है।
MediaWiki	1.25+Category:Extensions with manual MediaWiki version/hi
PHP	5.5.9+
डेटाबेस बदलता है	नहीं
लाइसेंस	GNU साधारण सार्वजनिक लाइसेंस 2.0 या अधिक
डाउनलोड करें	एक्सटेंशन डाउनलोड करें गिट [?]: रिपॉज़िटरी देखें (GitHub) कोड निरीक्षण कमिट्स का इतिहास Download source tarball Category:Extensions in Wikimedia version control/hi
पैरामीटर $wgApiFeatureUsageQueryEngineConf
उपयोग किए गए हुक ApiDeprecationHelp Category:ApiDeprecationHelp extensions/hi ApiLogFeatureUsage Category:ApiLogFeatureUsage extensions/hi LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions/hi
ApiFeatureUsage एक्सटेंशन को अनुवादित करें
मुद्दे	अधूरे कार्य · बग की रिपोर्ट करें

ApiFeatureUsage एक्सटेंशन एक विशेष पृष्ठ और एक API मॉड्यूल जोड़ता है जिससे ApiBase::logFeatureUsage() द्वारा लॉग किए गए डेटा के सारांश को प्राप्त किया जा सकात है, जो आम तौर पर कालग्रस्त API सुविधाओं का एक चिह्न होता है।

निर्भरताएँ

लॉग के डेटा को किसी तरह के संग्रहण प्रणाली पर जोड़ा जाना चाहिए। वर्तमान में Elasticsearch को एक्सटेंशन:Elastica के ज़रिए समर्थित किया जाता है।

स्थापना

• फ़ाइलों को डाउनलोड करें और अपने extensions/ फ़ोल्डर के ApiFeatureUsage नामक डिरेक्ट्री में डालें।
  Developers and code contributors should install the extension from Git instead, using:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/ApiFeatureUsage
  

• अपने LocalSettings.php फ़ाइल के अंत में निम्न कोड जोड़ें:

  wfLoadExtension( 'ApiFeatureUsage' );
  

• पूर्ण – अपने विकि पर Special:Version पर जाकर देखें कि एक्सटेंशन को सफलतापूर्वक स्थापित किया गया है कि नहीं।

कॉन्फ़िगरेशन

पैरामीटर

Elastica बैक-एंड (ApiFeatureUsageQueryEngineElastica)

$wgApiFeatureUsageQueryEngineConf पर अतिरिक्त कॉन्फ़िगरेशन वैल्यू:

serverList

Elasticsearch सर्वरों का ऐरे। आवश्यक।

maxConnectionAttempts

जुड़ने के अधिकतम प्रयास, डिफ़ॉल्ट है 1।

indexPrefix

इनडेक्सों द्वारा प्रयुक्त उपसर्ग। डिफ़ॉल्ट है "apifeatureusage-"।

indexFormat

इनडेक्सों द्वारा प्रयुक्त दिनांक प्रारूप, PHP मैन्युअल देखें। डिफ़ॉल्ट है "Y.m.d"।

type

क्वेरी करने के लिए Elasticsearch का प्रकार। डिफ़ॉल्ट है "api-feature-usage-sanitized"।

featureField

$feature के लॉग किए गए वैल्यू के फ़ील्ड का नाम। डिफ़ॉल्ट है "feature"।

timestampField

लॉग किए गए टाइमस्टैम्प के फ़ील्ड का नाम। डिफ़ॉल्ट है "@timestamp"।

agentField

लॉग किए गए सदस्य एजेंट के फ़ील्ड का नाम। डिफ़ॉल्ट है "agent"।

प्रयोग

यह एक्सटेंशन एक नया विशेष पृष्ठ, Special:ApiFeatureUsage, जोड़ता है जहाँ पर एक फ़ॉर्म है, जिसकी मदद से किसी सदस्य एजेंट और दिनांक के रेंज के लिए सुविधा के प्रोयोगों के लॉग के सारांश का अनुरोध किया जा सकता है।

यह एक्सटेंशन एक API क्वेरी सबमॉड्यूल meta=featureusage भी जोड़ता है। विस्तार के लिए अपने आप जनरेट किया हुआ API प्रलेख देखें।

ये भी देखें

• एक्सटेंशन:Elastica

इस एक्सटेंशन का इस्तेमाल एक या अधिक विकिमीडिया परियोजनाओं पर किया जा रहा है। इसका शायद मतलब है कि एक्सटेंशन स्थिर है और इस तरह के अधिक दर्शकों वाले वेबसाइटों द्वारा उपयोग किए जाने के लिए पर्याप्त रूप से काम करता है। विकिमीडिया की CommonSettings.php और InitialiseSettings.php कॉन्फ़िगरेशन फ़ाइलों में इस एक्सटेंशन का नाम खोजें, और यह वहीं स्थापित होगा। किसी विशिष्ट विकि पर स्थापित एक्सटेंशन्स की पूरी सूची को विकि के Special:Version पृष्ठ पर देखा जा सकता है।