مك ليفيستاتوس.
1. كيفية الوصول إلى بيانات حالة ناجيوس.
1.1. الوصول إلى بيانات الحالة اليوم.
الطريقة الكلاسيكية للوصول إلى الوضع الحالي من المضيفين والخدمات الخاصة بك هي من خلال قراءة وتحليل الوضع file. dat، الذي تم إنشاؤه من قبل ناجيوس على أساس منتظم. يتم تكوين الفاصل الزمني للتحديث عبر status_update_interval في nagios. cfg. القيمة النموذجية هي 10 ثوان. إذا كان التثبيت الخاص بك هو الحصول على أكبر، قد تضطر إلى زيادة هذه القيمة من أجل تقليل استخدام وحدة المعالجة المركزية والقرص إو. تستخدم واجهة ويب ناجيوس status. dat لعرض بياناتها.
تحليل الحالة. dat ليست شعبية جدا بين مطوري أدونز. الكثير من استخدام نهج آخر: ندو. هذه هي وحدة نيب التي يتم تحميلها مباشرة في عملية ناجيوس ويرسل كل تحديثات الحالة عبر مأخذ أونيكس لعملية مساعد. عملية المساعد بإنشاء عبارات سكل وتحديث الجداول المختلفة في قاعدة بيانات ميسكل أو بوستغريزل. هذا النهج لديه العديد من المزايا على status. dat:
يتم تحديث البيانات إمدياتلي، وليس فقط كل 10 أو 20 ثانية. التطبيقات لديها سهولة الوصول إلى البيانات عبر سكل. ليس هناك حاجة إلى محلل ل status. dat. في المنشآت الكبيرة وصول أدونس إلى البيانات أسرع ثم قراءة status. dat.
لسوء الحظ، ومع ذلك، ندو لديه أيضا بعض أوجه القصور الشديدة:
أنه يحتوي على الإعداد المعقدة. وهي تحتاج إلى قاعدة بيانات (سريعة النمو) تدار. فإنه يأكل جزء كبير من رسسورسز وحدة المعالجة المركزية الخاصة بك، فقط من أجل الحفاظ على قاعدة البيانات ما يصل إلى تاريخ. يمكن للتدبير المنزلي المنتظم لقاعدة البيانات شنق ناجيوس لدقائق أو حتى ساعة واحدة في اليوم.
1.2. المستقبل.
منذ الإصدار 1.1.0، Check_MK يقدم نهجا جديدا تماما للوصول إلى الحالة والبيانات التاريخية أيضا: ليفيستاتوس. تماما كما ندو، ليفيستاتوس الاستفادة من ناجيوس الحدث وسيط أبي وتحميل وحدة ثنائية في عملية ناجيوس الخاص بك. ولكن البعض ثم ندو، ليفيستاتوس لا يكتب بنشاط البيانات. بدلا من ذلك، فإنه يفتح مأخذ التي يمكن استرداد البيانات عند الطلب.
مأخذ يسمح لك بإرسال طلب للحصول على المضيفين والخدمات أو غيرها من أجزاء من البيانات والحصول على إجابة فورية. يتم قراءة البيانات مباشرة من هياكل البيانات الداخلية ناجيوس. ليفستاتوس لا تخلق نسخة خاصة بها من تلك البيانات. بدءا من الإصدار 1.1.2 كنت أيضا قادرة على استرداد البيانات التاريخية من ملفات سجل ناجيوس عبر ليفيستاتوس.
هذا ليس فقط نهج بسيط مذهل، ولكن أيضا واحدة سريعة للغاية. بعض المزايا هي:
على عكس ندو، باستخدام ليفستاتوس يفرض أي عبء يمكن قياسه على وحدة المعالجة المركزية الخاصة بك على الإطلاق. فقط عند معالجة الاستفسارات هناك حاجة إلى كمية صغيرة جدا من وحدة المعالجة المركزية. ولكن هذا لن يمنع حتى ناجيوس. ليفستاتوس تنتج صفر القرص إو عند التجميع بيانات الحالة. الوصول إلى البيانات أسرع بكثير ثم تحليل الحالة. دات أو الاستعلام عن قاعدة بيانات سكل. لا حاجة إلى تكوين، لا حاجة إلى قاعدة بيانات. لا توجد إدارة ضرورية. ليفستاتوس موازين جيدا للمنشآت الكبيرة، حتى بعد 50.000 الخدمات. ليفيستاتوس يتيح لك الوصول إلى بيانات ناجيوس محددة غير متوفرة لأي طريقة أخرى للوصول إلى الحالة المتاحة - على سبيل المثال المعلومات ما إذا كان المضيف هو حاليا في فترة الإشعار.
وفي الوقت نفسه، يوفر ليفيستاتوس لغة الاستعلام الخاصة بها التي هي بسيطة لفهم، ويقدم معظم المرونة من سكل وأكثر من ذلك في بعض الحالات. انها بروتوكول سريع، خفيفة الوزن ولا تحتاج إلى عميل ثنائي. يمكنك حتى الحصول على الوصول من قذيفة دون أي برنامج المساعد.
1.3. الحاضر.
ليفيستاتوس لا يزال التكنولوجيا الشباب، ولكن بالفعل العديد من أدونز دعم ليفستاتوس كمصدر البيانات أو حتى يقترح أنها الافتراضي. هنا قائمة (غير مكتملة) من أدونز مع ليفيستاتوس الدعم: ناغفيس - ناغفيس ناجيسبب - بب-addon. monitoringexchange ثروك - ثروك كوفيسينت - فانيوسدن / جافا / كوفيسينت / ريلوبينزيت - ريلوبينزيت وبالطبع: Check_MK مولتيسيت!
يرجى مراسلتنا إذا كنت تعتقد أن هذه القائمة غير مكتملة.
2. إعداد واستخدام ليفستاتوس.
2.1. الإعداد التلقائي.
الطريقة النموذجية لإعداد ليفستاتوس هو فقط للرد نعم عندما يطلب من إعداد Check_mk. تحتاج إلى أن يكون لديك كافة الأدوات المثبتة التي تحتاجها لتجميع برامج C ++. هذه هي على الأقل: غنو C ++ مترجم (تعبئتها ك g + في دبيان) الأداة المساعدة تجعل (تعبئتها كما جعل) ملفات تطوير ليبك (libc6-ديف) ملفات تطوير مكتبة C ++ القياسية (ليبستدك ++ 6-ديف )
البرنامج النصي setup. sh يجمع وحدة تسمى livestatus. o ونسخها في / أسر / ليب / check_mk (إذا لم تقم بتغيير هذا المسار). كما أنه يضيف سطرين إلى nagios. cfg، التي تحتاجها لتحميل الوحدة النمطية. بعد ذلك تحتاج فقط إلى إعادة تشغيل ناجيوس ومقبس أونيكس مع اسم الحية يجب أن تظهر في نفس الدليل كما كنت ناجيوس الأمر الأوامر.
2.2. إعداد يدوي.
هناك العديد من الحالات التي يكون فيها الإعداد اليدوي أفضل، على سبيل المثال: إذا كنت لا تريد استخدام Check_MK، ولكن ليفستاتوس فقط إذا كان الإعداد التلقائي لا يعمل بشكل صحيح (وهو أمر مستبعد ولكن ليس مستحيلا). إذا كنت ترغب في إجراء تغييرات على شفرة المصدر ليفيستاتوس.
لإعداد ليفيستاتوس يدويا، يمكنك تحميل شفرة المصدر مستقلة من Check_MK في صفحة التنزيل. فك القطران في مكان مناسب والتغيير إلى الدليل الذي تم إنشاؤه حديثا:
الآن دعونا تجميع وحدة نمطية. ليفستاتوس يستخدم معيار تكوين - script ويتم تجميعها مع ./configure && جعل.
إذا كنت تقوم بتشغيل على وحدة المعالجة المركزية متعددة النواة يمكنك تسريع تجميع عن طريق إضافة - j 4 أو - j 8 لجعل:
. وما إلى ذلك وهلم جرا. . بعد تثبيت ناجح، تثبيت تثبيت سيتم تثبيت ملف واحد يدعى livestatus. o في / أسر / لوكال / ليب / مك ليفيستاتوس و ونيكسكات برنامج صغير في / أسر / لوكال / بن (كالمعتاد، يمكنك تغيير مسارات مع خيارات قياسية لتكوين ):
مهمتك الأخيرة هي تحميل livestatus. o إلى ناجيوس. يقال ناجيوس لتحميل تلك الوحدة وإرسال كافة أحداث تحديث الحالة إلى وحدة نمطية بواسطة السطرين التاليين في nagios. cfg:
والحجة الإلزامية الوحيدة هي المسار الكامل لمقبس أونيكس الذي يقوم ليفيستاتوس بإنشائه (/ فار / ليب / ناجيوس / رو / ليف في مثالنا). يرجى تغيير ذلك إذا لزم الأمر. الأفضل هو ربما لوضعه في نفس الدليل كما ناجيوس الأنابيب. تماما كما ناجيوس يفعل مع الأنبوب، ليفيستاتوس يخلق مأخذ مع أذونات 0660. إذا كان الدليل الذي يوجد فيه المقبس في بت سغيد لمجموعة مجموعة (تشمود g + s)، ثم سوف تكون مملوكة مأخذ لنفس المجموعة كما الدليل.
بعد إعداد ليفيستاتوس - إما عن طريق setup. sh أو يدويا - إعادة تشغيل ناجيوس. يجب أن يحدث أمران الآن: يتم إنشاء ملف المقبس. يظهر سجل ناجيوس أن الوحدة قد تم تحميلها:
2.3. خيارات nagios. cfg.
ليفستاتوس يفهم العديد من الخيارات، والتي يمكن أن تضاف إلى السطر بدءا من broker_module:
في ما يلي مثال لكيفية إضافة المعلمات:
3. استخدام ليفستاتوس.
وبمجرد إعداد وحدة ليفيستاتوس وتشغيلها، يمكنك استخدام مقبس أونيكس لاسترجاع بيانات الحالة المباشرة. كل لغة برمجة ذات صلة على لينكس لديها طريقة لفتح مثل هذا المقبس. وسوف تظهر كيفية الوصول إلى مأخذ مع قذيفة ومع بايثون. وتترك لغات البرمجة الأخرى كممارسة للقارئ.
3.1. الوصول إلى ليفستاتوس مع قذيفة.
مقبس أونيكس يشبه إلى حد كبير أنبوب اسمه، ولكن لديه اختلافات هامة: يمكنك قراءة وكتابة من وإلى ذلك (في حين أن أنبوب هو أحادي الاتجاه). لا يمكنك الوصول إليه مع صدى أو القط.
سفن ليفستاتوس مع أداة صغيرة تسمى ونيكسكات التي يمكن التواصل عبر مقبس أونيكس. يرسل جميع البيانات يقرأ من ستدين في مأخذ ويكتب جميع البيانات القادمة من مأخذ إلى ستدوت.
يظهر الأمر التالي كيفية إرسال أمر إلى المقبس واسترداد الإجابة - في هذه الحالة جدول جميع المضيفين:
إذا كنت تحصل على هذا الإخراج، كل شيء يعمل بشكل جيد وكنت قد ترغب في مواصلة القراءة مع الفصل ليفيستاتوس الاستعلام اللغة.
3.2. الوصول إلى ليفستاتوس مع بيثون.
الوصول من داخل بيثون لا يحتاج إلى أداة خارجية. يوضح المثال التالي كيفية إرسال استعلام، واسترداد الجواب وتحليله في جدول بيثون. بعد تثبيت check_mk تجد هذا البرنامج في الدليل / أسر / شير / دوك / check_mk:
4. لقل - لغة الاستعلام ليفيستاتوس.
لقل - وضوحا "ليكيل" كما هو الحال في "السائل" - هي لغة بسيطة لقول ليفيستاتوس ما البيانات التي تريد وكيف ينبغي تنسيقها. أنها تفعل الكثير من نفس سكل ولكن يفعل ذلك بطريقة أخرى، أبسط. ويعكس بناء الجملة (غير متوافق مع) هتب.
يتكون كل استعلام من: أمر يتكون من كلمة جيت واسم جدول. عدد تعسفي من خطوط رأسية تتألف من كلمة رئيسية ونقطتين وسيطات. خط فارغ أو نهاية الإرسال (أي يغلق العميل اتجاه إرسال المقبس)
جميع الكلمات الرئيسية بما في ذلك جيت حساسة لحالة الأحرف. يتم إنهاء الخطوط بواسطة سطر واحد (لا & لوت؛ كر & غ؛). النسخة الحالية من ليفيستاتوس تنفذ الجداول التالية: المضيفين - ناجيوس الخاص بك يستضيف الخدمات - خدمات ناجيوس الخاص بك، انضم مع جميع البيانات من المضيفين المضيفين - أنت ناجيوس هوستغروس سيرفيسغروس - أنت ناجيوس سيرفيسغروس كونتاكتغروس - أنت ناجيوس مجموعات الاتصال سيرفيسزبيغروب - جميع الخدمات مجمعة حسب الخدمة خدمات المجموعات التي يتم تجميعها من قبل المجموعات المضيفة هوستسبيغروب - كل مجموعة المضيفين من قبل مجموعات المضيف جهات الاتصال - أوامر الاتصالات ناجيوس الخاص بك - أوامر محددة ناجيوس الخاص بك تيمبيريودس - تعريفات الفترة الزمنية (الاسم الوحيد حاليا والاسم المستعار) مع بيانات من المضيفين والخدمات. تعليقات - كل المضيف وسجل تعليقات الخدمة - وصول شفاف إلى سجلات السجل ناجيوس (تشمل تلك المحفوظة) حالة تلك - الأداء العام ومعلومات الحالة. يحتوي هذا الجدول على مجموعة بيانات واحدة بالضبط. أعمدة - قائمة كاملة من جميع الجداول والأعمدة المتاحة عبر ليفستاتوس، بما في ذلك الوصف! ستاتهيست - 1.2.1i2 إحصاءات سلا للمضيفين والخدمات، جنبا إلى جنب مع البيانات من المضيفين والخدمات والسجل.
كما هو الحال في قاعدة بيانات سكل جميع الجداول تتكون من عدد من الأعمدة. إذا قمت باستعلام الجدول دون أي معلمات، يمكنك استرداد كافة الأعمدة المتاحة بترتيب أبجدي. يحتوي السطر الأول من الإجابة على أسماء الأعمدة. يرجى ملاحظة أن الأعمدة المتاحة ستتغير من الإصدار إلى الإصدار. وبالتالي يجب أن لا تعتمد على ترتيب معين من الأعمدة!
مثال: استرداد جميع جهات الاتصال:
4.1. تحديد الأعمدة التي سيتم استردادها.
عند كتابة تطبيق باستخدام ليفستاتوس، ربما تحتاج المعلومات فقط من الأعمدة المحددة. إضافة رأس الأعمدة لتحديد الأعمدة التي سيتم استردادها. وهذا يحدد أيضا ترتيب الأعمدة في الإجابة. المثال التالي يسترد فقط اسم الأعمدة واسم مستعار:
إذا كنت ترغب في اختبار هذا مع ونيكسكات، طريقة بسيطة هي وضع الاستعلام الخاص بك إلى استعلام ملف نصي وقراءة ذلك في استخدام & لوت؛ :
كما كنت قد لاحظت في هذا المثال: إذا كنت تستخدم الأعمدة: ثم لن يتم إخراج رؤوس الأعمدة. أنت لا تحتاج إليها - كما كنت قد حددت لهم أنفسكم. هذا يجعل تحليل أبسط.
4.2. المرشحات.
مفهوم مهم ل ليفستاتوس هو قدرته على تصفية البيانات بالنسبة لك. هذا ليس فقط أكثر ملاءمة من مجرد استرجاع جميع البيانات وتحديد الخطوط ذات الصلة نفسك. كما أنها أسرع بكثير. تذكر أن ليفستاتوس لديه إمكانية الوصول المباشر إلى كل من البيانات الداخلية ناجيوس 'ويمكن الوصول إليها بسرعة C.
تتم إضافة الفلاتر باستخدام فيلتر: هيدرس. يحتوي هذا الرأس على ثلاث حجج: اسم عمود، عامل تشغيل وقيمة مرجعية - كل ذلك مفصول بمسافات. قد تحتوي القيمة المرجعية - وهي القيمة الأخيرة في السطر - على مسافات. مثال:
هذا الاستعلام يحصل على كافة الخدمات مع الحالة الحالية 2 (حرجة). إذا أضفت المزيد فلتر: رؤوس، سترى فقط البيانات التي تمرير كل من الفلتر الخاص بك. المثال التالي ينتج جميع الخدمات الهامة التي هي حاليا ضمن فترة الإخطار:
تتوفر الشركات الثمانية التالية:
بعض الملاحظات: المشغلين.
4.3. مطابقة التعبير العادي.
4.4. قوائم المطابقة.
بعض الأعمدة لا تحتوي على أرقام أو نصوص، ولكن قوائم الكائنات. مثال على ذلك هو جهات الاتصال العمود من المضيفين أو الخدمات التي تحتوي على كافة جهات الاتصال المعينة إلى كائن البيانات. والمشغلون المتاحون في أعمدة قيم القامئة هم:
مثال: ارجع بعض المعلومات عن الخدمات حيث "هاري" هي إحدى جهات الاتصال المعينة:
مثال آخر: إعادة اسم جميع المضيفين الذين ليس لديهم الآباء:
هناك حالة خاصة عند إجراء التصفية على الأعضاء أو أعمدة members_with_state من جدول مجموعات الخدمة: يجب أن يكون للقيمة المطابقة تطابق اسم المضيف | وصف الخدمة .
4.5. قوائم السمات المطابقة.
الإصدار 1.1.4 من ليفيستاتوس يتيح لك الوصول إلى قائمة سمات معدلة من المضيفين والخدمات وجهات الاتصال. بهذه الطريقة يمكنك الاستعلام عن السمات التي تم تغييرها ديناميكيا من قبل المستخدم وبالتالي تختلف عن السمات التي تم تكوينها في ملفات الكائن ناجيوس.
تأتي هذه الأعمدة الجديدة في متغيرين: edit_attributes و edit_attributes_list. يخرج المتغير الأول عددا صحيحا يمثل تركيبة بيتية للأرقام الداخلية ناجيوس. ينتج المتغير الثاني قائمة بأسماء الخصائص، مثل notification_enabled أو active_checks_enabled. عند تعريف عامل تصفية، يتم التعامل مع كل من متغيرات العمود بالطريقة نفسها تماما، وكلاهما يسمح باستخدام رقم أو تمثيل قائمة مفصولة بفواصل.
المثال 1: البحث عن جميع المضيفين الذين لديهم سمات معدلة:
مثال 2: البحث عن المضيفين حيث تم تعطيل الإشعار بشكل فعال:
مثال 3: البحث عن المضيفين حيث تم إجراء فحوصات نشطة أو سلبية:
4.6. الجمع بين مرشحات مع و، أو ونفي.
يجب أن تمر كل مجموعة بيانات افتراضية في كل الفلاتر ليتم عرضها. بدلا من ذلك، يمكنك الجمع بين عدد من الفلاتر مع عملية منطقية "أو" باستخدام رأس أو:. يأخذ هذا الرأس عدد صحيح X كوسيطة ويجمع بين مرشحات X الأخيرة في فلتر جديد باستخدام عملية "أو". المثال التالي يختار جميع الخدمات التي هي في حالة 1 أو في حالة 3:
يعرض المثال التالي جميع الخدمات غير موافق والتي تكون ضمن وقت توقف مجدولة أو التي تكون على مضيف مع وقت توقف مجدول:
ومن الممكن أيضا الجمع بين المرشحات مع وتشغيل. هذا ضروري فقط إذا كنت ترغب في مجموعة المرشحات معا قبل "أو"-لهم. إذا، على سبيل المثال، كنت ترغب في الحصول على جميع الخدمات التي هي حاسمة والاعتراف أو موافق، وهذا هو كيفية القيام بذلك:
و: 2 - رأس يجمع بين المرشحين الأولين إلى مرشح واحد جديد، والذي هو ثم "أو" إد مع المرشح الثالث.
في الإصدار 1.1.11i2 رأس جديد نيجات: تم عرضه. وهذا ينفي منطقيا أحدث فلتر. يعرض المثال التالي جميع المضيفات التي لا تحتوي على اسم أو لا:
5. الإحصائيات والتهم.
5.1. لماذا العد؟
يحتوي سكل على عبارة "سيليكت كونت (*) فروم." والتي تحسب عدد الصفوف التي تطابق معايير معينة. احصائيات لقل: - Header يسمح شيء مماثل. وبالإضافة إلى ذلك فإنه يمكن استرداد العديد من التهم في وقت واحد.
إحصائيات: - Header لديه نفس التركيب كما تصفية: ولكن معنى آخر: بدلا من تصفية الكائنات التي تهمهم. في أقرب وقت واحد على الأقل احصائيات: رأس يستخدم، يتم عرض أية بيانات بعد الآن. بدلا من ذلك، يتم إخراج صف واحد من البيانات مع عمود واحد لكل إحصائيات:، مع توضيح عدد الصفوف المطابقة لمعاييرها.
المثال التالي يخرج أرقام الخدمات التي هي موافق، وارن، كريت أو أننوين:
يظهر مثال للإخراج على النحو التالي:
هل تريد تقييد الإخراج إلى الخدمات التي يتم تعيين جهة الاتصال هاري إليها؟ لا توجد مشكلة، فقط إضافة فلتر: رأس:
5.2. الجمع مع و / أو.
تماما مثل رؤوس التصفية، الإحصائيات - يمكن دمجها مع و / أو العمليات. المهم أن نعرف، أنها تشكل كومة الخاصة بهم. يمكنك الجمع بينهما مع ستاتساند و ستاتسور. في ما يلي استعلام أكثر تعقيدا إلى حد ما يقوم بمسح كافة الخدمات لنوافذ مجموعة الخدمات التي تقع ضمن فترة الإشعار ولا تكون ضمن مضيف أو توقف خدمة. وهو يحسب سبع تهم: عدد الخدمات مع الحالة الصلبة أوك عدد الخدمات غير المعترف بها في الحالة الصلبة تحذير عدد الخدمات المعترف بها في الحالة الصلبة تحذير عدد الخدمات غير المعترف بها في الحالة الصلبة الحرجة عدد الخدمات المعترف بها في الحالة الصلبة كريتيكال عدد الخدمات غير المعترف بها في حالة صعبة أننوين عدد الخدمات المعترف بها في حالة صعبة أننوين.
في الإصدار 1.1.11i2 رأس ستاتسنيغات الجديد: تم عرضه. فإنه لا يأخذ أي الحجج وينطق منطقيا أحدث احصائيات تصفية.
5.3. التجمع.
السماح ليفستاتوس العد البنود هو لطيف وسريع. ولكن في أمثلةنا حتى الآن كان الجواب يقتصر على سطر واحد من الأرقام لمجموعة محددة مسبقا من المرشحات. في بعض الحالات التي تريد الحصول على إحصاءات لكل كائن من مجموعة معينة. قد ترغب في عرض قائمة من المضيفين، ولكل من هذه المضيفين عدد الخدمات التي هي موافق، وارن، كريت أو أننوين.
في مثل هذه الحالات، يمكنك إضافة الأعمدة: رأس لطلب البحث. هناك فكرة بسيطة لكنها قوية وراء ذلك: يمكنك تحديد قائمة الأعمدة من الجدول الخاص بك. يتم حساب الإحصائيات وعرضها بشكل منفصل لكل مجموعة مختلفة من قيم هذه الأعمدة.
الاستعلام التالي بحساب عدد الخدمات في الولايات المختلفة لكل مضيف في نوافذ مجموعة المضيف:
يبدو الإخراج كما يلي:
كما ترون، تم إضافة عمود إضافي إلى الناتج الذي يحمل قيمة عمود المجموعة. في ما يلي مثال آخر يحسب إجمالي عدد الخدمات التي تم تجميعها بواسطة أمر التحقق (يكون تعبير التصفية الوهمية صحيحا دائما، لذا يتم حساب كل خدمة).
في ما يلي مثال لإخراج طلب البحث هذا:
مثال ثالث يوضح طريقة أخرى لحساب العدد الإجمالي للخدمات مجمعة حسب ولاياتها بدون رأس صريح لكل دولة:
في هذا المثال لم يكن أي من الخدمات في ولاية أننوين. وبالتالي لم يتم الاعتماد على تلك الدولة.
ملاحظة أخيرة حول تجميع: التنفيذ الحالي يسمح فقط الأعمدة من سلسلة أنواع أو في لاستخدامها لتجميع. كما أنك تقتصر على عمود مجموعة واحدة.
ملاحظة: قبل الإصدار 1.1.10 كان هناك رأس ستاتسغروبي: بدلا من الأعمدة:. يتم تجاهل هذا الرأس، مع أنه لا يزال يعمل.
6. سوم، مينيموم، ماكسيموم، أفيراج، ستاندارد ديفياتيون.
بدءا من الإصدار 1.1.2 ليفيستاتوس يدعم بعض العمليات الإحصائية الأساس. تسمح لك، على سبيل المثال، بالاستعلام عن متوسط ​​وقت تنفيذ الشيكات أو الانحراف المعياري لوقت استجابة الشيكات لجميع الشيكات.
هذه العمليات تستخدم واحدة من الكلمات الرئيسية سوم، مين، ماكس، أفغ، ستد، سومينف أو أفجينف. يعرض الاستعلام التالي الحد الأدنى والحد الأقصى ومتوسط ​​وقت تنفيذ الشيكات لجميع عمليات التحقق من الخدمة في حالة أوك:
كما هو الحال مع "عادي" احصائيات رؤوس، الإخراج يمكن تجميعها بواسطة عمود واحد، على سبيل المثال بواسطة host_name:
في الإصدار 1.1.13i1 قدمنا ​​وظائف تجميع سومينف و أفجينف. وهي تحسب مجموع أو متوسط ​​معكوس القيم. على سبيل المثال العكس من check_interval من الخدمة هو عدد المرات التي يتم فحصها في الدقيقة الواحدة. و سومينف على جميع الخدمات هو العدد الإجمالي للشيكات التي ينبغي تنفيذها في الدقيقة الواحدة، إذا لم يتم تأخير الشيكات.
6.1. بيانات الأداء.
اعتبارا من الإصدار 1.1.11i2، مك ليفيستاتوس الآن يدعم تجميع بيانات أداء ناجيوس. بيانات الأداء هي مخرجات معلومات إضافية بواسطة شيكات، منسقة كسلسلة مثل المستخدم = 6.934 ؛؛؛؛ نظام = 6.244 ؛؛؛؛ الانتظار = 0.890 ؛؛؛؛ . اذا قمت بتكوين احصائيات استعلام باستخدام سوم أو مين أو ماكس أو أفغ أو ستد على عدة خدمات مع بيانات أداء متوافقة، ستقوم ليفستاتوس بتجميع هذه القيم الآن في سلسلة بيانات أداء جديدة. انظر إلى الأمثلة التالية. أولا، الاستعلام عن خدمتين دون تجميع:
لنفترض أنه ينتج المخرجات التالية:
في ما يلي الاستعلام نفسه، ولكن تجميع البيانات باستخدام المتوسط:
وهذه هي النتيجة:
7. تنسيق الإخراج وترميز الأحرف.
ليفستاتوس يدعم تنسيقات الإخراج كسف، جسون وبيثون، مع كسف يجري الافتراضي.
7.1. كسف الإخراج.
إخراج كسف يأتي في اثنين من النكهات: كسف (صغيرة) و كسف (الأحرف الكبيرة). لأسباب التوافق إلى الوراء، البديل الأصغر هو الافتراضي، ولكن لديها عدد قليل من المراوغات. التوصية هي استخدام البديل الأحرف الكبيرة، وعندما كنت حقا بحاجة إلى مزيد من الهيكل في البيانات الخاصة بك. كنت أفضل حالا مع جسون أو بيثون.
كسف الإخراج (مكسورة)
يتم فصل مجموعات البيانات عن طريق لينفيدس (أسي 10)، يتم فصل الحقول بفواصل منقوطة (أسي 59)، يتم فصل عناصر القائمة (مثل في الأسماء) بفواصل (أسي 44) ويتم فصل مجموعات من اسم المضيف ووصف الخدمة بواسطة رمز الأنابيب (أسي 124).
من أجل تجنب المشاكل مع فاصل فاصل الحقول الافتراضي الذي يظهر في القيم (مثل بيانات الأداء)، من الممكن استبدال أحرف الفاصل برموز أخرى. ويتم ذلك بتحديد أربعة أعداد صحيحة بعد رأس الفواصل:. كل من هذه هي رمز أسي فاصل في عشري. الأرقام الأربعة تعني:
فاصل البيانات (الافتراضي هو 10: لينفيد) فاصل العمود (الافتراضي هو 59: فاصلة منقوطة) فاصل لقوائم مثل جهات الاتصال في جدول المضيفين (الافتراضي هو 44: فاصلة) فاصل المضيف والخدمات في قوائم الخدمة (الافتراضي هو 124: شريط عمودي)
حتى أنه من الممكن استخدام أحرف غير قابلة للطباعة كفاصلات. يستخدم المثال التالي وحدات البايت مع القيم 0 و 1 و 2 و 3 كفواصل:
كسف الإخراج.
هذا هو نسق كسف "الحقيقي" (انظر رك 4180) الذي يشبه المتغير الصغير أعلاه، ولكن مع الاقتباس الصحيح و كر / لف كفاصل مجموعة البيانات. بسبب الاقتباس، ليست هناك حاجة للفواصل: رأس، لذلك يتم تجاهل هذا التنسيق.
7.2. جسون الإخراج.
يمكنك الحصول على الإخراج بتنسيق جسون إذا قمت بإضافة رأس ملف أوتبوتفورمات: جسون كما في المثال التالي:
مثل كسف، جسون هو تنسيق يستند إلى نص، وهو رمز جافا سكريبت صالح. من أجل تجنب التكرار والحفاظ على النفقات العامة منخفضة قدر الإمكان، لا يتم تنسيق الإخراج كقائمة من الكائنات (مع أزواج مفتاح / قيمة)، ولكن كقائمة من القوائم (صفائف في جسون الكلام). هذا هو الشكل الموصى به بشكل عام، لأنه يجعل من السهل للغاية للتعامل مع البيانات المنظمة، و جسون محللون متاحة أساسا كل لغة البرمجة هناك.
7.3. بيثون الإخراج.
شكل بيثون مشابه جدا لتنسيق جسون، ولكن ليس 100٪ متوافق. هناك اختلاف بسيط في البادئات سلسلة وكيف يتم هروب الأحرف، وهذا يختلف حتى في بيثون 2 وبيثون 3. لذلك، يتم تقديم اثنين من الأشكال بيثونيك: الثعبان ل بيثون 2 و python3 ل، حسنا، بيثون 3. يمكنك تقييم مباشرة () الناتج بيثون، ولكن يكون على بينة من القضايا الأمنية المحتملة ثم. عند الشك، استخدم جسون و json. loads من وحدة جسون القياسية.
7.4. ترميز الأحرف.
ينتج ليفستاتوس في معظم الحالات من ملفات التكوين ناجيوس (تكوين الكائن). لا تفرض ناجيوس أي قيود على كيفية تشفير هذه الملفات (أوتف-8، لاتين-1، الخ). إذا قمت بتحديد إخراج كسف، ثم ليفستاتوس ببساطة بإرجاع البيانات كما هو وارد في ملفات التكوين - مع نفس الترميز.
عند استخدام جسون أو بيثون - ومع ذلك - الأحرف غير أسي تحتاج إلى هرب وترميز صحيح. حتى الإصدار 1.1.11i1، ليفيستاتوس تلقائيا بالكشف عن 2-بايت أوتف-8 متواليات ويفترض جميع الأحرف الأخرى غير أسي لتكون اللاتينية-1 ترميز. في حين أن هذا يعمل بشكل جيد للغات الغربية وإلى درجة معينة "بالكشف التلقائي" الترميز، فإنه لا يدعم لغات باستخدام أحرف أخرى ثم تلك المستخدمة في اللاتينية 1. حتى و اليورو؛ - Symbol لا يعمل.
اعتبارا من الإصدار 1.1.11i2، السلوك ليفيستاتوس هو شكلي مع خيار data_encoding والتخلف الافتراضي الآن لترميز أوتف-8. هناك ثلاثة إعدادات مختلفة صالحة:
7.5. رؤوس الأعمدة.
افتراضيا، إذا لم يكن هناك أعمدة-رأس في الاستعلام الخاص بك، مك ليفيستاتوس يعرض أسماء جميع الأعمدة كخط أول من الإخراج. مع رأس أوتبوتكولومنز يمكنك بشكل واضح تبديل رؤوس الأعمدة أو إيقاف تشغيله. سوف يتضمن الإخراج إلى الاستعلام التالي رؤوس الأعمدة:
7.6. الحد من عدد مجموعات البيانات.
ليميتس - header يسمح لك للحد من عدد من مجموعات البيانات التي يتم عرضها. منذ مك ليفيستاتوس حاليا لا يدعم الفرز، سيكون لديك للعيش مع ناجيوس الداخلية الفرز الطبيعي من الكائنات. يتم فرز المضيفين، على سبيل المثال، وفقا لأسماء المضيفين - كما هو الحال في سغيس القياسية. المثال التالي سوف ينتج فقط المضيفين العشرة الأولى:
يرجى ملاحظة أن الحد-رأس يتم تطبيقها أيضا عند القيام الإحصائيات. أنا لست متأكدا إذا كان هناك أي استخدام لذلك، ولكن هذا هو الطريقة التي يتصرف مك ليفيستاتوس. المثال التالي سيحسب عدد من المضيفات العشرة الأولى:
في حالة استخدام الفلاتر، الحد-رأس يحدد عدد مجموعات البيانات في الواقع يجري الإخراج. يقوم الاستعلام التالي بإخراج أول 10 مضيفات أسفل:
8. التفويض.
منذ الإصدار 1.1.3، ليفيستاتوس يدعم المطورين الملحق من خلال المساعدة على تنفيذ الترخيص. يمكنك أن تدع ليفستاتوس تقرر ما إذا كانت جهة اتصال معينة قد ترى بيانات أم لا. هذا هو بسيط جدا للاستخدام. كل ما عليك القيام به هو إضافة رأس أوثوسر إلى الاستعلام الخاص بك مع اسم ناجيوس الاتصال كوسيطة واحدة. إذا قمت بذلك، سوف ليفستاتوس فقط عرض البيانات التي الاسم هو جهة اتصال ل - إما مباشرة أو عن طريق مجموعة الاتصال. مثال:
في بعض الحالات سيكون من الممكن استبدال أوثوسر برأس تصفية. ولكن هذا لا يعمل (على وجه التحديد) في جميع الحالات.
8.1. ترتيب.
إذا كان الملحق الخاص بك يستخدم أوثوسر، المسؤول لديه طريقة لتكوين تفاصيل المصادقة عبر nagios. cfg - وبالتالي يمكن القيام بذلك بشكل موحد عبر جميع الإضافات باستخدام ليفستاتوس. تتوفر حاليا اثنين من خيارات التكوين. كلا يمكن تعيين إما إلى صارمة أو فضفاضة:
يرجى ملاحظة أن ناجيوس يجعل جميع الخدمات التي ليس لديها أي اتصال على الإطلاق ترث جميع جهات الاتصال من المضيف - بغض النظر عن ما إذا كان يتم تعيين هذا الخيار إلى صارمة أو فضفاضة.
8.2. الجداول التي تدعم أوثوسر.
الجداول التالية تدعم رأس أوثوسر (البعض الآخر تجاهلها ببساطة): هوستس، سيرفيسز، هوستغروس، سيرفيسغروب أند لوغ. ينطبق السجل - ملف أوثوسر فقط على إدخالات فئات السجل 1 (المضيف وتنبيهات الخدمة) و 3 (الإخطارات) و 4 (الشيكات السلبية). لا تتأثر جميع الفئات الأخرى.
8.3. محددات.
حاليا أوثوسر - header يتحكم فقط أي الصفوف من البيانات يتم إخراج وليس له تأثير على أعمدة القوائم مثل عمود المجموعات في خدمات الجدول. وهذا يعني أن هذا العمود يسرد أيضا مجموعات الخدمات التي قد لا تكون جهة الاتصال جهة اتصال لها. قد يتم تغيير هذا في نسخة مستقبلية من ليفيستاتوس.
بدءا من الإصدار 1.1.3 ليفيستاتوس لديه ميزة جديدة ولا تزال تجريبية: في انتظار. الانتظار يسمح لمطوري أدونز تأخير تنفيذ الاستعلام حتى يصبح شرط معين صحيح أو حدث ناجيوس يحدث. وهذا يسمح بتنفيذ فئة جديدة من الميزات في أدونز، على سبيل المثال:
تحديث فوري لعرض الحالة حالما يتم تغيير حالة أي تغيير أو تغيير واحد من عناصر ناجيوس. شريط سجل يظهر رسائل سجل جديدة على الفور. زر إجراء لإعادة جدولة الاختيار التالي من الخدمة التي تعرض الخدمة ليس أقرب من بعد أن تم التحقق.
كل ما يمكن تنفيذه دون الاقتراع - وبطريقة بسيطة جدا. كل ما عليك فعله هو تعويض بعض رؤوس طلبات البحث الجديدة:
يسمح بتحديد رؤوس حالة متعددة: يتم دمج كل الشروط مع منطقية و (كما هو الحال مع رأس التصفية).
تتوفر المشغلات التالية ل ويتريجر - Header: تحقق - تم تنفيذ تحقق خدمة أو مضيف الحالة - حالة المضيف أو الخدمة قد تغير السجل - تم تسجيل رسالة جديدة في nagios. log وقت التوقف - كان وقت التوقف تعيين أو إزالة تعليق - تم تعيين تعليق أو إزالة الأمر - تم تنفيذ أمر خارجي برنامج - تغيير في إعداد برنامج عالمي، مثل enable_notifications جميع - أي من الأحداث العليا يحدث (وهذا هو الافتراضي)
9.1. أمثلة.
استرداد رسائل السجل منذ طابع زمني معين، ولكن انتظر حتى تظهر رسالة سجل جديدة واحدة على الأقل:
ونفس الشيء، ولكن لا تنتظر أطول من 2 ثانية:
استرداد البيانات الكاملة حول xabc123 المضيف، ولكن الانتظار حتى حالته أمر بالغ الأهمية:
الحصول على بيانات حول الخدمة الذاكرة المستخدمة على xabc123 المضيف بمجرد أن يتم التحقق من بعض الوقت بعد 1265062900:
10. تعويض الاختلافات الزمنية.
عند القيام بمراقبة موزعة متعددة الجنسيات مع ليفستاتوس قد تضطر للتعامل مع الحالات التي خوادم الرصد الخاصة بك تعمل في مناطق زمنية مختلفة. في الإعداد العادي كل خوادم لديها نفس الوقت النظام ولكن مناطق زمنية تكوين مختلفة. يمكنك التحقق من ذلك عن طريق الاتصال على كل خادم الرصد:
يجب أن ينتج هذا الأمر نفس القيمة على كافة الملقمات. إذا لم يكن الأمر كذلك، فربما قمت بتعيين النظام على منطقة زمنية خاطئة. مك ليفيستاتوس يمكن أن تساعد على تعويض الفرق الزمني في مثل هذه الحالات. إذا أضفت الرأس.
إلى الاستعلام الخاص بك مع التوقيت المحلي الحالي (الناتج من التاريخ +٪ s) كوسيطة، ليفيستاتوس سوف يقارن الوقت المحلي ضد ذلك المتصل وتحويل جميع الطوابع الزمنية وفقا لذلك.
يرجى ملاحظة أن ليفستاتوس يفترض أن الفرق في الوقت ليس بسبب عدم دقة على مدار الساعة ولكن نظرا للاختلافات المنطقة الزمنية. وسيتم تقريب وقت الدلتا المحسوب للتعويض إلى أقرب نصف ساعة.
11. رأس الاستجابة.
إذا كان طلبك غير صالح أو يظهر خطأ آخر، تتم طباعة رسالة إلى سجل ناجيوس. إذا كنت تريد كتابة واجهة برمجة تطبيقات تعرض رسالة خطأ إلى المستخدم، فستحتاج إلى معلومات حول الأخطاء كجزء من الاستجابة.
يمكنك الحصول على مثل هذا السلوك باستخدام رأس استجابة ريسبونزيدر. ويمكن تعيين إلى إيقاف (الافتراضي) أو ثابتة 16:
ويمكن تنفيذ أنواع أخرى من رؤوس الاستجابة في الإصدارات المستقبلية. و ثابت 16-رأس لديه ميزة أنه هو بالضبط 16 بايت طويلة. وهذا يجعل من السهل برمجة أبي. يمكنك ببساطة قراءة في 16 بايت وتحتاج لا تفحص عن خط جديد أو الاشياء من هذا القبيل. في ما يلي مثال لدورة كاملة مع تنشيط رؤوس الردود:
ويكون لرأس استجابة الثابت 16 النسق التالي: البايتات 1-3: شفرة الحالة البايتة 4: مسافة واحدة البايتة 5-15: طول الاستجابة كرقم صحيح مشفر أسي، مبطن بمسافات البايتة 16: حرف سطحي (أسي) 10)
هذه هي القيم المحتملة لرمز الحالة:
يحتوي الرد على البيانات التي تم الاستعلام عنها فقط إذا كان رمز الحالة 200. في جميع الحالات الأخرى يحتوي الرد على رسالة الخطأ. في هذه الحالة يعطي طول الحقل طول رسالة الخطأ بما في ذلك لينيفيد زائدة. لم يتم ترميز جسون، حتى إذا قمت بتعيين ذلك في أوتبوردفورمات - header.
12. إبقاء على قيد الحياة (اتصالات مستمرة)
مك ليفيستاتوس يسمح لك للحفاظ على فتح اتصال وإعادة استخدامه لعدة طلبات. أطلب القيام بذلك تحتاج إلى إضافة الرأس التالي:
ستبقى ليفستاتوس فتح الاتصال بعد إرسال ردها وانتظر الاستعلام الجديد في هذه الحالة. وربما كنت أيضا تفعيل رأس استجابة في هذه الحالة، لأن هذا فقط يسمح لك لتحديد بالضبط طول الاستجابة (دون كيباليف يمكنك ببساطة قراءة حتى نهاية الملف).
يرجى ملاحظة أن الحفاظ على اتصال يحتل بشكل دائم الموارد داخل عملية ناجيوس. في الإصدار الحالي ليفستاتوس يقتصر على عشر اتصالات متوازية مستمرة. وهذا يختلف عن الطريقة التي يتم بها التعامل مع اتصالات قاعدة البيانات المستمرة.
الطريقة المقترحة لاستخدام الاتصالات المستمرة في تطبيقات الويب هي إبقاء الاتصال مفتوحا فقط أثناء الطلب الحالي وإغلاقه بعد عرض صفحة النتائج الكاملة. The reason is that bringing up a database connection is a much more costly operation than connecting to MK Livestatus.
13. Access to Logfiles.
Since version 1.1.1 Livestatus provides transparent access to your Nagios logfiles, i. e. nagios. log and the rotated files in archives (you might have defined an alternative directory in nagios. cfg). Livestatus keeps an index over all log files and remembers which period of time is kept in which log file. Please note that Livestatus does not depend on the name of the log files (while Nagios does). This way Livestatus has no problem if the log file rotation interval is changed.
The Livestatus table log is your access to the logfiles. Every log message is represented by one row in that table.
13.1. Performance issues.
If your monitoring system is running for a couple of years, the number of log files and entries can get very large. Each Livestatus query to the table log has the potential of scanning all historic files (although an in-memory cache tries to avoid reading files again and again). It is thus crucial that you use Filter: in order to restrict:
The time interval The log classes in question.
If you set no filter on the column time , then all logfiles will be loaded - regardless of other filters you might have set.
Setting a filter on the column class restricts the types of messages loaded from disk. The following classes are available:
0 - All messages not in any other class 1 - host and service alerts 2 - important program events (program start, etc.) 3 - notifications 4 - passive checks 5 - external commands 6 - initial or current state entries 7 - program state change.
14. RRD Files of PNP4Nagios.
New in 1.1.9i3 : In order to improve the integration between Multisite and PNP4Nagios, Livestatus introduces the new column pnpgraph_present in the tables hosts and services (and all other tables containing host_ or service_ columns). That column can have three possible values:
Livestatus cannot detect the base directory to your RRD files automatically, so you need to configure it with the module option pnp_path :
In order to determine Livestatus the availability of the PNP graph it checks for the existance of PNPs. xml file.
A note for OMD users: OMD automatically configures this option correctly in etc/mk-livestatus/nagios. cfg . You need at least a daily snapshot of 2018-12-17 or later for using the new feature.
15. Expansion of macros.
Nagios allows you to embed macros within your configuration. For example it is usual to embed $HOSTNAME$ and $SERVICEDESC$ into your action_url or notes_url when configuring links to a graphing tool.
As of version 1.1.1 Livestatus supports expansion of macros in several columns of the table hosts and services . Those columns - for example notes_url_expanded - bear the same name as the unexpanded columns but with _expanded suffixed.
Since macro expansion is very complex in Nagios. And unfortunately the Nagios code for that is not thread safe, so Livestatus has its own implementation of macros, which does not support all features of Nagios, but (nearly) all that are needed for visualization addons. Livestatus supports the following macros:
for hosts and services: HOSTNAME , HOSTDISPLAYNAME , HOSTALIAS , HOSTADDRESS , HOSTOUTPUT , LONGHOSTOUTPUT , HOSTPERFDATA , HOSTCHECKCOMMAND for services: SERVICEDESC , SERVICEDISPLAYNAME , SERVICEOUTPUT , LONGSERVICEOUTPUT , SERVICEPERFDATA , SERVICECHECKCOMMAND all custom macros on hosts and services (beginning with _HOST or _SERVICE ) all $USER. $ macros.
16. Remote access to Livestatus via SSH or xinetd.
16.1. Livestatus via SSH.
Livestatus current does not provide a TCP socket. Another (and more secure) way for remote accessing the unix socket is using SSH. The following example sends a query via SSH. The only priviledge the remote user needs, is write access to the unix socket:
16.2. Livestatus via xinetd.
Using xinetd and unixcat you can bind the socket of Livestatus to a TCP socket. Here is an example configuration for xinetd:
You can access your socket for example with netcat :
17. Timeouts.
In version 1.1.7i3 the handling of timeouts has changed. There are now two configurable timeouts which protect Livestatus from broken clients hanging on the line for ever (remember that the maximum number of parallel connections is configurable but limited):
idle_timeout - Limits the time Livestatus waits for a (the next) query query_timeout - Limits the time a query needs to be read.
A Livestatus connection has two states: either Livestatus is waiting for a query. This is the case just after the client has connected, but also in KeepAlive - mode after the response has been sent. The client has now at most idle_timeout ms for starting the next query. The default is set to 300000 (300 seconds, i. e. 5 minutes). If a client is idle for more then that, Livestatus simply closes the connection.
As soon as the first byte of a query has been read, Livestatus enters the state "reading query" and uses a much shorter timeout: the query_timeout . Its default value is 10000 (10 secs). If the client does not complete the query within this time, the client is regarded dead and the connection is closed.
Both timeout values can be configured by Nagios module options in nagios. cfg . A timeout can be disable by setting its value to 0 . But be warned: Broken clients can hang connections for ever and thus block Livestatus threads.
18. Sending commands via Livestatus.
MK Livestatus supports sending Nagios commands. This is very similar to the Nagios command pipe, but very useful for accessing a Nagios instance via a remote connection.
You send commands via the basic request COMMAND followed by a space and the command line in exactly the same syntax as needed for the Nagios pipe. No further header fields are required nor allowed.
Livestatus keeps the connection open after a command and waits for further commands or GET - requests. It behaves like GET with KeepAlive: set to yes . That way you can send a bunch of commands in one connection - just as with the pipe. Here is an example of sending a command from the shell via unicat :
Just as with GET , a query is terminated either by closing the connection or by sending a newline. COMMAND automatically implies keep alive and behave like GET when KeepAlive is set to on . That way you can mix GET and COMMAND quries in one connection.
19. Stability and Performance.
19.1. Stability.
While early versions of MK Livestatus experienced some stability issues - not unusual for evolving software - nowadays it can be considered rock solid. There are no known problems with performance, crashes or a hanging Nagios, as long as two important requirements are fullfilled: Environment macros have to be disabled in nagios. cfg . This is done with:
19.2. أداء.
Livestatus behaves with respect to your CPU and disk ressources. It doesn't do any disk IO at all, in fact - as long as the table log is not accessed, which needs read access to the Nagios' log files. CPU is only consumed during actual and queries and even for large queries we rather speek of micro seconds then of milli seconds of CPU usage. Furthermore, Livestatus does not block Nagios during the execution of a query but is running totally in parallel - and scales to all available CPU cores if neccessary. 1.1.9i3 Timeperiod transitions">
20. 1.1.9i3 Timeperiod transitions.
Version 1.1.9i3 introduces a new little feature, that does not really have something to do with status queries but is very helpful for creating availability reports and was easy to implement in Livestatus (due to its timeperiod cache).
Each time a timeperiod changes from active to not active or vice versa, an entry in the Nagios logfile is being created. At start of Nagios the initial states of all timeperiods are also logged. This looks like this:
When a transition occurs one line is logged (here the state changed from 1 (in) to 0 (out).
With that information, it is later possible to determine, which timeperiods were active when an alert happened. That way you can make availability reports reflect only certain time periods.
21. Host and Service Availability.
21.1. المقدمة.
Version 1.2.1i2 introduces the new table statehist which supports availability queries - providing statistical information for hosts and service. Beside the state information, this table returns duration information regarding the length of the state. In addition the duration percentage in respect to the query timeframe can be returned.
Each change creates an output line with the respective duration. Additional columns show the part (percentage) of this duration in comparison to the queried timeframe. To get the overall percentage of a specific state you can use the Stats: header to accumulate the percentage fields of multiple lines.
21.2. Absence of host and services.
To identify the absence of host and services within the queried timeperiod correctly it is necessary to set the following parameter.
Setting this parameter to 1 results that the initial state of each host and service is logged during the programs startup. By evaluating each startup it is possible to detect if a host or service is no longer monitored by the system. It is even possible to detect if this host or service was temporarily removed from monitoring for a specific time. The absence of a host or service is reflected in the output line within the state column as -1 (UNMONITORED)
The setting log_initial_states=1 is the default parameter as of version 1.2.1i2.
Disabling this parameter lead to less logfile entries on the programs startup, but limits the correct detection of the UNMONITORED state.
21.3. Table statehist.
Querying the table statehist results in an output which shows the a hosts/services states as mentioned above and in addition how long this host/service resided in this state.
A query always requires a filter for the start time. Otherwise livestatus would parse all available logfiles from the beginning, which might add up to several hundred megabytes.
Outputs a list where the state of this service has changed joined with the duration information.
By using the Stats: header these lines can be accumulated and allows the output of distinct stats duration and their duration_part in respect to the queried timeframe.
Using the columns duration_part_ok, duration_part_warning, duration_part_critical allows to output the entire state information within a single line.
Converting the part values into percentages the SLA information for this service is 70.1% OK 3.8% WARNING 26.1% CRITICAL.

تكامل العملات الأجنبية أويون.
فس بارا فوركس مجانا.
خيارات وسيط الحدث ناجيوس.
يتكون ستاتوسنجين من جزأين: وحدة وسيط الحدث توفير بيانات الحدث وتطبيق فب التي يعالجها. يتم تحميل وسيط الحدث في جوهر نيمون والمكبات التكوين وبيانات الحدث على سبيل المثال، والتغيرات الدولة، نتائج فحص الخدمة أو بيانات الإخطار في محرك الطابور جيرمان. كل الأحداث البيانات المشفرة كجسون الكائنات لتبسيط تطوير التطبيقات. ويستند تطبيق فب على إطار كاكيفب ويحفظ البيانات من وحدة وسيط في قاعدة بيانات ميسكل. كما تعلمون هناك حل وسيط آخر معروف للاتصال نيمون مع قاعدة بيانات ميسكل، فلماذا يجب استخدام ستاتينجينجين؟ اسمحوا لي أن تظهر لك بعض مزايا ستاتوسنجين: نظرا لوضع إرث كل البرامج التي تعمل وسيط وسيط معروف حل آخر، وسوف تعمل مع ستاتوسنجين من خارج منطقة الجزاء! ستاتوسينجين يوفر لك كامل أوتف-8 التكامل وليس لديه مشاكل مع أحرف البايت مزدوجة انها مكتوبة في فب حتى تتمكن من السهل حقا بقع تطوير أو ما تحتاجه من أي وقت مضى جميع التعليمات البرمجية مفتوحة ويمكنك المساهمة في المشروع عن طريق جيثب ستاتوسنجين مصنوع للوسيط الكبير ولا تتطلب معلمات نواة غريبة يتم كتابة وحدة وسيط فقط في C C كود صغير إق أقل سيغفولتس يمكنك إلغاء تثبيت أو ترقية خيارات خادم ميسكل إيقاف الرصد الخاص بك كل لغة قادرة على التعامل مع ميسكل ستاتوسينجين الحدث قادرة على معالجة بيانات الأداء الخاص بك وكذلك ستاتوسينجين هو أكثر من مجرد نيمون بسيط إلى بوابة الخلية. هذا الحدث طريقة واحدة فقط لاستخدام هذا الحل. وحدة وسيط جلب كل ما تحتاجه من جوهر نيمون باعتبارها سلسلة جسون. يمكنك البدء في تطوير العميل الخاص بك أن يفعل ما تريد من أي وقت مضى مع هذه البيانات. تم تطوير ستاتوسنجين ل نيمون ويجب أن تعمل مع ناجيوس 4 كذلك. لا يوجد دعم لخيارات ناجيوس إذا كنت تريد ناجيوس ترحيل إلى نيمون تحقق من دليل الهجرة الرسمي. وحدة ستاتوسنجين وسيط ستاتنجين. كل حدث داخل نيمون يؤدي وظائف رد داخل ستاتينجينجين. تتم معالجة الخيارات بواسطة ستاتنجين. على الجانب ناجيوس ستاتوسنجينيليغاسيشيل يقرأ البيانات من خادم الوظائف و ناغيوس مع عمليات عامل مختلفة. كل عامل يعالج طابور واحد أو أكثر ويكتب البيانات في قاعدة البيانات. يتم كتابة هذا الجزء في فب لذلك الكثير من الناس يمكن تعديل هذا بسهولة إذا لزم الأمر. لا تقلق، ناجيوس سريع بما فيه الكفاية لإنجاز هذه المهمة: نظرا لخادم الوظيفة جيرمان يمكنك إلغاء تثبيت أو ترقية أو ديستروي أو ما تريد القيام به مع خيارات خادم ميسكل الخاص بك الرصد سوف لا تزال تعمل، طالما ناجيوس خادم الوظائف قيد التشغيل! إذا كنت مهتما في الصف بيانات الحدث نيمون ولكن كنت لا تريد حفظ البيانات في قاعدة بيانات يمكنك ببساطة تطوير عامل الخاصة بك. تدعم مكتبة جيرمان الكثير من لغات البرمجة المختلفة. ويستند الاتصالات على البروتوكولات القياسية بحيث كافة خيارات البيانات جسون ترميز. قد تكون هذه الخيارات جزء مثيرة للاهتمام بالنسبة لك الخيارات التي تريد تثبيت الحدث على نظام تشغيل مختلف عن وسيط تبحث عن أوبونتو أو إصدار ديبيان أخرى؟ انتقل إلى أنظمة التشغيل المعتمدة. الحزم التي تحتاج إلى تثبيت خيارات محاولة استخدام حزمة ناجيوس الخاص بك في كثير من الأحيان ممكن: الاشياء جيرمان ليس في المستودع الخاص بك؟ لا وسيط، تثبيته باليد: قم بتحميل ملحق فب من جيرمان من هتب: كومبيل ستاتوسنجين من المصدر: راجع مستودع التخزين من هتبس: يمكنك تثبيت ستاتوسنجين على أي نظام تشغيل لينوكس. اقرأ دليل التثبيت المتقدم للحصول على مزيد من المعلومات. أنظمة التشغيل المدعومة ل ستاتوسنجين 1. أنظمة التشغيل المدعومة ل ستاتوسنجين 2. "الوضع القديم" من ستاتوسنجين يعمل تماما بنفس الطريقة مثل هذا ناجيوس المشتركة. مع "وضع ليغاسي" ستاتونجين متوافق مع أدوات مثل ناغفيس، أوفيتكوكبيت وغيرها من التطبيقات القائمة على ندو. يرجى خيارات الرعاية من نظام التخزين الخاص بك، إذا قمت بزيادة عدد العمال! وسيط افتراضي سوف ستاتسينجين الحدث وسيط وحدة كتابة كل بيانات الحدث إلى خادم وظيفة جيرمان. إلى الحدث واحد أو أكثر من خيارات وسيط، فقط إضافتها في التكوين الخاص بك الرصد: هذه هي قائمة من جميع الخيارات وسيط المتاحة: تعطيل هذا إذا كنت تتلقى حدث من الشيكات السلبية. لذلك لقد زادت هذه القيمة، والحدث خادم وظيفة جيرمان مرة أخرى. تمكين خادم وظيفة جيرمان إند إينيت إنفو معلومات أوليميت - n وإعادة تشغيل: ستاتوسينجين يتطلب أن وسيط خادم ميسكل و جيرمان-جوب-سيرفر قيد التشغيل، قبل أن تبدأ. الرجاء التأكد من تعيين أمر التمهيد بشكل صحيح. لوحدة وسيط الحدث ستايتينجين. يوضح هذا الدليل كيف يمكنك تثبيت ستاتوسنجين مع PHP7. تم اختبار هذا التوجيه على أوبونتو بعض ملحقات الحدث مفقودة في مدير الحزمة وتحتاج إلى تجميعها وتثبيتها يدويا. بسبب هذه الحقيقة ستاتوسينجين قد لا تعمل مستقرة كما في PHP5! دعونا نبدأ مع تثبيت أساسيات فب 7 و ستاتوسنجين أبت الحصول على تثبيت ميسكل خادم جيرمان-العمل-الخادم ليبيرمان-ديف جيرمان أدوات أويد-ديف فب-جيرمان فب-كلي فب-ديف ليبسون-c-ديف مانباجيس-ديف بناء الأساسية libglib2. إذا كنت ترغب في استخدام ستاتوسنجين ويب واجهة كذلك، تحتاج إلى تثبيت Apache2 أبت-جيت تثبيت apache2 libapache2-مود-فب. تثبيت ملحق فب-جيرمان ل PHP7 أبت-جيت إنستال جيت ليبجيرمان-ديف جيت استنساخ هتبس: تحديث مخطط قاعدة البيانات. بدء ستاتوسينجين بدء تشغيل ستاتينجينجين. إذا كنت أبدا تثبيت النيمون يدويا، وربما واجهت بعض القضايا. هذا كيف قليلا سوف تظهر لك، وكيفية تثبيت نيمون 1. الإضافات الرصد هي الإضافات الأساسية يجب تثبيت على النظام الخاص بك. المكونات الإضافية الرصد لديها الكثير من المتطلبات لتجميع كافة الإضافات المتاحة. في هذه الحالة فقط عدد قليل من الإضافات الأساسية كافية. إذا كنت ترغب في تجميع كافة الإضافات، تحقق من المتطلبات. بدلا من ذلك الحدث تثبيت مراقبة ناجيوس باستخدام مدير الحزمة. ناجيوس، ندوتيلز وسيط شعار ناجيوس هي علامات تجارية، سيرفيسيماركس، العلامات التجارية الحدث أو سيرفيسيماركس المسجلة المملوكة من قبل ناجيوس الشركات، ليك. ناجيوس العلامات التجارية الأخرى، سيرفيسماركس، والعلامات التجارية المسجلة، وسيط مسجل هي ملك لأصحابها s. جميع العلامات التجارية الأخرى هي ملك لأصحابها ناجيوس. قد تكون أسماء المنتجات أو الشركات الأخرى المذكورة علامات تجارية أو أسماء ناجيوس لمالكها المعني. الوثائق ما هو ستاتوسينجين؟ كيف يعمل ستاتسنجين؟ كل الخيارات الحدث التعامل معها من قبل قائمة الانتظار الخاصة بها. مثال على سبيل المثال، كنت ترغب في حفظ جميع عناوين إب الخاصة بك رصدها في ملف نصي، ستاتيشنجين سيوفر يومك مثل هذا الوسيط سبيل المثال. ما هو "الوضع القديم"؟ كان هناك خطأ حدث في ستاتوسنجين سيتم تحديث جدول سيرفيسشيكس ومعالجة الرسوم البيانية المعلومات البيانات ناجيوس. إذا تم تعطيله، لن يحصل جدول الخيارات 'ستاتهيستوري' للمضيفين والخدمات على أي حدث بعد الآن. إذا تم تعطيله، لا يتم حفظ خيارات الأوامر الخارجية إلى قاعدة البيانات. سيتم حفظ رسالة الاعترافات وسيط في قاعدة البيانات بعد الآن. لن يتم حفظ الجدول فلافينغهيستوري بعد الآن. سوف المعلومات التوقف يكون الحدث في قاعدة البيانات بعد الآن. سيتم حفظ المعلومات إعلام في قاعدة البيانات بعد الآن. معلومات عن عملية تشغيل نيمون الحالية. سيتم تحديث كل ن ثواني. الطريقة التي تم استخدامها لإرسال أمر إعلام الإخطار. إذا معطل، لن يتم حفظ جدول الكائنات بعد الآن! يمكنك استخدام هذا كبديل لأوامر أوشب الكلاسيكية. يمكنك استخدام هذا كبديل ل أوجي ناجيوس الكلاسيكية. كيفية تعيين الحد: كيفية تحديث ستاتوسنجين إلى الإصدار الجديد؟ شوكة لي على جيثب.
؛ فريليز أوتوماتيون 7 - تمكين وسيط الحدث.
5 أفكار على & لدكو؛ خيارات وسيط الحدث ناجيوس & رديقو؛
النمط هو اللحاق بالقارئ، وسحبه إلى تياره النعاس.
وزن الشحن: 8.3 أوقية (عرض أسعار الشحن والسياسات).
مزيج الألوان من لوحة القيادة والمواضيع الفردية الخاصة بك لإضافة لمسة من شخصيتك - إدارة الواجبات المنزلية لم يكن هذا متعة.
فبين عامي 1987 و 1991، انخفض الاستهلاك العالمي من مركبات الكربون الكلورية فلورية في الواقع.
كانت إليزابيث مع وحدتها مسؤولة عن رفاهية وتعافي الأطفال بشكل رئيسي خلال تلك الفترة.

Event_broker_options

All times are UTC - 5 hours.
nagios refuse to start with event_broker_options=-1.
Joined: Thu Jun 14, 2007 1:58 am.
I'm french so my english isn't very clear but I hope you can understand me.
All times are UTC - 5 hours.
من هو على الانترنت.
Users browsing this forum: No registered users and 0 guests.
You cannot reply to topics in this forum.
You cannot edit your posts in this forum.
You cannot delete your posts in this forum.
You cannot post attachments in this forum.
Protected by Anti-Spam ACP Powered by phpBB © 2000, 2002, 2005, 2007 phpBB Group.

Main Configuration File Options.
When creating and/or editing configuration files, keep the following in mind:
Lines that start with a '#' character are taken to be comments and are not processed Variables names must begin at the start of the line - no white space is allowed before the name Variable names are case-sensitive.
Tip: A sample main configuration file ( /usr/local/nagios/etc/nagios. cfg ) is installed for you when you follow the quickstart installation guide.
The main configuration file is usually named nagios. cfg and located in the /usr/local/nagios/etc/ directory.
Below you will find descriptions of each main Nagios configuration file option.
This variable specifies where Nagios should create its main log file. This should be the first variable that you define in your configuration file, as Nagios will try to write errors that it finds in the rest of your configuration data to this file. If you have log rotation enabled, this file will automatically be rotated every hour, day, week, or month.
This directive is used to specify an object configuration file containing object definitions that Nagios should use for monitoring. Object configuration files contain definitions for hosts, host groups, contacts, contact groups, services, commands, etc. You can seperate your configuration information into several files and specify multiple cfg_file= statements to have each of them processed.
This directive is used to specify a directory which contains object configuration files that Nagios should use for monitoring. All files in the directory with a. cfg extension are processed as object config files. Additionally, Nagios will recursively process all config files in subdirectories of the directory you specify here. You can seperate your configuration files into different directories and specify multiple cfg_dir= statements to have all config files in each directory processed.
This directive is used to specify a file in which a cached copy of object definitions should be stored. The cache file is (re)created every time Nagios is (re)started and is used by the CGIs. It is intended to speed up config file caching in the CGIs and allow you to edit the source object config files while Nagios is running without affecting the output displayed in the CGIs.
This directive is used to specify a file in which a pre-processed, pre-cached copy of object definitions should be stored. This file can be used to drastically improve startup times in large/complex Nagios installations. Read more information on how to speed up start times here.
This is used to specify an optional resource file that can contain $USERn$ macro definitions. $USERn$ macros are useful for storing usernames, passwords, and items commonly used in command definitions (like directory paths). The CGIs will not attempt to read resource files, so you can set restrictive permissions (600 or 660) on them to protect sensitive information. You can include multiple resource files by adding multiple resource_file statements to the main config file - Nagios will process them all. See the sample resource. cfg file in the sample-config/ subdirectory of the Nagios distribution for an example of how to define $USERn$ macros.
This is a temporary file that Nagios periodically creates to use when updating comment data, status data, etc. The file is deleted when it is no longer needed.
This is a directory that Nagios can use as scratch space for creating temporary files used during the monitoring process. You should run tmpwatch , or a similiar utility, on this directory occassionally to delete files older than 24 hours.
This is the file that Nagios uses to store the current status, comment, and downtime information. This file is used by the CGIs so that current monitoring status can be reported via a web interface. The CGIs must have read access to this file in order to function properly. This file is deleted every time Nagios stops and recreated when it starts.
This setting determines how often (in seconds) that Nagios will update status data in the status file. The minimum update interval is 1 second.
This is used to set the effective user that the Nagios process should run as. After initial program startup and before starting to monitor anything, Nagios will drop its effective privileges and run as this user. You may specify either a username or a UID.
This is used to set the effective group that the Nagios process should run as. After initial program startup and before starting to monitor anything, Nagios will drop its effective privileges and run as this group. You may specify either a groupname or a GID.
This option determines whether or not Nagios will send out notifications when it initially (re)starts. If this option is disabled, Nagios will not send out notifications for any host or service. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Disable notifications 1 = Enable notifications (default)
This option determines whether or not Nagios will execute service checks when it initially (re)starts. If this option is disabled, Nagios will not actively execute any service checks and will remain in a sort of "sleep" mode (it can still accept passive checks unless you've disabled them). This option is most often used when configuring backup monitoring servers, as described in the documentation on redundancy, or when setting up a distributed monitoring environment. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Don't execute service checks 1 = Execute service checks (default)
This option determines whether or not Nagios will accept passive service checks when it initially (re)starts. If this option is disabled, Nagios will not accept any passive service checks. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Don't accept passive service checks 1 = Accept passive service checks (default)
This option determines whether or not Nagios will execute on-demand and regularly scheduled host checks when it initially (re)starts. If this option is disabled, Nagios will not actively execute any host checks, although it can still accept passive host checks unless you've disabled them). This option is most often used when configuring backup monitoring servers, as described in the documentation on redundancy, or when setting up a distributed monitoring environment. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Don't execute host checks 1 = Execute host checks (default)
This option determines whether or not Nagios will accept passive host checks when it initially (re)starts. If this option is disabled, Nagios will not accept any passive host checks. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Don't accept passive host checks 1 = Accept passive host checks (default)
This option determines whether or not Nagios will run event handlers when it initially (re)starts. If this option is disabled, Nagios will not run any host or service event handlers. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface. Values are as follows:
0 = Disable event handlers 1 = Enable event handlers (default)
This is the rotation method that you would like Nagios to use for your log file. Values are as follows:
n = None (don't rotate the log - this is the default) h = Hourly (rotate the log at the top of each hour) d = Daily (rotate the log at midnight each day) w = Weekly (rotate the log at midnight on Saturday) m = Monthly (rotate the log at midnight on the last day of the month)
This is the directory where Nagios should place log files that have been rotated. This option is ignored if you choose to not use the log rotation functionality.
This option determines whether or not Nagios will check the command file for commands that should be executed. This option must be enabled if you plan on using the command CGI to issue commands via the web interface. More information on external commands can be found here.
0 = Don't check external commands 1 = Check external commands (default)
If you specify a number with an "s" appended to it (i. e. 30s), this is the number of seconds to wait between external command checks. If you leave off the "s", this is the number of "time units" to wait between external command checks. Unless you've changed the interval_length value (as defined below) from the default value of 60, this number will mean minutes.
Note: By setting this value to -1 , Nagios will check for external commands as often as possible. Each time Nagios checks for external commands it will read and process all commands present in the command file before continuing on with its other duties. More information on external commands can be found here.
This is the file that Nagios will check for external commands to process. The command CGI writes commands to this file. The external command file is implemented as a named pipe (FIFO), which is created when Nagios starts and removed when it shuts down. If the file exists when Nagios starts, the Nagios process will terminate with an error message. More information on external commands can be found here.
Note: This is an advanced feature. This option determines how many buffer slots Nagios will reserve for caching external commands that have been read from the external command file by a worker thread, but have not yet been processed by the main thread of the Nagios deamon. Each slot can hold one external command, so this option essentially determines how many commands can be buffered. For installations where you process a large number of passive checks (e. g. distributed setups), you may need to increase this number. You should consider using MRTG to graph Nagios' usage of external command buffers. You can read more on how to configure graphing here.
This option determines whether Nagios will automatically check to see if new updates (releases) are available. It is recommend that you enable this option to ensure that you stay on top of the latest critical patches to Nagios. Nagios is critical to you - make sure you keep it in good shape. Nagios will check once a day for new updates. Data collected by Nagios Enterprises from the update check is processed in accordance with our privacy policy - see api. nagios for details.
This option deterines what data Nagios will send to api. nagios when it checks for updates. By default, Nagios will send information on the current version of Nagios you have installed, as well as an indicator as to whether this was a new installation or not. Nagios Enterprises uses this data to determine the number of users running specific version of Nagios. Enable this option if you do not wish for this information to be sent.
This option specifies the location of the lock file that Nagios should create when it runs as a daemon (when started with the - d command line argument). This file contains the process id (PID) number of the running Nagios process.
This option determines whether or not Nagios will retain state information for hosts and services between program restarts. If you enable this option, you should supply a value for the state_retention_file variable. When enabled, Nagios will save all state information for hosts and service before it shuts down (or restarts) and will read in previously saved state information when it starts up again.
0 = Don't retain state information 1 = Retain state information (default)
This is the file that Nagios will use for storing status, downtime, and comment information before it shuts down. When Nagios is restarted it will use the information stored in this file for setting the initial states of services and hosts before it starts monitoring anything. In order to make Nagios retain state information between program restarts, you must enable the retain_state_information option.
This setting determines how often (in minutes) that Nagios will automatically save retention data during normal operation. If you set this value to 0, Nagios will not save retention data at regular intervals, but it will still save retention data before shutting down or restarting. If you have disabled state retention (with the retain_state_information option), this option has no effect.
This setting determines whether or not Nagios will set various program-wide state variables based on the values saved in the retention file. Some of these program-wide state variables that are normally saved across program restarts if state retention is enabled include the enable_notifications, enable_flap_detection, enable_event_handlers, execute_service_checks, and accept_passive_service_checks options. If you do not have state retention enabled, this option has no effect.
0 = Don't use retained program state 1 = Use retained program state (default)
This setting determines whether or not Nagios will retain scheduling info (next check times) for hosts and services when it restarts. If you are adding a large number (or percentage) of hosts and services, I would recommend disabling this option when you first restart Nagios, as it can adversely skew the spread of initial checks. Otherwise you will probably want to leave it enabled.
0 = Don't use retained scheduling info 1 = Use retained scheduling info (default)
WARNING: This is an advanced feature. You'll need to read the Nagios source code to use this option effectively.
These options determine which host or service attributes are NOT retained across program restarts. The values for these options are a bitwise AND of values specified by the "MODATTR_" definitions in the include/common. h source code file. By default, all host and service attributes are retained.
WARNING: This is an advanced feature. You'll need to read the Nagios source code to use this option effectively.
These options determine which process attributes are NOT retained across program restarts. There are two masks because there are often separate host and service process attributes that can be changed. For example, host checks can be disabled at the program level, while service checks are still enabled. The values for these options are a bitwise AND of values specified by the "MODATTR_" definitions in the include/common. h source code file. By default, all process attributes are retained.
WARNING: This is an advanced feature. You'll need to read the Nagios source code to use this option effectively.
These options determine which contact attributes are NOT retained across program restarts. There are two masks because there are often separate host and service contact attributes that can be changed. The values for these options are a bitwise AND of values specified by the "MODATTR_" definitions in the include/common. h source code file. By default, all process attributes are retained.
This variable determines whether messages are logged to the syslog facility on your local host. Values are as follows:
0 = Don't use syslog facility 1 = Use syslog facility.
This variable determines whether or not notification messages are logged. If you have a lot of contacts or regular service failures your log file will grow relatively quickly. Use this option to keep contact notifications from being logged.
0 = Don't log notifications 1 = Log notifications.
This variable determines whether or not service check retries are logged. Service check retries occur when a service check results in a non-OK state, but you have configured Nagios to retry the service more than once before responding to the error. Services in this situation are considered to be in "soft" states. Logging service check retries is mostly useful when attempting to debug Nagios or test out service event handlers.
0 = Don't log service check retries 1 = Log service check retries.
This variable determines whether or not host check retries are logged. Logging host check retries is mostly useful when attempting to debug Nagios or test out host event handlers.
0 = Don't log host check retries 1 = Log host check retries.
This variable determines whether or not service and host event handlers are logged. Event handlers are optional commands that can be run whenever a service or hosts changes state. Logging event handlers is most useful when debugging Nagios or first trying out your event handler scripts.
0 = Don't log event handlers 1 = Log event handlers.
This variable determines whether or not Nagios will force all initial host and service states to be logged, even if they result in an OK state. Initial service and host states are normally only logged when there is a problem on the first check. Enabling this option is useful if you are using an application that scans the log file to determine long-term state statistics for services and hosts.
0 = Don't log initial states (default) 1 = Log initial states.
This variable determines whether or not Nagios will log external commands that it receives from the external command file. Note: This option does not control whether or not passive service checks (which are a type of external command) get logged. To enable or disable logging of passive checks, use the log_passive_checks option.
0 = Don't log external commands 1 = Log external commands (default)
This variable determines whether or not Nagios will log passive host and service checks that it receives from the external command file. If you are setting up a distributed monitoring environment or plan on handling a large number of passive checks on a regular basis, you may wish to disable this option so your log file doesn't get too large.
0 = Don't log passive checks 1 = Log passive checks (default)
This option allows you to specify a host event handler command that is to be run for every host state change. The global event handler is executed immediately prior to the event handler that you have optionally specified in each host definition. The command argument is the short name of a command that you define in your object configuration file. The maximum amount of time that this command can run is controlled by the event_handler_timeout option. More information on event handlers can be found here.
This option allows you to specify a service event handler command that is to be run for every service state change. The global event handler is executed immediately prior to the event handler that you have optionally specified in each service definition. The command argument is the short name of a command that you define in your object configuration file. The maximum amount of time that this command can run is controlled by the event_handler_timeout option. More information on event handlers can be found here.
This is the number of seconds that Nagios will sleep before checking to see if the next service or host check in the scheduling queue should be executed. Note that Nagios will only sleep after it "catches up" with queued service checks that have fallen behind.
This option allows you to control how service checks are initially "spread out" in the event queue. Using a "smart" delay calculation (the default) will cause Nagios to calculate an average check interval and spread initial checks of all services out over that interval, thereby helping to eliminate CPU load spikes. Using no delay is generally not recommended, as it will cause all service checks to be scheduled for execution at the same time. This means that you will generally have large CPU spikes when the services are all executed in parallel. More information on how to estimate how the inter-check delay affects service check scheduling can be found here. Values are as follows:
n = Don't use any delay - schedule all service checks to run immediately (i. e. at the same time!) d = Use a "dumb" delay of 1 second between service checks s = Use a "smart" delay calculation to spread service checks out evenly (default) x. xx = Use a user-supplied inter-check delay of x. xx seconds.
This option determines the maximum number of minutes from when Nagios starts that all services (that are scheduled to be regularly checked) are checked. This option will automatically adjust the service inter-check delay method (if necessary) to ensure that the initial checks of all services occur within the timeframe you specify. In general, this option will not have an affect on service check scheduling if scheduling information is being retained using the use_retained_scheduling_info option. Default value is 30 (minutes).
This variable determines how service checks are interleaved. Interleaving allows for a more even distribution of service checks, reduced load on remote hosts, and faster overall detection of host problems. Setting this value to 1 is equivalent to not interleaving the service checks (this is how versions of Nagios previous to 0.0.5 worked). Set this value to s (smart) for automatic calculation of the interleave factor unless you have a specific reason to change it. The best way to understand how interleaving works is to watch the status CGI (detailed view) when Nagios is just starting. You should see that the service check results are spread out as they begin to appear. More information on how interleaving works can be found here. x = A number greater than or equal to 1 that specifies the interleave factor to use. An interleave factor of 1 is equivalent to not interleaving the service checks. s = Use a "smart" interleave factor calculation (default)
This option allows you to specify the maximum number of service checks that can be run in parallel at any given time. Specifying a value of 1 for this variable essentially prevents any service checks from being run in parallel. Specifying a value of 0 (the default) does not place any restrictions on the number of concurrent checks. You'll have to modify this value based on the system resources you have available on the machine that runs Nagios, as it directly affects the maximum load that will be imposed on the system (processor utilization, memory, etc.). More information on how to estimate how many concurrent checks you should allow can be found here.
This option allows you to control the frequency in seconds of check result "reaper" events. "Reaper" events process the results from host and service checks that have finished executing. These events consitute the core of the monitoring logic in Nagios.
This option allows you to control the maximum amount of time in seconds that host and service check result "reaper" events are allowed to run. "Reaper" events process the results from host and service checks that have finished executing. If there are a lot of results to process, reaper events may take a long time to finish, which might delay timely execution of new host and service checks. This variable allows you to limit the amount of time that an individual reaper event will run before it hands control back over to Nagios for other portions of the monitoring logic.
This options determines which directory Nagios will use to temporarily store host and service check results before they are processed. This directory should not be used to store any other files, as Nagios will periodically clean this directory of old file (see the max_check_result_file_age option for more information).
Note: Make sure that only a single instance of Nagios has access to the check result path. If multiple instances of Nagios have their check result path set to the same directory, you will run into problems with check results being processed (incorrectly) by the wrong instance of Nagios!
This options determines the maximum age in seconds that Nagios will consider check result files found in the check_result_path directory to be valid. Check result files that are older that this threshold will be deleted by Nagios and the check results they contain will not be processed. By using a value of zero (0) with this option, Nagios will process all check result files - even if they're older than your hardware :-).
This option allows you to control how host checks that are scheduled to be checked on a regular basis are initially "spread out" in the event queue. Using a "smart" delay calculation (the default) will cause Nagios to calculate an average check interval and spread initial checks of all hosts out over that interval, thereby helping to eliminate CPU load spikes. Using no delay is generally not recommended. Using no delay will cause all host checks to be scheduled for execution at the same time. More information on how to estimate how the inter-check delay affects host check scheduling can be found here. Values are as follows:
n = Don't use any delay - schedule all host checks to run immediately (i. e. at the same time!) d = Use a "dumb" delay of 1 second between host checks s = Use a "smart" delay calculation to spread host checks out evenly (default) x. xx = Use a user-supplied inter-check delay of x. xx seconds.
This option determines the maximum number of minutes from when Nagios starts that all hosts (that are scheduled to be regularly checked) are checked. This option will automatically adjust the host inter-check delay method (if necessary) to ensure that the initial checks of all hosts occur within the timeframe you specify. In general, this option will not have an affect on host check scheduling if scheduling information is being retained using the use_retained_scheduling_info option. Default value is 30 (minutes).
This is the number of seconds per "unit interval" used for timing in the scheduling queue, re-notifications, etc. "Units intervals" are used in the object configuration file to determine how often to run a service check, how often to re-notify a contact, etc.
Important: The default value for this is set to 60, which means that a "unit value" of 1 in the object configuration file will mean 60 seconds (1 minute). I have not really tested other values for this variable, so proceed at your own risk if you decide to do so!
This option determines whether or not Nagios will attempt to automatically reschedule active host and service checks to "smooth" them out over time. This can help to balance the load on the monitoring server, as it will attempt to keep the time between consecutive checks consistent, at the expense of executing checks on a more rigid schedule.
WARNING: THIS IS AN EXPERIMENTAL FEATURE AND MAY BE REMOVED IN FUTURE VERSIONS. ENABLING THIS OPTION CAN DEGRADE PERFORMANCE - RATHER THAN INCREASE IT - IF USED IMPROPERLY!
This option determines how often (in seconds) Nagios will attempt to automatically reschedule checks. This option only has an effect if the auto_reschedule_checks option is enabled. Default is 30 seconds.
WARNING: THIS IS AN EXPERIMENTAL FEATURE AND MAY BE REMOVED IN FUTURE VERSIONS. ENABLING THE AUTO-RESCHEDULING OPTION CAN DEGRADE PERFORMANCE - RATHER THAN INCREASE IT - IF USED IMPROPERLY!
This option determines the "window" of time (in seconds) that Nagios will look at when automatically rescheduling checks. Only host and service checks that occur in the next X seconds (determined by this variable) will be rescheduled. This option only has an effect if the auto_reschedule_checks option is enabled. Default is 180 seconds (3 minutes).
WARNING: THIS IS AN EXPERIMENTAL FEATURE AND MAY BE REMOVED IN FUTURE VERSIONS. ENABLING THE AUTO-RESCHEDULING OPTION CAN DEGRADE PERFORMANCE - RATHER THAN INCREASE IT - IF USED IMPROPERLY!
Nagios tries to be smart about how and when it checks the status of hosts. In general, disabling this option will allow Nagios to make some smarter decisions and check hosts a bit faster. Enabling this option will increase the amount of time required to check hosts, but may improve reliability a bit. Unless you have problems with Nagios not recognizing that a host recovered, I would suggest not enabling this option.
0 = Don't use aggressive host checking (default) 1 = Use aggressive host checking.
This option determines whether or not Nagios will translate DOWN/UNREACHABLE passive host check results to their "correct" state from the viewpoint of the local Nagios instance. This can be very useful in distributed and failover monitoring installations. More information on passive check state translation can be found here.
0 = Disable check translation (default) 1 = Enable check translation.
This option determines whether or not Nagios will treat passive host checks as HARD states or SOFT states. By default, a passive host check result will put a host into a HARD state type. You can change this behavior by enabling this option.
0 = Passive host checks are HARD (default) 1 = Passive host checks are SOFT.
This option determines whether or not Nagios will execute predictive checks of hosts that are being depended upon (as defined in host dependencies) for a particular host when it changes state. Predictive checks help ensure that the dependency logic is as accurate as possible. More information on how predictive checks work can be found here.
0 = Disable predictive checks 1 = Enable predictive checks (default)
This option determines whether or not Nagios will execute predictive checks of services that are being depended upon (as defined in service dependencies) for a particular service when it changes state. Predictive checks help ensure that the dependency logic is as accurate as possible. More information on how predictive checks work can be found here.
0 = Disable predictive checks 1 = Enable predictive checks (default)
This option determines the maximum amount of time (in seconds) that the state of a previous host check is considered current. Cached host states (from host checks that were performed more recently than the time specified by this value) can improve host check performance immensely. Too high of a value for this option may result in (temporarily) inaccurate host states, while a low value may result in a performance hit for host checks. Use a value of 0 if you want to disable host check caching. More information on cached checks can be found here.
This option determines the maximum amount of time (in seconds) that the state of a previous service check is considered current. Cached service states (from service checks that were performed more recently than the time specified by this value) can improve service check performance when a lot of service dependencies are used. Too high of a value for this option may result in inaccuracies in the service dependency logic. Use a value of 0 if you want to disable service check caching. More information on cached checks can be found here.
This option determines whether or not the Nagios daemon will take several shortcuts to improve performance. These shortcuts result in the loss of a few features, but larger installations will likely see a lot of benefit from doing so. More information on what optimizations are taken when you enable this option can be found here.
This option determines whether or not Nagios will free memory in child processes when they are fork()ed off from the main process. By default, Nagios frees memory. However, if the use_large_installation_tweaks option is enabled, it will not. By defining this option in your configuration file, you are able to override things to get the behavior you want.
This option determines whether or not Nagios will fork() child processes twice when it executes host and service checks. By default, Nagios fork()s twice. However, if the use_large_installation_tweaks option is enabled, it will only fork() once. By defining this option in your configuration file, you are able to override things to get the behavior you want.
This option determines whether or not the Nagios daemon will make all standard macros available as environment variables to your check, notification, event hander, etc. commands. In large Nagios installations this can be problematic because it takes additional memory and (more importantly) CPU to compute the values of all macros and make them available to the environment.
0 = Don't make macros available as environment variables 1 = Make macros available as environment variables (default)
This option determines whether or not Nagios will try and detect hosts and services that are "flapping". Flapping occurs when a host or service changes between states too frequently, resulting in a barrage of notifications being sent out. When Nagios detects that a host or service is flapping, it will temporarily suppress notifications for that host/service until it stops flapping. Flap detection is very experimental at this point, so use this feature with caution! More information on how flap detection and handling works can be found here. Note: If you have state retention enabled, Nagios will ignore this setting when it (re)starts and use the last known setting for this option (as stored in the state retention file), unless you disable the use_retained_program_state option. If you want to change this option when state retention is active (and the use_retained_program_state is enabled), you'll have to use the appropriate external command or change it via the web interface.
0 = Don't enable flap detection (default) 1 = Enable flap detection.
This option is used to set the low threshold for detection of service flapping. For more information on how flap detection and handling works (and how this option affects things) read this.
This option is used to set the high threshold for detection of service flapping. For more information on how flap detection and handling works (and how this option affects things) read this.
This option is used to set the low threshold for detection of host flapping. For more information on how flap detection and handling works (and how this option affects things) read this.
This option is used to set the high threshold for detection of host flapping. For more information on how flap detection and handling works (and how this option affects things) read this.
This option determines whether or not Nagios will use soft state information when checking host and service dependencies. Normally Nagios will only use the latest hard host or service state when checking dependencies. If you want it to use the latest state (regardless of whether its a soft or hard state type), enable this option.
0 = Don't use soft state dependencies (default) 1 = Use soft state dependencies.
This is the maximum number of seconds that Nagios will allow service checks to run. If checks exceed this limit, they are killed and a CRITICAL state is returned. A timeout error will also be logged.
There is often widespread confusion as to what this option really does. It is meant to be used as a last ditch mechanism to kill off plugins which are misbehaving and not exiting in a timely manner. It should be set to something high (like 60 seconds or more), so that each service check normally finishes executing within this time limit. If a service check runs longer than this limit, Nagios will kill it off thinking it is a runaway processes.
This setting determines the state Nagios will report when a service check times out - that is does not respond within service_check_timeout seconds. This can be useful if a machine is running at too high a load and you do not want to consider a failed service check to be critical (the default).
Valid settings are:
This is the maximum number of seconds that Nagios will allow host checks to run. If checks exceed this limit, they are killed and a CRITICAL state is returned and the host will be assumed to be DOWN. A timeout error will also be logged.
There is often widespread confusion as to what this option really does. It is meant to be used as a last ditch mechanism to kill off plugins which are misbehaving and not exiting in a timely manner. It should be set to something high (like 60 seconds or more), so that each host check normally finishes executing within this time limit. If a host check runs longer than this limit, Nagios will kill it off thinking it is a runaway processes.
This is the maximum number of seconds that Nagios will allow event handlers to be run. If an event handler exceeds this time limit it will be killed and a warning will be logged.
There is often widespread confusion as to what this option really does. It is meant to be used as a last ditch mechanism to kill off commands which are misbehaving and not exiting in a timely manner. It should be set to something high (like 60 seconds or more), so that each event handler command normally finishes executing within this time limit. If an event handler runs longer than this limit, Nagios will kill it off thinking it is a runaway processes.
This is the maximum number of seconds that Nagios will allow notification commands to be run. If a notification command exceeds this time limit it will be killed and a warning will be logged.
There is often widespread confusion as to what this option really does. It is meant to be used as a last ditch mechanism to kill off commands which are misbehaving and not exiting in a timely manner. It should be set to something high (like 60 seconds or more), so that each notification command finishes executing within this time limit. If a notification command runs longer than this limit, Nagios will kill it off thinking it is a runaway processes.
This is the maximum number of seconds that Nagios will allow an obsessive compulsive service processor command to be run. If a command exceeds this time limit it will be killed and a warning will be logged.
This is the maximum number of seconds that Nagios will allow an obsessive compulsive host processor command to be run. If a command exceeds this time limit it will be killed and a warning will be logged.
This is the maximum number of seconds that Nagios will allow a host performance data processor command or service performance data processor command to be run. If a command exceeds this time limit it will be killed and a warning will be logged.
This value determines whether or not Nagios will "obsess" over service checks results and run the obsessive compulsive service processor command you define. I know - funny name, but it was all I could think of. This option is useful for performing distributed monitoring. If you're not doing distributed monitoring, don't enable this option.
0 = Don't obsess over services (default) 1 = Obsess over services.
This option allows you to specify a command to be run after every service check, which can be useful in distributed monitoring. This command is executed after any event handler or notification commands. The command argument is the short name of a command definition that you define in your object configuration file. The maximum amount of time that this command can run is controlled by the ocsp_timeout option. More information on distributed monitoring can be found here. This command is only executed if the obsess_over_services option is enabled globally and if the obsess_over_service directive in the service definition is enabled.
This value determines whether or not Nagios will "obsess" over host checks results and run the obsessive compulsive host processor command you define. I know - funny name, but it was all I could think of. This option is useful for performing distributed monitoring. If you're not doing distributed monitoring, don't enable this option.
0 = Don't obsess over hosts (default) 1 = Obsess over hosts.
This option allows you to specify a command to be run after every host check, which can be useful in distributed monitoring. This command is executed after any event handler or notification commands. The command argument is the short name of a command definition that you define in your object configuration file. The maximum amount of time that this command can run is controlled by the ochp_timeout option. More information on distributed monitoring can be found here. This command is only executed if the obsess_over_hosts option is enabled globally and if the obsess_over_host directive in the host definition is enabled.
This value determines whether or not Nagios will process host and service check performance data.
0 = Don't process performance data (default) 1 = Process performance data.
This option allows you to specify a command to be run after every host check to process host performance data that may be returned from the check. The command argument is the short name of a command definition that you define in your object configuration file. This command is only executed if the process_performance_data option is enabled globally and if the process_perf_data directive in the host definition is enabled.
This option allows you to specify a command to be run after every service check to process service performance data that may be returned from the check. The command argument is the short name of a command definition that you define in your object configuration file. This command is only executed if the process_performance_data option is enabled globally and if the process_perf_data directive in the service definition is enabled.
This option allows you to specify a file to which host performance data will be written after every host check. Data will be written to the performance file as specified by the host_perfdata_file_template option. Performance data is only written to this file if the process_performance_data option is enabled globally and if the process_perf_data directive in the host definition is enabled.
This option allows you to specify a file to which service performance data will be written after every service check. Data will be written to the performance file as specified by the service_perfdata_file_template option. Performance data is only written to this file if the process_performance_data option is enabled globally and if the process_perf_data directive in the service definition is enabled.
This option determines what (and how) data is written to the host performance data file. The template may contain macros, special characters (\t for tab, \r for carriage return, \n for newline) and plain text. A newline is automatically added after each write to the performance data file.
This option determines what (and how) data is written to the service performance data file. The template may contain macros, special characters (\t for tab, \r for carriage return, \n for newline) and plain text. A newline is automatically added after each write to the performance data file.
This option determines how the host performance data file is opened. Unless the file is a named pipe you'll probably want to use the default mode of append.
a = Open file in append mode (default) w = Open file in write mode p = Open in non-blocking read/write mode (useful when writing to pipes)
This option determines how the service performance data file is opened. Unless the file is a named pipe you'll probably want to use the default mode of append.
a = Open file in append mode (default) w = Open file in write mode p = Open in non-blocking read/write mode (useful when writing to pipes)
This option allows you to specify the interval (in seconds) at which the host performance data file is processed using the host performance data file processing command. A value of 0 indicates that the performance data file should not be processed at regular intervals.
This option allows you to specify the interval (in seconds) at which the service performance data file is processed using the service performance data file processing command. A value of 0 indicates that the performance data file should not be processed at regular intervals.
This option allows you to specify the command that should be executed to process the host performance data file. The command argument is the short name of a command definition that you define in your object configuration file. The interval at which this command is executed is determined by the host_perfdata_file_processing_interval directive.
This option allows you to specify the command that should be executed to process the service performance data file. The command argument is the short name of a command definition that you define in your object configuration file. The interval at which this command is executed is determined by the service_perfdata_file_processing_interval directive.
This option allows you to enable or disable checks for orphaned service checks. Orphaned service checks are checks which have been executed and have been removed from the event queue, but have not had any results reported in a long time. Since no results have come back in for the service, it is not rescheduled in the event queue. This can cause service checks to stop being executed. Normally it is very rare for this to happen - it might happen if an external user or process killed off the process that was being used to execute a service check. If this option is enabled and Nagios finds that results for a particular service check have not come back, it will log an error message and reschedule the service check. If you start seeing service checks that never seem to get rescheduled, enable this option and see if you notice any log messages about orphaned services.
0 = Don't check for orphaned service checks 1 = Check for orphaned service checks (default)
This option allows you to enable or disable checks for orphaned hoste checks. Orphaned host checks are checks which have been executed and have been removed from the event queue, but have not had any results reported in a long time. Since no results have come back in for the host, it is not rescheduled in the event queue. This can cause host checks to stop being executed. Normally it is very rare for this to happen - it might happen if an external user or process killed off the process that was being used to execute a host check. If this option is enabled and Nagios finds that results for a particular host check have not come back, it will log an error message and reschedule the host check. If you start seeing host checks that never seem to get rescheduled, enable this option and see if you notice any log messages about orphaned hosts.
0 = Don't check for orphaned host checks 1 = Check for orphaned host checks (default)
This option determines whether or not Nagios will periodically check the "freshness" of service checks. Enabling this option is useful for helping to ensure that passive service checks are received in a timely manner. More information on freshness checking can be found here.
0 = Don't check service freshness 1 = Check service freshness (default)
This setting determines how often (in seconds) Nagios will periodically check the "freshness" of service check results. If you have disabled service freshness checking (with the check_service_freshness option), this option has no effect. More information on freshness checking can be found here.
This option determines whether or not Nagios will periodically check the "freshness" of host checks. Enabling this option is useful for helping to ensure that passive host checks are received in a timely manner. More information on freshness checking can be found here.
0 = Don't check host freshness 1 = Check host freshness (default)
This setting determines how often (in seconds) Nagios will periodically check the "freshness" of host check results. If you have disabled host freshness checking (with the check_host_freshness option), this option has no effect. More information on freshness checking can be found here.
This option determines the number of seconds Nagios will add to any host or services freshness threshold it automatically calculates (e. g. those not specified explicity by the user). More information on freshness checking can be found here.
This setting determines whether or not the embedded Perl interpreter is enabled on a program-wide basis. Nagios must be compiled with support for embedded Perl for this option to have an effect. More information on the embedded Perl interpreter can be found here.
This setting determines whether or not the embedded Perl interpreter should be used for Perl plugins/scripts that do not explicitly enable/disable it. Nagios must be compiled with support for embedded Perl for this option to have an effect. More information on the embedded Perl interpreter and the effect of this setting can be found here.
This option allows you to specify what kind of date/time format Nagios should use in the web interface and date/time macros. Possible options (along with example output) include:
This option allows you to override the default timezone that this instance of Nagios runs in. Useful if you have multiple instances of Nagios that need to run from the same server, but have different local times associated with them. If not specified, Nagios will use the system configured timezone.
Note: If you use this option to specify a custom timezone, you will also need to alter the Apache configuration directives for the CGIs to specify the timezone you want. مثال:
SetEnv TZ "US/Mountain"
This option allows you to specify illegal characters that cannot be used in host names, service descriptions, or names of other object types. Nagios will allow you to use most characters in object definitions, but I recommend not using the characters shown in the example above. Doing may give you problems in the web interface, notification commands, etc.
This option allows you to specify illegal characters that should be stripped from macros before being used in notifications, event handlers, and other commands. This DOES NOT affect macros used in service or host check commands. You can choose to not strip out the characters shown in the example above, but I recommend you do not do this. Some of these characters are interpreted by the shell (i. e. the backtick) and can lead to security problems. The following macros are stripped of the characters you specify:
$HOSTOUTPUT$ , $HOSTPERFDATA$ , $HOSTACKAUTHOR$ , $HOSTACKCOMMENT$ , $SERVICEOUTPUT$ , $SERVICEPERFDATA$ , $SERVICEACKAUTHOR$ , and $SERVICEACKCOMMENT$
This option determines whether or not various directives in your object definitions will be processed as regular expressions. More information on how this works can be found here.
0 = Don't use regular expression matching (default) 1 = Use regular expression matching.
If you've enabled regular expression matching of various object directives using the use_regexp_matching option, this option will determine when object directives are treated as regular expressions. If this option is disabled (the default), directives will only be treated as regular expressions if they contain * , ? , + , or \. . If this option is enabled, all appropriate directives will be treated as regular expression - be careful when enabling this! More information on how this works can be found here.
0 = Don't use true regular expression matching (default) 1 = Use true regular expression matching.
This is the email address for the administrator of the local machine (i. e. the one that Nagios is running on). This value can be used in notification commands by using the $ADMINEMAIL$ macro.
This is the pager number (or pager email gateway) for the administrator of the local machine (i. e. the one that Nagios is running on). The pager number/address can be used in notification commands by using the $ADMINPAGER$ macro.
This option controls what (if any) data gets sent to the event broker and, in turn, to any loaded event broker modules. This is an advanced option. When in doubt, either broker nothing (if not using event broker modules) or broker everything (if using event broker modules). Possible values are shown below.
0 = Broker nothing -1 = Broker everything # = See BROKER_* definitions in source code (include/broker. h) for other values that can be OR'ed together.
This directive is used to specify an event broker module that should by loaded by Nagios at startup. Use multiple directives if you want to load more than one module. Arguments that should be passed to the module at startup are seperated from the module path by a space.
Do NOT overwrite modules while they are being used by Nagios or Nagios will crash in a fiery display of SEGFAULT glory. This is a bug/limitation either in dlopen(), the kernel, and/or the filesystem. And maybe Nagios.
The correct/safe way of updating a module is by using one of these methods:
Shutdown Nagios, replace the module file, restart Nagios While Nagios is running. delete the original module file, move the new module file into place, restart Nagios.
This option determines where Nagios should write debugging information. What (if any) information is written is determined by the debug_level and debug_verbosity options. You can have Nagios automaticaly rotate the debug file when it reaches a certain size by using the max_debug_file_size option.
This option determines what type of information Nagios should write to the debug_file. This value is a logical OR of the values below.
-1 = Log everything 0 = Log nothing (default) 1 = Function enter/exit information 2 = Config information 4 = Process information 8 = Scheduled event information 16 = Host/service check information 32 = Notification information 64 = Event broker information.
This option determines how much debugging information Nagios should write to the debug_file.
0 = Basic information 1 = More detailed information (default) 2 = Highly detailed information.
This option determines the maximum size (in bytes) of the debug file. If the file grows larger than this size, it will be renamed with a. old extension. If a file already exists with a. old extension it will automatically be deleted. This helps ensure your disk space usage doesn't get out of control when debugging Nagios.
This boolean option determines whether services, service dependencies, or host dependencies assigned to empty host groups (host groups with no host members) will cause Nagios to exit with error on start up (or during a configuration check) or not. The default behavior if the option is not present in the main configuration file is for Nagios to exit with error if any of these objects are associated with host groups that have no hosts associated with them. Enabling this option can be useful when:

About monitoring.
المقدمة.
Since Nagios 4 version release there was an important addon update pending. Recently, check_mk released its innovation version check_mk-1.2.5i2 including MK Livestatus with compatibility with Nagios Core 4. We need therefore check_mk-1.2.5i2 or higher to run check_mk with Nagios Core 4.
In aboutmonitoring we are going to build and test a monitoring system with probably the more interesting and powerful utilities for Nagios. We need compile Nagios 4 because there is not packages in usual distros yet and because we prefer the lastest versions for testing. If you are looking for to install same software in Centos 7 look at Nagios Core 4 + PNP4Nagios + Check_mk + Nagvis in CentOS 7 – Redhat 7.
Software components used in this test:
Check_mk 1.2.5i2p1 (with cmk LiveStatus in same version)
Update (06/09/2018): The recent check_mk “free” versions are called Check_MK Raw Edition (CRE). These versions incorporate check_mk and additional software (pack previously called OMD). For the source package of check_mk mentioned in this article you must download the CRE version, untar and localize the tar. gz package check_mk in packages/check_mk/
Install Linux and general prerequisites.
CentOS is installed with minimal options an updated from repositories.
We need install development tools for compile Nagios, nagiosplugins, check_mk,…
Nagios 4 Core.
المتطلبات الأساسية.
Install Apache, php and some required libraries and tools.
Create nagios user and groups.
We are going to create nagios account and an additional group “nagcmd” that we need to use for nagios external commands. Nagios user and Apache user must be in “nagcmd” group.
Compile and install Nagios Core 4.
We need to configure Nagios sofware with (important) our nagcmd group as command group and compile:
*** Configuration summary for nagios 4.0.5 04-11-2017 ***:
Nagios executable: nagios.
Nagios user/group: nagios, nagios.
Command user/group: nagios, nagcmd.
Check result directory: $ /var/spool/checkresults.
Init directory: /etc/rc. d/init. d.
Apache conf. d directory: /etc/httpd/conf. d.
Mail program: /bin/mail.
IOBroker Method: epoll.
Web Interface Options:
HTML URL: localhost/nagios/
CGI URL: localhost/nagios/cgi-bin/
Traceroute (used by WAP):
Next steps are to compile and install. Tools inform us about next steps and other important inforamation about executed commands.
# This installs the main program, CGIs, and HTML files.
# This installs the init script in /etc/rc. d/init. d.
# This installs and configures permissions on the directory for holding the external command file.
# This installs *SAMPLE* config files in /usr/local/nagios/etc.
# This installs the Apache config file for the Nagios web interface.
# This installs the Exfoliation theme for the Nagios web interface.
From nagios source directory we must copy something files that may need in the future.
Check nagios config (with included sample files)
Create password file.
Configure Apache and Nagios services to run at init and start both services.
Go to nagios URI: server/nagios/ and all should be ok. (Remember to enable http port in your local firewall with iptables).
We can see that localhost sample checks fail. It is logical, there is not directory with Nagios Plugins yet.
Nagios Plugins.
We have several options for installing Nagios Plugins. We can install actual plugins binaries from EPEL repositories (equivalent to monitoring-plugins). We can download and compile from monitoring-plugin classic plugins or plugins from Nagios Enterprise (similar to monitoring-plugins yet).
We are going to compile and install Nagios Enterprise plugins. It’s your choice.
المتطلبات الأساسية.
Only if we are going to use some plugins for check mysql (local), samba (local),… we need install some more packages to compile successfully this specific plugins.
Compile and install Nagios plugins.
Now, localhost check samples must be ok in our Nagios. The plugins are in directory /usr/local/nagios/libexec/ with correct permissions and owners (some plugins need different rights and/or owner).
PNP4Nagios.
Install from EPEL or install compiling? At this point, with Nagios Core and Nagios Plugins compiling installed… I prefer to compile PNP4Nagios too. Is the best option really. Install from EPEL would try install Nagios core 3 too and we want Nagios Core 4.
المتطلبات الأساسية.
Download, untar, configure, compile and install.
Important to save end command information to find software directories later if we need them.
*** Configuration summary for pnp4nagios-0.6.21 03-24-2018 ***
Nagios user/group: nagios nagios.
Install directory: /usr/local/pnp4nagios.
HTML Dir: /usr/local/pnp4nagios/share.
Config Dir: /usr/local/pnp4nagios/etc.
Location of rrdtool binary: /usr/bin/rrdtool Version 1.3.8.
RRDs Perl Modules: FOUND (Version 1.3008)
RRD Files stored in: /usr/local/pnp4nagios/var/perfdata.
process_perfdata. pl Logfile: /usr/local/pnp4nagios/var/perfdata. log.
Perfdata files (NPCD) stored in: /usr/local/pnp4nagios/var/spool.
Web Interface Options:
HTML URL: localhost/pnp4nagios.
Apache Config File: /etc/httpd/conf. d/pnp4nagios. conf.
Configure npcd service to run at init and starting. Reload apache for reading pnp4nagios config file.
In pnp4nagios URI server/pnp4nagios/ to look at all che cks are marked g reen. If all it’s ok rename file /usr/local/pnp4nagios/share/install. php.
Reloading PNP4Nagios page we are going to find an error:
Please check the documentation for information about the following error. perfdata directory “/usr/local/pnp4nagios/var/perfdata/” is empty. الرجاء التحقق من تهيئة ناجيوس. Read FAQ online.
At this point is a normal error. We need configure nagios integration yet!
Configure PNP4Nagios.
PNP4Nagios allow several options to configure Nagios integration. We are going to use option named “ Bulk-mode ”. It’s the best available for Nagios 4 (Bulk Mode with npcdmod is more simple but is not valid for Nagios 4, it use a broker that is not compatible with Nagios 4 module broker).
There are example config. texts in /usr/local/pnp4nagios/etc files ready to copy and paste.
From file nagios. cfg-sample copy ONLY next text to nagios config file /usr/local/nagios/etc/nagios. cfg.
# Bulk / NPCD mode.
# *** the template definition differs from the one in the original nagios. cfg.
# *** the template definition differs from the one in the original nagios. cfg.
From file misccommands. cfg-sample copy ONLY next text configuration to nagios commands file /usr/local/nagios/etc/objects/commands. cfg . And uncomment the lines!!
# Bulk with NPCD mode.
command_line /bin/mv /usr/local/pnp4nagios/var/service-perfdata /usr/local/pnp4nagios/var/spool/service-perfdata.$TIMET$
command_line /bin/mv /usr/local/pnp4nagios/var/host-perfdata /usr/local/pnp4nagios/var/spool/host-perfdata.$TIMET$
Restart npcd and nagios daemons now.
We can test now pnp4Nagios site and must be up and running.
Configure links to graphs.
Last but not least we must configure acces to graphs from Nagios pages.
Edit /usr/local/nagios/etc/objects/templates. cfg and add next text:
action_url /pnp4nagios/index. php/graph? host=$HOSTNAME$&srv=_HOST_’ class=’tips’ rel=’/pnp4nagios/index. php/popup? host=$HOSTNAME$&srv=_HOST_.
action_url /pnp4nagios/index. php/graph? host=$HOSTNAME$&srv=$SERVICEDESC$’ class=’tips’ rel=’/pnp4nagios/index. php/popup? host=$HOSTNAME$&srv=$SERVICEDESC$
Modify required host and service objects to use inheritance with pnp4nagios specific templates created previously (use property):
ATENTION : Copy next file from PNP4Nagios source directory to Nagios directory. It’s necessary to show POPUPS graphs in icons.
Restart nagios and ncmd (pnp4nagios module):
We can see a beautiful POPUP when mouse to hover graph icon and we can click on this for go to PNP4Nagios site. Beautiful and practical :-)
المتطلبات الأساسية.
Check_mk GUI need a python apache module that is not included in distro repositories actually. It can be installed from EPEL repositories.
Check_mk install is quite easy. It may be even easier if you copy next text in a file named “ . check_mk_setup. conf ” in your home root (first character file name is “.”).
# Written by setup of check_mk 1.2.5i2p1 at Wed Apr 16 20:10:20 CEST 2017.
You can install check_mk without this file and answer all questions about you file locations or use this file and change default entries during setup. Check_mk create and use this file to know values in next installation or update.
When check_mk setup completes install show… “Installation completed successfully. Please restart Nagios and Apache in order to update/active check_mk’s web pages.”
Setup add next lines at the end of Nagios config file “nagios. cfg”.
# Load Livestatus Module.
# added by setup. sh of check_mk.
We can test check_mk in URI server/check_mk.
If you find any problem with check_mk livestatus connect to Nagios, first to look is correct load of livestatus in nagios. log:
Example localhost in check_mk…
المتطلبات الأساسية.
التركيب.
Main questions from install are about paths and users but Nagvis install discover so good all important values. We must select only “backend mklivestatus”
| Welcome to NagVis Installer 1.8b3 |
| This script is built to facilitate the NagVis installation and update |
| procedure for you. The installer has been tested on the following systems: |
| & # 8211؛ SuSE Linux Enterprise Server 10 and 11 |
| Similar distributions to the ones mentioned above should work as well. |
| That (hopefully) includes RedHat, Fedora, CentOS, OpenSuSE |
| If you experience any problems using these or other distributions, please |
| report that to the NagVis team. |
| Do you want to proceed? [y]: y.
| Starting installation of NagVis 1.8b3 |
| OS : CentOS release 6.5 (Final) |
| Using packet manager /bin/rpm found |
| Please enter the path to the nagios base directory [/usr/local/nagios]:
| nagios path /usr/local/nagios found |
| Please enter the path to NagVis base [/usr/local/nagvis]:
| PHP Module: gd php found |
| PHP Module: mbstring php found |
| PHP Module: gettext compiled_in found |
| PHP Module: session compiled_in found |
| PHP Module: xml compiled_in found |
| PHP Module: pdo php found |
| Checking Backends. (Available: mklivestatus, ndo2db, ido2db, merlinmy) |
| Do you want to use backend mklivestatus? [y]: y.
| Do you want to use backend ndo2db? [n]:
| Do you want to use backend ido2db? [n]:
| Do you want to use backend merlinmy? [n]:
| Livestatus Socket (/usr/local/nagios/var/rw/live) found |
| PHP Module: sockets compiled_in found |
| Please enter the web path to NagVis [/nagvis]:
| Please enter the name of the web-server user [apache]:
| Please enter the name of the web-server group [apache]:
| create Apache config file [y]:
| NagVis home will be: /usr/local/nagvis |
| Owner of NagVis files will be: apache |
| Group of NagVis files will be: apache |
| Path to Apache config dir is: /etc/httpd/conf. d |
| Apache config will be created: yes |
| Installation mode: install |
| Do you really want to continue? [y]:
| You can safely remove this source directory. |
| For later update/upgrade you may use this command to have a faster update: |
| ./install. sh - n /usr/local/nagios - p /usr/local/nagvis - l “unix:/usr/local/nagios/var/rw/live” - b mklivestatus - u apache - g apache - w /etc/httpd/conf. d - a y.
| & # 8211؛ Maybe you want to edit the main configuration file? |
| Its location is: /usr/local/nagvis/etc/nagvis. ini. php |
Test your new Nagivis web site: server/nagvis/ (admin/admin)
Minimal configuration and test.
Nagvis include a lot of samples, so much samples really. Is good bat… there is so much confusion to start with nagvis.
First is configure the default backend to check_mk livestatus (live_1). Menu Options / Manage Backends / Default Backend → live_1 (save)
Go to an existing map (p. e. “Demo1. Datacenter Hamburg”).
Menu Edit Map / Map Options / listbox “backend_id” and select live_1 (save). Menu Edit Map / Add Icon / Host, place cross where you like in the map, select as Hostname in listbox your localhost (save).
Now we can create new map from our images and start to place objects in it. عظيم!
Perhaps, the best is delete all demo maps first.
Example localhost passing mouse over host object in Nagvis MAP:
Dowload this post.
شارك هذا:
ترك تعليق إلغاء الرد.
23 thoughts on “ Nagios 4 (core) + Check_mk + pnp4Nagios + Nagvis ”
I followed all the setps and I’m still having issue with Livestatus.
Livestatus problem: Cannot connect to ‘unix:/var/log/nagios/rw/live’: [Errno 13] Permission denied.
86] Event broker module ‘/usr/lib/check_mk/livestatus. o’ تم التهيئة بنجاح.
[1404464586] Warning: failure_prediction_enabled is obsoleted and no longer has any effect in host type objects (config file ‘/usr/local/nagios/etc/check_mk. d/check_mk_templates. cfg’, starting at line 88)
[1404464586] Warning: failure_prediction_enabled is obsoleted and no longer has any effect in service type objects (config file ‘/usr/local/nagios/etc/check_mk. d/check_mk_templates. cfg’, starting at line 157)
[1404464586] Successfully launched command file worker with pid 35237.
[1404464586] TIMEPERIOD TRANSITION: 24X7;-1;1.
[1404464586] TIMEPERIOD TRANSITION: 24×7;-1;1.
[1404464586] TIMEPERIOD TRANSITION: 24x7_sans_holidays;-1;0.
[1404464586] TIMEPERIOD TRANSITION: none;-1;0.
[1404464586] TIMEPERIOD TRANSITION: us-holidays;-1;0.
[1404464586] TIMEPERIOD TRANSITION: workhours;-1;0.
Nagios broker seem is running ok. There is a problem with “live” file or rights in dir of “live” file.
Is your socket livestatus file in :/var/log/nagios/rw/live . CMK install default is not there…
مادة كبيرة! worked perfectly.
Sam – it it helps, I got similar errors after a reboot:
check_mk: Cannot connect to ‘unix:/usr/local/nagios/var/rw/live’: [Errno 13] Permission denied.
nagvis: Error (Dwoo_Exception): The compile directory must be writable, chmod “/usr/local/nagvis/var/tmpl/compile/” to make it writable.
The issue was that I disabled SElinux while installing the apps, but it was only temporarily. I had to update /etc/selinux/config to permanently disable.
Server or Configuration Problem.
A Server problem occurred. You’ll find details in the error log of Apache. One possible reason is, that the file /usr/local/nagios/etc/htpasswd. users is missing. You can create that file with htpasswd or htpasswd2. A better solution might be to use your existing htpasswd file from your Nagios installation. Please edit /etc/httpd/conf. d/check_mk and change the path there. Restart Apache afterwards.
I am getting the following error after adding nagios. cfg file.
# Load Livestatus Module.
]# tail /usr/local/nagios/var/nagios. log [1421900034] Event broker module ‘/usr/lib/check_mk/livestatus. o’ deinitialized successfully.
[1421900034] Error: Failed to load module ‘/usr/lib/check_mk/livestatus. o’.
[1421900034] livestatus: Livestatus 1.2.6b6 by Mathias Kettner. Socket: ‘/usr/local/nagios/var/rw/live’
[1421900034] livestatus: Please visit us at mathias-kettner. de/
[1421900034] livestatus: Hint: please try out OMD – the Open Monitoring Distribution.
[1421900034] livestatus: Please visit OMD at omdistro.
[1421900034] livestatus: Removed old left over socket file /usr/local/nagios/var/rw/live.
[1421900034] livestatus: Finished initialization. Further log messages go to /usr/local/nagios/var/livestatus. log.
[1421900034] Event broker module ‘/usr/lib/check_mk/livestatus. o’ تم التهيئة بنجاح.
[1421900034] Error: Module loading failed. Aborting.
Hi Ashik. It’s strange. Module load but is not loaded…
I would review potential problems with permissions on the files involved. Have you disabled SELINUX? Test disable SELINUX first.
Hello folks, after PNP4nagios installation trying to connect to nagiosserver/pnp4nagios I received this msg error:
Fatal error: Call to undefined function simplexml_load_file() in /usr/local/pnp4nagios/share/application/models/data. php on line 270.
do you have any idea how to solve? شكرا مقدما.
؟ Test if there is an uncomment line in php. ini file:
Instructions for ubuntu?
I have configured Nagios, Check_MK, PNP4 Nagios and Nagvis as per your documentation, but I am unable to configure map using “Demo1. Datacenter Hamburg”.
In addition to this, I don’t get “Options” menu button on top. I have checked Nagvis in three different browsers, but all browsers show same result.
Please let me know if I miss something.
Because you are authorized under the user “nagios” and the need to log in as user “admin”.
Getting Error while compiling mk-livestatus using “make - j 4” أمر.
TableLog. cc: In member function ‘void TableLog::updateLogfileIndex()’:
TableLog. cc:250:21: error: expected primary-expression before ‘struct’
int len = offsetof(struct dirent, d_name)
TableLog. cc:250:36: error: ‘d_name’ was not declared in this scope.
int len = offsetof(struct dirent, d_name)
TableLog. cc:250:42: error: ‘offsetof’ was not declared in this scope.
int len = offsetof(struct dirent, d_name)
make[2]: *** [livestatus_so-TableLog. o] Error 1.
make[2]: *** Waiting for unfinished jobs….
mv - f. deps/livestatus_so-OffsetStringMacroColumn. Tpo. deps/livestatus_so-OffsetStringMacroColumn. Po.
mv - f. deps/livestatus_so-TableContactgroups. Tpo. deps/livestatus_so-TableContactgroups. Po.
mv - f. deps/livestatus_so-OffsetStringServiceMacroColumn. Tpo. deps/livestatus_so-OffsetStringServiceMacroColumn. Po.
make[2]: Leaving directory `/home/Nagios_Setup/mk-livestatus-1.1.6p1/src’
make[1]: *** [all-recursive] Error 1.
make[1]: Leaving directory `/home/Nagios_Setup/mk-livestatus-1.1.6p1′
make: *** [all] Error 2.
Mk-livestatus-1.1.6. Its a very old versión… Try with an actual versión .
Hi , in which file i need to add the below test.
In nagios. cfg there is parameters with include files and/or include dirs. Any of them.
A warning, I copied the nagios cfg settings for pnp4nagios from this website instead of the original files. After this everything worked except the popup graphs. After carefull comparing the differences, I figured out that the wrong quote character was copied somehow! After changing the qoutes to the standard backqoute on the keyboard, the popup graphs worked.