This article provides an overview of key event types which can be used to generate notifications, along with links to related documentation.

Host and Service Event Types

Nagios XI can send you notifications on the following occurrences and state changes:

Host Settings

• Host Acknowledgement – this indicates that a user has acknowledged the current problem with the host, which will either suppress further notifications until the object changes state, or until the object recovers if “Sticky Acknowledgement” is chosen.
• Host Recovery – the host has returned to an OK state from a problem state.
• Host Down – the host is not responding.
• Host Unreachable – the host cannot be reached, because an intermediary parent host which must be routed through to check it is down.
• Host Flapping – this indicates that the state of the host object has fluctuated significantly over the last 21 checks run by Nagios. You can find additional details on the related logic here.
• Host Downtime – the host has been placed in administrative downtime by a user, suppressing notifications.

Service Settings

• Service Acknowledgement – this indicates that a user has acknowledged the current problem with the service, which will either suppress further notifications until the object changes state, or until the object recovers if “Sticky Acknowledgement” is chosen.
• Service Recovery – the service has recovered back to an OK state.
• Service Warning – the service has exceeded your Warning threshold.
• Service Unknown – this typically indicates an issue with the check plugin being used to check the status.
• Service Critical – the service has exceeded your Critical alert thresholds.
• Service Flapping – this indicates that the state of the service object has fluctuated significantly over the last 21 checks run by Nagios. You can find additional details here.
• Service Downtime – the service has been placed in administrative downtime by a user, suppressing notifications.

Documentation

You can learn more about setting up notifications here:

• Configuring Email and Text Notifications in Nagios XI

Full details on managing and configuring Nagios XI can be found in the Admin Guide:

• Nagios XI Admin Guide

The test email is sent using SMTP, and the verification and deletion are done via IMAP.

This document provides step-by-step instructions and usage notes:

Here is a direct link to the PDF as well:

How to Use the Email Delivery Wizard in Nagios XI

Nagios Documentation & Guides

➤ We recently revamped all of our documentation, providing you with accurate, easy-to-understand instructions and helpful tips for using Nagios. These Nagios docs will guide you through the basics, help you get started, and support you in learning more about Nagios tools.

Nagios Documentation

A new comprehensive documentation site replacing the legacy Support Knowledgebase. Here, you’ll find guides for commercial solutions and open-source projects with step-by-step tutorials, technical documentation, and best practices.

Nagios Library

Library is a central place for detailed Nagios training docs, how-to guides, articles on the latest industry insights, and real-life stories about using Nagios:

Admin Guides

Looking for step-by-step instructions? These guides walk you through installation, configuration, and advanced setup:

Nagios Support Options

➤ Support options are designed to provide both quick answers and in-depth assistance. Nagios offers these resources with every license.

Nagios Customer Success Managers

If you have a Nagios license, you can contact a Nagios Customer Success Manager (CSM). CSMs can help with a wide variety of Nagios-related information. They can help answer basic questions about Nagios, get you in contact with the right support, as well as help you renew or buy a new license.

To contact a Nagios CSM, email csm@nagios.com.

Nagios Support Plans

Guaranteed one-business-day response from Nagios Technicians for support tickets (up to 10 per year), with the option to purchase additional support plans as needed:

Nagios Answer Hub

Find answers to frequently asked questions and product-specific help:

Nagios Support Website

The Nagios Support makes it easy to find what you need, with quick access to the Knowledge Base, Library, Support Forum, and product-specific resource pages:

Nagios Video Resources

➤ Prefer to learn visually? Our video resources walk through installation, setup, Nagios training, and more.

Nagios YouTube Channel

Explore our video tutorials, product demos, and best practices all in one place:

Nagios Webinars

Want deeper insights? Nagios Webinars offer regular sessions covering best practices, use cases, and expert tips:

Nagios Community Resources

➤ Access years of collective experience, along with support options and answers to common questions.

Nagios Support Forum

The Nagios Support Forum is an ideal place to get quick answers to “how-to” questions. Ask questions, find answers, and contribute to active discussions:

Nagios Exchange

Browse thousands of community-created plugins, add-ons, and integrations, or share your own projects with the Nagios Community.

Where to Go Next

