وبوكي هو خادم الويب صغير لجمع وترجمة مقاييس الجرافيت على & nbsp؛ ويمكن أن جمع البيانات الحالية متري من الشياطين CollectD ومن العملاء StatsD.
تركيب
يمكنك تثبيت مع easy_install أو نقطة وفقا لطريقة العمل العادية:
على & nbsp؛ easy_install بوكي
# أو
PIP تثبيت بوكي
بعد تثبيت، يمكنك تشغيل بوكي مثل:
بوكي
افتراضيا، سوف بوكي فتح مقبس CollectD UDP على 127.0.0.1:25826، مأخذ StatsD على 127.0.0.1:8125 وكذلك محاولة للاتصال المحلي الجرافيت (الكربون) الخفي على 127.0.0.1:2003.
وهذه كلها اختياري كما هو موضح أدناه. يمكنك أيضا تعطيل خوادم CollectD أو StatsD تماما إذا كنت ترغب في ذلك.
تشغيل بوكي لريال مدريد
سوف المراقب المخضرمين تلاحظ أن بوكي لا يوجد لديه الأعلام لdaemonization. هذا هو تماما عن قصد. الطريقة الموصى بها لتشغيل بكي في الإنتاج عبر رونيت. هناك دليل الخدمة سبيل المثال في مستودع المصدر بوكي ل.
خيارات سطر الأوامر
خيارات سطر الأوامر تقتصر على السيطرة على معلمات الشبكة. إذا كنت ترغب في تكوين بعض من عمل أكثر تعقيدا ستحتاج إلى استخدام ملف التكوين. وهنا إخراج -h بوكي:
الاستعمال: main.py [OPTIONS] [CONFIG_FILE]
خيارات:
على & nbsp؛ - collectd-IP عنوان IP = IP لربط لمقبس CollectD UDP
على & nbsp؛ [127.0.0.1]
على & nbsp؛ - collectd ميناء بورت = INT لربط لمقبس CollectD UDP [25826]
على & nbsp؛ - collectd-أنواع = FILE
على & nbsp؛ المسار إلى ملف types.db collectd
على & nbsp؛ - تعطيل-collectd تعطيل الخادم CollectD UDP
على & nbsp؛ - statsd-IP عنوان IP = IP لربط لمقبس StatsD UDP
على & nbsp؛ [127.0.0.1]
على & nbsp؛ - statsd ميناء بورت = INT لربط لمقبس StatsD UDP [8125]
على & nbsp؛ - تعطيل-statsd تعطيل الخادم StatsD
على & nbsp؛ - الجرافيت-IP = عنوان IP IP لخادم الجرافيت / الكربون [127.0.0.1]
على & nbsp؛ - الجرافيت ميناء بورت = INT خادم الجرافيت / الكربون [2003]
على & nbsp؛ - كامل النزرة العرض الخطأ الكامل في حال فشل ملف التكوين لتحميل
على & nbsp؛ - رقم إصدار نسخة عرض البرنامج والخروج
على & nbsp؛ -h، --help إظهار هذه الرسالة مساعدة والخروج
خيارات ملف التكوين
ملف التكوين هو ملف بيثون الطبيعي أن يحدد عدد من المتغيرات. ويمكن أيضا أن يتم تعيين معظم خيارات سطر الأوامر في هذا الملف (إزالة "-" البادئة واستبدال "-" مع "_")، ولكن إذا تم تحديدها في كل من الأماكن، وسطر الأوامر يأخذ الأولوية. الافتراضات كملف التكوين:
# بادئة لأسماء متري collectd
collectd_conv_prefix = بلا
# بوستفيكس لأسماء متري collectd
collectd_conv_postfix = بلا
# استبدال نقاط (.) في أسماء متري مع هذه القيمة
collectd_replace = "_"
# إذا مسار ديه مكونات المتكررة متطابقة، والانهيار
# لهم مثيل واحد. أي يصبح a.b.b.c a.b.c
collectd_strip_duplicates = صحيح
# سيتم إزالة هذه أسماء المضيفين من المضيفين أن
وردت #. أي إذا "foo.bar.cloudant.com" يأتي في
# و"cloudant.com" يتم سرد، ثم الناتجة
سوف # المضيف أن يكون "foo.bar".
collectd_host_trim = []
تحتاج المقاييس # CollectD أن يكون له اسم ولدت ل
# استخدام الجرافيت. هنا يمكنك تسجيل خاص
معالج المقاييس # استنادا إلى البرنامج المساعد CollectD
اسم #.
#
# وعلى سبيل المثال، والمساعد CollectD وحدة المعالجة المركزية ينتهي مع
# أسماء متري مثل "host.cpu.0.cpu.idle" لإزالة
# على سبيل المثال وحدة المعالجة المركزية الثانية يمكننا تسجيل البرنامج المساعد
# لتوليد الاسم.
#
# يجب أن يكون مفتاح ديكت اسم البرنامج المساعد CollectD
وينبغي أن يكون # والقيمة وللاستدعاء الذي يقبل
# حجة واحدة وإرجاع قائمة السلاسل.
collectd_converters = {}
# اختياريا تعطيل نظام البحث واسعة ل
# تحويل الإضافات.
# المحولات.
collectd_use_entry_points = صحيح
# عدد الثواني التي ينبغي البرنامج الخفي StatsD
# الانتظار قبل التنظيف القيم.
statsd_flush_time = 10
تكوين CollectD
يجب أن تحتاج فقط إلى إضافة شيء من هذا القبيل لcollectd.conf الخاص بك:
LoadPlugin "الشبكة"
<البرنامج المساعد "شبكة">
على & nbsp؛ خادم "127.0.0.1" "25826"
من الواضح، فأنت تريد أن تصل المباراة عناوين IP والموانئ وتأكد من أن يتم تكوين لجدار الحماية الخاص بك للسماح حزم UDP من خلال.
تكوين StatsD
مجرد نقطة عملاء StatsD الخاص بك في IP / ميناء بوكي ويجب أن تكون على ما يرام.
مذكرة بشأن المحولات CollectD
مقاييس CollectD ليست بالضبط ترجمة مباشرة إلى الجرافيت أسماء متري. محاولات المترجم الافتراضي لتقديم أفضل تخمين ولكن هذا يمكن أن يؤدي إلى أقل قليلا من الأشجار الجرافيت جميلة.
لهذا السبب، بوكي ديه المحولات شكلي. ومقفول هذه قبالة اسم البرنامج المساعد CollectD. المدخل إلى هذه الوظائف هو تمثيل متري CollectD التي تبدو وكأنها مثل:
{
على & nbsp؛ 'المضيف': 'toroid.local،
على & nbsp؛ "الفاصلة": 10.0،
على & nbsp؛ 'البرنامج المساعد': 'الذاكرة'،
على & nbsp؛ "plugin_instance ':' '،
على & nbsp؛ 'الوقت': 1320970329،175534،
على & nbsp؛ 'نوع': 'الذاكرة'،
على & nbsp؛ "type_instance ':" غير نشطة "،
على & nbsp؛ "القيمة": 823٬009٬280،0،
على & nbsp؛ "value_name ':' قيمة '،
على & nbsp؛ "value_type ': 1
}
وينبغي أن تكون نتيجة هذه الوظيفة قائمة السلاسل التي تمثل جزء من اسم المتري الجرافيت. على سبيل المثال، إذا عاد محول ["فو"، "شريط"]، ستنتهي اسم المتري النهائي على النحو: $ البادئة $ hostname.foo.bar $ بوستفيكس...
مثال تحويل مدمج يبدو مثل:
# قد يكون هذا كيف يمكنك تعريف المحول في
# ملف التكوين الخاص بك
الطبقة MemoryConverter (كائن):
على & nbsp؛ الأولوية = 0
على & nbsp؛ مواطنه __call __ (النفس، عينة):
على & nbsp؛ العودة ["ذاكرة"، عينة ["type_instance"]]
collectd_converters = [MemoryConverter ()]
يكون جامعي أيضا فكرة الأولوية من أجل حل الصراعات. هذا هو مجرد ويفضل خاصية على مستحقة يدعى "الأولوية" وأولويات أكبر. أنا لا أتصور هذا سوف تحتاج إلى استخدامها في كثير من الأحيان، ولكن من هناك فقط في حالة.
يمكن إما أن تعلن محولات و / أو استيرادها في ملف التكوين اختياري، أو أنها يمكن autodiscovered عبر نقاط الدخول. نقطة الدخول التي يتم البحث هي "bucky.collectd.converters". يجب أن يكون اسم نقطة الدخول اسم البرنامج المساعد CollectD
المتطلبات:.
بيثون
لم يتم العثور على التعليقات