➤ If you’re still looking for more resources, Nagios offers free one-on-one sessions with a Nagios Technician—plus free trials to help you get started.

Personalized Demo

See Nagios in action, explore key features, and discover how Nagios fits your infrastructure:

Download a Free Trial

Get a free, 30-day trial of any Nagios Enterprise Solution to try it out yourself:

Quickstart Session

Get your instance up and running, discuss your environment, and receive tailored configuration help:

There’s no single way to get started with Nagios. Some like to dig into the documentation, while others prefer more hands-on Nagios training, such as a product walkthrough or demo. However you like to learn, there’s a resource to match your style.

Have Questions? Reach Out to Us

Reach out anytime to sales@nagios.com if you have questions or need support. We’re here to help you get the most out of Nagios.

Helpful Extras to Check Out

Nagios’ Social Media

Get the latest updates and stay in the loop:

If you prefer watching a video on the installation process, you can find that below.

1. Download the CSP Package

Step 1.1: To find the CSP package, go to any browser and enter nagios.org.

Step 1.2: Down below, you can find a “Download” button that you can click.

2. Unzip and Extract

Step 2.1: Once downloaded, you will need to unzip and extract the folder by right-clicking the folder and extracting it into another folder.

Step 2.2: In the folder, you can find the following:

• “README”, “CHANGES”, and “SLICENSE” text files, which answer some basic questions, show changelogs, and give you the promo code for Nagios XI.
• An installation guide, the most recent CSP-XX.ova, which we will use to install XI.
• A folder labeled “PARTS”, where you can find all parts for Nagios Core and all plugins, as well as XI tar files.
• In the “EXTRAS” folder, you can find some more plugins and config files.
• Finally, the “A-Team” folder is a look at some of the fun times our company had through the years.

3. Open the OVA File and Finish Installation

There are many different ways to install XI. We will go over the easiest way: using the OVA file.

Step 3.1: Open the OVA file using VMware, ESXi, or vSphere.

Step 3.2: After opening, you can rename the virtual machine and select a storage path.

Step 3.3: After you have imported, make sure the network adapter is “Bridged” and then start the virtual machine.

Step 3.4: Once everything is set up, you will see an IP address listed under Nagios XI. You also have a username and password, which we recommend changing for the local host machine. After entering the IP address into a browser, there will be some settings that can be configured, such as language, time zone, etc.

Step 3.5: Once you have completed that information, you will have the option to enter a license. Then you will create a password for Nagios XI.

Step 3.6: When you finish, you will be able to log in with the credentials that you have made and dive into Nagios XI.

If you encounter any issues, there are plenty of video tutorials that you can view on our YouTube Channel.

Monitor (One of) All the Things

One key objective to focus on during your trial is to test monitoring of each type of device and application you’d like to keep tabs on. The goal isn’t to monitor everything, but to monitor at least one of everything. Odds are that you’ll be able to set up monitoring of most items quickly and easily with the built-in monitoring wizards, using standard protocols and agents. Head to the Configure > Configuration Wizards menu to access the vast directory of default options:

A great starting point to familiarize yourself with the monitoring wizard process is to monitor a website and test email notifications. This Jumpstart video will walk you through the process:

The Monitoring Configuration section of the Admin Guide is another excellent resource.

For less common requirements that you don’t see a wizard for, a good first step is to check the thousands of free plugins on the Nagios Exchange community site, and the guide to Managing Plugins in Nagios XI. Here’s a link to the Plugin Development Guidelines as well if you want to really dig in and write your own.

On the notifications front, you can find documentation on topics such as setting up email notifications, SMS notifications, Gmail SMTP, Microsoft SMTP, and Slack integration here.

Take the UI for a Spin

Your free trial period is a great time to familiarize yourself with the web interface and the main features. A great first stop is the Home menu, which is filled with status and performance visualizations in the Quick View, Details, Graphs, and Maps sections. You’ll also notice quick links to key menu locations, and ways to reach us if you need a hand with anything:

One often overlooked feature found here in the Maps section is NagVis, a powerful open source project that’s built into Nagios XI by default, which enables you to create custom maps and diagrams overlaid with active status icons. You can learn more about NagVis in this article.

Dashboards and Reports are two more popular features well worth taking the time to explore, enabling you to customize how you visualize current status data and quantify historical results.

The Visualizations section of the Admin Guide will be a big help here.

Experience Enterprise

The free trial includes full access to all of the Enterprise Edition features as well, so using the trial period to experience their value is a great idea. You can navigate to the Enterprise menu in XI to view the directory and check out this article for a detailed overview of the functions and value of each.

Architect for Success

Nagios XI can not only monitor just about anything using the built-in wizards and plugins, the thousands of plugins on the Nagios Exchange, or custom plugins you write following the development guidelines. XI can also monitor actively and passively, with both agent-based and agent-less methods. Beyond how you approach monitoring individual items, there are also broader architectural considerations to understand, especially in large or geographically dispersed environments where multiple monitoring servers and more complex network permissions come into play. Time spent reviewing the available options and determining the best approach for your needs during the free trial will pay dividends later on as you move toward fully configuring your monitoring.

Here are some useful resources on related topics:

Nagios XI Agents

Passive Monitoring with XI

Distributed Monitoring Options

Our team would be happy to offer expert guidance on architectural considerations, feel free to contact us at sales@nagios.com with any questions.

Explore Best Practices

Learning about what impacts Nagios XI performance and how to optimize your deployment for success is another worthy endeavor during your trial period. Two documents that shed light on these topics are:

Nagios XI Best Practices

Maximizing Performance in Nagios XI

GET some REST

Nagios XI has a robust REST API that can be used for a variety of purposes, including fetching object status and system data, managing monitoring configs and users, and controlling the monitoring engine programmatically. You can find full details in the Help menu:

This article is a great starting point to learn more the REST API, including use cases and API call examples.

Demos and Quickstarts

If you’d like a guided personal tour of XI geared toward your unique requirements, or a hands-on remote session with one of our techs to help you get a few things set up, we’d love to offer you a free Demo or Quickstart. To set this up, or for any other help you may need, feel free to email sales@nagios.com so we can give you a hand. Our sales and technical teams will do all they can to help you maximize your free trial!

Managing user roles and permissions in Nagios XI is crucial for maintaining security, ensuring proper access control, and streamlining administrative tasks. By assigning appropriate roles, organizations can limit access to sensitive settings while providing users with the necessary permissions to monitor and manage their systems.

This guide will walk you through the process of creating and configuring user roles and permissions in Nagios XI.

Understanding User Roles in Nagios XI

Nagios XI provides Role-Based Access Control (RBAC), which allows administrators to assign specific permissions to users based on their responsibilities. There are three key user types in Nagios XI:

• Administrators – Have full control over Nagios XI, including system settings, user management, and monitoring configurations.
• Users – Can view and manage assigned hosts, services, and dashboards, depending on their permissions.
• Guests (Read-Only Users) – Can only view system status without making any changes.

Creating and Managing Users

Step 1: Access the User Management Section

1. Log in to your Nagios XI Web Interface.
2. Navigate to Admin > Manage Users.
3. Click Add New User to create a new user account.

Step 2: Enter User Details

1. Provide the username, password, and email address.
2. Select the User Type (Admin, User, or Guest).
3. Click Submit to create the user.

Configuring User Permissions

Step 3: Assigning User Roles

Once a user is created, you can assign specific roles and permissions:

1. Navigate to Admin > Manage Users.
2. Click Edit next to the desired user.
3. Under the Security Settings, assign the appropriate role:
   • Administrator: Grants full access.
   • Regular User: Limited access based on specific permissions.
   • Read-Only User: Only allows viewing of monitoring data.
4. Click Update User to save changes.

Step 4: Defining Custom Permissions

For non-admin users, you can define more granular permissions:

1. Under the user’s settings, go to the Account Information section.
2. Click Modify User Preferences.
3. Enable or disable specific access rights, such as:
   • Viewing or managing hosts and services.
   • Access to reports and dashboards.
   • Ability to acknowledge alerts and schedule downtime.
   • Permission to edit configurations.
4. Save the changes.

Assigning Users to Monitoring Objects

To limit user access to specific hosts and services:

1. Go to Configure > CCM (Core Config Manager).
2. Select Hosts or Services.
3. Edit the object and add the user to the Monitoring Contact list.
4. Click Save and Apply Configuration.

This ensures that users can only view or manage the assigned monitoring objects.

Testing User Permissions

After configuring roles and permissions:

1. Log in as the user to verify their access.
2. Check if they can view or modify only the allowed objects.
3. Adjust settings if necessary to fine-tune access control.

Best Practices for User Role Management

• Use the Principle of Least Privilege (PoLP) – Only grant necessary permissions to users.
• Regularly Review User Roles – Ensure users have appropriate access as roles change.
• Enable Two-Factor Authentication (2FA) – Adds an extra layer of security for administrators.
• Audit User Activity – Use logs to monitor changes made by users.

Conclusion

Properly setting up user roles and permissions in Nagios XI ensures that users have access to the necessary tools while maintaining security and compliance. By following the steps outlined in this guide, you can effectively manage user access and safeguard your monitoring environment.

To learn more about Nagios XI, visit our Nagios XI Resources page.

Happy monitoring!

In this guide, we’ll walk through the steps to install and configure NCPA on macOS. Please note that a Nagios Core or Nagios XI server is required to receive monitoring data.

Prerequisites

Before proceeding with the installation, ensure that you meet the following requirements:

• A macOS system (macOS 10.13 or later).
• Administrator privileges to perform installation and configuration.
• An active Nagios Core or Nagios XI server to receive monitoring data.

Step 1: Install Homebrew (if not already installed)

Homebrew is a popular package manager for macOS. If you don’t already have it installed, you can install it by running the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 2: Download and Install the NCPA Package

As of now, Nagios doesn’t provide a direct macOS package for NCPA. However, you can use Homebrew to install it via the ncpa formula.

To install the NCPA package on macOS, run the following commands:

1. Update Homebrew (if needed):

brew update

brew update

2. Install NCPA:

brew install nagios/ncpa/ncpa

brew install nagios/ncpa/ncpa

Step 3: Start and Enable the NCPA Agent

Once the installation is complete, you can start the NCPA listener and passive services:


sudo /usr/local/ncpa/ncpa_listener -start
sudo /usr/local/ncpa/ncpa_passive -start

sudo /usr/local/ncpa/ncpa_listener -start
sudo /usr/local/ncpa/ncpa_passive -start

To ensure the services start automatically on boot, you can use the launchctl tool to manage the services:

1. Enable NCPA services to start on boot:

sudo launchctl load /Library/LaunchDaemons/com.nagios.ncpa_listener.plist
sudo launchctl load /Library/LaunchDaemons/com.nagios.ncpa_passive.plist

sudo launchctl load /Library/LaunchDaemons/com.nagios.ncpa_listener.plist
sudo launchctl load /Library/LaunchDaemons/com.nagios.ncpa_passive.plist

2. Start the services immediately:

sudo launchctl start com.nagios.ncpa_listener
sudo launchctl start com.nagios.ncpa_passive

sudo launchctl start com.nagios.ncpa_listener
sudo launchctl start com.nagios.ncpa_passive

1. Check the status of the services:bashCopysudo launchctl list | grep ncpa

Step 4: Configure NCPA

4.1 Edit the NCPA Configuration File

The NCPA configuration file is located at /usr/local/ncpa/etc/ncpa.cfg. To modify it:

1. Open the configuration file in your preferred text editor

sudo nano /usr/local/ncpa/etc/ncpa.cfg

sudo nano /usr/local/ncpa/etc/ncpa.cfg

2. Modify the following settings:

• API Token: This is required for secure communication with Nagios. Update the community_string field to something memorable:

community_string = Str0ngT0k3n!

community_string = Str0ngT0k3n!

• Allowed IPs: Restrict access to trusted Nagios servers by adding their IP addresses:

allowed_hosts = <Nagios IP address>

allowed_hosts = <Nagios IP address>

3. Save the file and exit (CTRL+X, then Y, then Enter).

4.2 Restart NCPA Services

After modifying the configuration file, restart the NCPA services for the changes to take effect:

sudo /usr/local/ncpa/ncpa_listener -restart
sudo /usr/local/ncpa/ncpa_passive -restart

sudo /usr/local/ncpa/ncpa_listener -restart
sudo /usr/local/ncpa/ncpa_passive -restart

Step 5: Verify NCPA Installation

5.1 Check the NCPA Web Interface

By default, NCPA runs on port 5693. You can access the web interface by opening a web browser and navigating to:

https://<your_mac_system>:5693

https://<your_mac_system>:5693

Log in using the API token you configured earlier.

5.2 Test NCPA with Nagios

To verify that your Nagios server can communicate with the NCPA agent, run the following command from your Nagios monitoring server:


curl -k https://<your_mac_system>:5693/api

curl -k https://<your_mac_system>:5693/api

You should receive a JSON response indicating the system’s status.

Step 6: Add NCPA to Nagios

On your Nagios XI web GUI:

• Navigate to Run a Wizard.
• Select Mac OS X.

• Enter the IP address of your macOS system and the token you created in the configuration file.
• Click Next and choose the system metrics you want to monitor, or leave everything as default. Hit Finish to complete the setup.

By following these steps, you have successfully installed Nagios Cross-Platform Agent (NCPA) on macOS. Your Nagios monitoring server will now be able to collect system metrics and monitor your macOS system in real-time.

Additional Resources

• Nagios XI Documentation
• Nagios Mac Exchange
• NCPA on Mac Support Forum

Need Help?

For further assistance, visit our support page or contact our team.

This guide will use SNMPv2c for communication.

Prerequisites

Before you begin, ensure you have the following:

• A running instance of Nagios XI (latest version recommended)
• macOS device with administrator privileges
• SNMP installed and configured on macOS
• Internet connectivity for API communication between Nagios XI and the Mac

Why Monitor Mac with SNMP?

Monitoring your Mac using SNMP helps you:

• Detect Performance Issues Proactively – Identify CPU, memory, disk, or network bottlenecks before they disrupt operations.
• Ensure Security – Track unauthorized access or abnormal system behaviors.
• Monitor System Health – Keep an eye on the system’s health status, such as temperature, battery levels, and uptime.
• Track Resource Usage – Monitor resource consumption (CPU, memory, disk) to optimize performance.

Nagios XI provides an easy-to-use interface for these tasks, allowing you to keep your system under control.

Key Metrics to Monitor

Nagios XI offers a variety of monitoring capabilities for your macOS system using SNMP. Below are key metrics that should be tracked:

System Metrics

• CPU Usage – Monitor CPU usage to ensure processes are not overloading the system.
• Memory Usage – Track memory usage to avoid system slowdowns or crashes.
• Disk Space – Monitor available storage to avoid running out of space.

Network Metrics

• Network Interfaces – Track the performance of Ethernet or Wi-Fi connections.
• Network Traffic – Measure data sent and received to monitor network bandwidth usage.

System Health Metrics

• Battery Health (for laptops) – Monitor battery health and charge percentage.
• Temperature – Track system temperature to prevent overheating.

Error Tracking

• High CPU or Memory Usage – Detect and alert on processes that may be consuming excessive resources.
• Disk Space Running Low – Get alerts when storage space is nearing full capacity.

Installation and Setup

Install Homebrew (if not already installed)

Homebrew is a popular package manager for macOS. If you don’t already have it installed, you can install it by running the following command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Step 1: Install SNMP on macOS

1. Open Terminal on your Mac.
2. Install SNMP using Homebrew by running the following command:

brew install net-snmp

brew install net-snmp

Enable SNMP:

• Edit the SNMP configuration file:

sudo nano /usr/local/etc/snmp/snmpd.conf

sudo nano /usr/local/etc/snmp/snmpd.conf

• Modify or add the following lines to configure SNMP (use a community string of your choice, e.g., public):

com2sec readonly  default         public
group   MyROGroup v1              readonly
view    all    included   .1
access  MyROGroup ""      any       noauth    exact  all    none   none

com2sec readonly  default         public
group   MyROGroup v1              readonly
view    all    included   .1
access  MyROGroup ""      any       noauth    exact  all    none   none

Start the SNMP service:

• Run the following command to start the SNMP service:

sudo snmpd

sudo snmpd

Verify SNMP is running:

• To check if SNMP is working correctly, use the following command:

snmpwalk -v 2c -c public localhost

snmpwalk -v 2c -c public localhost

This should display a list of SNMP data from your Mac.

Step 2: Configure Nagios XI

1. Log into Nagios XI and navigate to Configuration Wizards.
2. Select SNMP Wizard from the available wizards.
3. Enter SNMP Community String:
   • Enter the community string (e.g., public) that you set up in the SNMP configuration file.
4. Add your Mac’s IP address:
   • Provide the IP address of the Mac you want to monitor.
5. Choose SNMP Version:
   • Select SNMP v2c (or whichever version you’re using).
6. Select the metrics to monitor:
   • Choose metrics like CPU usage, disk space, memory usage, and network performance.
7. Set Alert Thresholds:
   • Define threshold limits for alerts, such as high CPU usage or low disk space.
8. Save and Apply the configuration.

Step 3: Configure Alerts and Notifications

1. Navigate to Notifications in Nagios XI.
2. Set threshold values for critical system metrics:
   • For instance, you can set alerts for high CPU or disk usage that exceeds the defined limits.
3. Configure notification settings:
   • Set up email, SMS, or webhook alerts to notify you about system performance or security issues.

Step 4: Analyze and Optimize

• Use Nagios XI Reports: Review system performance trends, such as CPU and memory usage over time.
• Optimize system configurations: Based on the data collected, you can optimize processes to enhance performance.

Best Practices for macOS SNMP Monitoring

Monitor Battery Health: If you are monitoring a MacBook, track battery health and charging cycles to extend the device’s longevity.

Set Up Proactive Alerts: Configure immediate alerts for critical thresholds like high CPU or disk usage.

Regularly Monitor Resources: Check memory, disk, and CPU usage to ensure optimal system performance.

Ensure System Security: Track unauthorized access attempts or security misconfigurations.

Automate Corrective Actions: Consider integrating with automation tools, like AppleScripts or custom scripts, to resolve common issues based on SNMP alerts.

Additional Resources

• Nagios XI Documentation
• Nagios Mac Exchange

Need Help?

For further assistance, visit our support page or contact our team.

To see how this is done in Nagios Log Server, check out this tutorial:

Step 1: Add a Log Source in Nagios Log Server

1. Log in to your Nagios Log Server web interface.

2. On the Home page, locate the section for adding log sources.

3. Click the + Windows button to begin the configuration process.

Step 2: Install NXLog CE on Windows Server

1. On the Nagios Log Server Windows Source page, find the Getting Started section and download NXLog CE from the provided link.

2. Run the installer on your Windows Server.

3. Click Next to the Welcome Screen.

3. Accept the License Agreement and click Next

4. Pick the destination folder to install Nagios Log Server (Default C:\Program Files\nxlog\)

5. Click Install:

5. Click Finish after a successful installation.

Step 3: Configure NXLog CE

1. On the Nagios Log Server Windows Source page, locate the Configuration Setup section.

2. Copy the provided configuration code:

Right-click and select Copy.

Click the Select All button in the top-right of the code block.

3. On your Windows Server, open Notepad as an administrator.

4. Open the NXLog configuration file:

• Navigate to C:\Program Files\nxlog\conf\
• Select All Files (.) in the file type dropdown.
• Open nxlog.conf.

5. Paste the copied configuration into the file.

6. Save and close Notepad.

Step 4: Confirm the NXLog Service is running

1. In the Windows Services App. Locate the NXLog service and confirm it’s running.

If not, you can manually start it by right-clicking on NXLog and select Start:

2. You can also run sc query NXLog. Confirm the value of STATE is RUNNING

If needed, you can manually start the service by running net start NXLog.

Step 5: Verify Logs in Nagios Log Server

1. You can verify a successful connection by going back in the Nagios Log Server > Add Log Source > Windows. In the Verify Incoming Logs section. Add the IP Address of your Windows Server and click Verify

2. Now navigate to Home. Under Unique Hosts > select View

3. Select the IP Address/Hostname of your windows server.

4. Confirm Event logs are being received:

Troubleshooting

Check NXLog Configuration File

1. Open C:\Program Files\nxlog\conf\nxlog.conf in Notepad.

2. Ensure the configuration matches the one provided by Nagios Log Server.

3. Look for syntax errors: Run NXLog manually to check for issues:

"C:\Program Files (x86)\nxlog\nxlog.exe" -v

"C:\Program Files (x86)\nxlog\nxlog.exe" -v

4. If any errors appear, correct them in nxlog.conf and restart the service.

Verify Firewall

If logs are not reaching Nagios Log Server, try:

1. On your Windows Server, confirm outbound port 3515 is open by running:

Get-NetFirewallRule -Direction Inbound, Outbound | Get-NetFirewallPortFilter | Where-Object { $_.LocalPort -eq 3515 }

Get-NetFirewallRule -Direction Inbound, Outbound | Get-NetFirewallPortFilter | Where-Object { $_.LocalPort -eq 3515 }

2. To Allow traffic for NXLog on your windows server, which uses by default outbound port 3515:

netsh advfirewall firewall add rule name="Allow NXLog" dir=out action=allow protocol=tcp localport=3515

netsh advfirewall firewall add rule name="Allow NXLog" dir=out action=allow protocol=tcp localport=3515

Enable Debugging in NXLog

If issues persist, enable debugging in NXLog:

1. Open C:\Program Files\nxlog\conf\nxlog.conf

2. Add:

LogLevel DEBUG

3. Restart NXLog:

4. Check logs in: C:\Program Files\nxlog\data\nxlog.log

If you have additional questions or other support-related questions, please visit Nagios Support. The Nagios Support Knowledgebase is also a great support resource.

This guide walks you through the steps of building a custom Nagios XI plugin, using a simple script that monitors the last 1-minute load average of the host.

This article will go over these following steps:

• Creating a bash script plugin in the Nagios XI host
  • Includes testing the script
• Adding the script as a Command in Nagios XI
• Using the Command to make a monitoring Service
• Where to find more options for the Service

Step 1: Create a Bash Script Plugin in Nagios XI

In order to write a script in the Nagios XI host, you must first log in using the root user.

Use the following commands to get to the directory that holds all of the plugins for Nagios XI. Nano is a text editor that will be used to make the script.

cd /usr/local/nagios/libexec
nano check_load_average.sh

cd /usr/local/nagios/libexec
nano check_load_average.sh

Now that you are in nano, you can start writing your script. The script below takes in the threshold arguments passed in through the command and sets the variables to those values. Then it compares the load value with the threshold values (critical and warning) and returns a message based on how it compared to the thresholds.

You can find the following code here: https://github.com/NagiosEnterprises/plugins-extra/tree/check_load_average.

#!/bin/bash

# Variables
LOAD_AVG=""
WARN=""
CRIT=""


# Parse arguments
while getopts "w:c:" arg; do
  case $arg in
    w) WARN=${OPTARG} ;;
    c) CRIT=${OPTARG} ;;
  esac
done


# Validate args
if [[-z "$WARN" || -z "$CRIT" ]]; then
  echo "UNKNOWN - Invalid arguments. USAGE: $0 -w <warning_threshold> -c <critical_threshold>"
  echo "w: $WARN c: $CRIT"
  exit 3
fi


# Set load average variable
LOAD_AVG=$(uptime | awk -F 'load average: ' '{print $2}' | cut -d',' -f1)


# Compare with thresholds | give computer readable info for performance graphs
if (( $(echo "$LOAD_AVG > $CRIT" | bc -l) )); then
  echo "CRITICAL - Load Average is $LOAD_AVG in the last minute (threshold: $CRIT) | loadaverage=$LOAD_AVG"
  exit 2
elif (( $(echo "$LOAD_AVG > $WARN" | bc -l) )); then
  echo "WARNING - Load Average is $LOAD_AVG in the last minute (threshold: $WARN) | loadaverage=$LOAD_AVG"
  exit 1
else
  echo "OK - Load Average is $LOAD_AVG in the last minute | loadaverage=$LOAD_AVG"
  exit 0
fi

#!/bin/bash

# Variables
LOAD_AVG=""
WARN=""
CRIT=""


# Parse arguments
while getopts "w:c:" arg; do
  case $arg in
    w) WARN=${OPTARG} ;;
    c) CRIT=${OPTARG} ;;
  esac
done


# Validate args
if [[-z "$WARN" || -z "$CRIT" ]]; then
  echo "UNKNOWN - Invalid arguments. USAGE: $0 -w <warning_threshold> -c <critical_threshold>"
  echo "w: $WARN c: $CRIT"
  exit 3
fi


# Set load average variable
LOAD_AVG=$(uptime | awk -F 'load average: ' '{print $2}' | cut -d',' -f1)


# Compare with thresholds | give computer readable info for performance graphs
if (( $(echo "$LOAD_AVG > $CRIT" | bc -l) )); then
  echo "CRITICAL - Load Average is $LOAD_AVG in the last minute (threshold: $CRIT) | loadaverage=$LOAD_AVG"
  exit 2
elif (( $(echo "$LOAD_AVG > $WARN" | bc -l) )); then
  echo "WARNING - Load Average is $LOAD_AVG in the last minute (threshold: $WARN) | loadaverage=$LOAD_AVG"
  exit 1
else
  echo "OK - Load Average is $LOAD_AVG in the last minute | loadaverage=$LOAD_AVG"
  exit 0
fi

To close nano, use the keys ^X, y, then [Enter]

When you first close the script, you will not have permission to execute it. To get permission use the following commands:

chmod +x /usr/local/nagios/libexec/check_load_average.sh

chmod +x /usr/local/nagios/libexec/check_load_average.sh

To make sure the script is working properly, type in this command and substitute the parameters:

./check_load_average.sh -w <warning_threshold> -c <critical_threshold>

./check_load_average.sh -w <warning_threshold> -c <critical_threshold>

The output could be one of four options. It would appear like this:

# An Unknown Response 
UNKNOWN - Invalid arguments. USAGE: $0 -w <warning_threshold> -c <critical_threshold>

# A Critical Response
CRITICAL - Load Average is 1.26 in the last minute (threshold: .04) | loadaverage=1.26

# A Warning Response
WARNING - Load Average is 0.83 in the last minute (threshold: .3) | loadaverage=0.83

# An OK Response
OK - Load Average is 2.21 in the last minute | loadaverage=2.21

# An Unknown Response 
UNKNOWN - Invalid arguments. USAGE: $0 -w <warning_threshold> -c <critical_threshold>

# A Critical Response
CRITICAL - Load Average is 1.26 in the last minute (threshold: .04) | loadaverage=1.26

# A Warning Response
WARNING - Load Average is 0.83 in the last minute (threshold: .3) | loadaverage=0.83

# An OK Response
OK - Load Average is 2.21 in the last minute | loadaverage=2.21

Step 2: Setting up a Command in Nagios XI

Now that the script is running in the host, the next step is to add it as a command. To do that, go to Core Configuration Manager and go to Commands.

At the top of the Commands page is button, select + Add New.

Fill out the fields. It should look like this after.

Select Save. At the top right of the Command page will be a message saying Apply Configuration. Go through the apply configuration process.

Step 3: Setting Up a Service in Nagios XI

On the side bar, go under Monitoring and select Services.

An easy way to get a new service up and running is to copy an existing service and edit it to fit your needs. To do that, go under actions and select copy on any of services. The copied service will be inactive and unapplied. Select the edit icon under actions to make the changes to fit the plugin.

Change the Config Name and other fields to whatever values you want. Make sure to select Active on the bottom left. The other settings tabs can also be changed to fit specific needs.

At the bottom right of the Common Settings tab, is a Run Check Command button. This can be used to test if the command works as expected before saving the changes.

When the settings are all complete, select Save. A message will appear on the top of the service page saying that changes were made, and you need to Apply Configuration. Follow that process the same as you did with Commands.

Where to Find More Service Settings

On the Home page under Details, select Service Status. This will bring up all the services that are being used.

Find the New Service you just created and select it. The Service Status Detail page will show up with multiple tabs of more settings.

Now you have the steps to make your own Nagios Plugin.

For More Help

For any support related questions please visit the Nagios Support Forums at:

http://support.nagios.com/forum/,