News and blog
NXLog main page
  • Products
    NXLog Platform
    Log collection
    Log management and analytics
    Log storage
    NXLog Community Edition
    Integrations
    Professional Services
  • Solutions
    Use cases
    Specific OS support
    SCADA/ICS
    Windows event log
    DNS logging
    MacOS logging
    Solutions by industry
    Financial Services
    Government & Education
    Entertainment & Gambling
    Telecommunications
    Medical & Healthcare
    Military & Defense
    Law Firms & Legal Counsel
    Industrial & Manufacturing
  • Plans
  • Partners
    Find a Reseller
    Partner Program
  • Resources
    Documentation
    Blog
    White papers
    Videos
    Webinars
    Case Studies
    Community Program
    Community Forum
  • About
    Company
    Careers
  • Support
    Support portals
    Contact us

NXLog Platform
Log collection
Log management and analytics
Log storage
NXLog Community Edition
Integrations
Professional Services

Use Cases
Specific OS support
SCADA/ICS
Windows event log
DNS logging
MacOS logging
Solutions by industry
Financial Services
Government & Education
Entertainment & Gambling
Telecommunications
Medical & Healthcare
Military & Defense
Law Firms & Legal Counsel
Industrial & Manufacturing


Find a Reseller
Partner Program

Documentation
Blog
White papers
Videos
Webinars
Case Studies
Community Program
Community Forum

Company
Careers

Support portals
Contact us
Let's Talk Start free
NXLog search
  • Loading...
Let's Talk Start free
April 30, 2025 deployment

Monitoring NXLog Agent with Zabbix using the Agent Management API

By Arielle Bonnici

Share
ALL SIEM STRATEGY SECURITY ANNOUNCEMENT DEPLOYMENT COMPLIANCE COMPARISON RSS

NXLog Agent plays a vital role in aggregating, processing, and forwarding logs to centralized platforms for analysis. Whether it’s system logs, application logs, or security audit trails, these agents are often the first line of visibility into what’s happening in your environment.

In many setups, especially large-scale infrastructures, NXLog Agent relays act as crucial intermediaries, collecting logs from edge systems and forwarding them to a SIEM or log analytics platform. Given their role, it is essential to ensure critical NXLog Agent instances are running reliably.

On the other hand, Zabbix is a highly flexible monitoring platform used to track the performance and availability of your IT infrastructure. By combining the two, you can detect issues early and maintain your logging infrastructure’s integrity. In this post, we’ll look at how to monitor NXLog Agent using Zabbix leveraging the NXLog Platform Agent Management API. We’ll walk through adding your NXLog Agent host to Zabbix, and creating items and triggers. We also provide the complete configuration as a Zabbix template to help you get started quickly.

Why Monitor NXLog Agent?

Given that NXLog Agent plays a critical role in your logging pipeline, it’s essential to have visibility into its status and performance. Monitoring your NXLog Agent instances ensures that:

  • The agent is running and healthy — Ensuring that NXLog Agent has not been stopped, intentionally or otherwise, is fundamental.

  • Log collection and forwarding are operating as expected — NXLog Agent not receiving or collecting new logs may result from unexpected infrastructure changes or an issue at the log source.

  • Errors or misconfigurations are detected promptly — Syntax errors in configuration files or incorrect parameters can silently break log collection.

  • Resource usage is within acceptable limits — Excessive resource usage may indicate a configuration not optimal for the actual load.

What is the NXLog Platform Agent Management API?

The NXLog Platform Agent Management API is a RESTful interface that allows you to:

  • Enroll and configure NXLog Agent instances.

  • Check the current status of agents.

  • View configuration and runtime statistics.

  • Retrieve agent logs and diagnostic information.

  • Perform administrative tasks such as renewing agent TLS/SSL certificates.

The Agent Management API is particularly useful for automated systems like Zabbix that can query endpoints, parse responses, and trigger alerts based on specific conditions. Monitoring NXLog Agent via the Agent Management API offers several key benefits:

  • Real-time insight — You get immediate access to runtime data, which can help diagnose issues proactively before they escalate.

  • Lightweight and agentless — Using Zabbix’s HTTP agent means no need for additional scripts or agents, just native functionality.

  • Scalability — Once set up, you can apply the same approach to monitor multiple systems, especially when paired with Zabbix templates.

Setting up Zabbix to monitor NXLog Agent

Now, let’s put words into action and set up Zabbix to monitor an NXLog Agent instance. We tested this setup with Zabbix 7.2.5 and NXLog Platform 1.5.

In this example, we’ll monitor the agent’s online status, whether it’s enrolled and configured, the CPU load, and memory usage. See Agent properties in the documentation for a complete list of properties you can retrieve. Skip to Sample Zabbix template if you’re familiar with Zabbix and want to save time on configuration.

Prerequisites

Before proceeding, ensure you have the following:

  • Administrative access to Zabbix. See Getting Zabbix if you don’t have it installed already.

  • NXLog Platform installed and configured.

  • An NXLog Agent instance connected to NXLog Platform.

  • Your NXLog Platform organization ID.

  • An NXLog Platform API token.

Add the NXLog Agent host

  1. Open the Zabbix web interface and navigate to Data collection > Hosts.

  2. Click the Create host button in the top right corner.

  3. Enter the Host name, Host group, and any other optional information.

    Adding a new host in Zabbix
  4. Click the Add button to finish adding the host.

Create an HTTP item

  1. Navigate to Data collection > Hosts, find your host, and click Items.

  2. Click the Create item button in the top right corner.

  3. Enter a Name and Key for the new item.

  4. Set the Type to HTTP Agent.

  5. Set the Type of information to Text.

  6. Enter your NXLog Platform Agent Management API URL. For example, https://agents.example.com/api/<ORG_ID>/api/v1/agents/*/, where example.com is your NXLog Platform domain and <ORG_ID> is your NXLog Platform organization ID.

  7. Add the following Query fields:

    • fields — online,enrolled,configured,cpu-load,memory-used

    • filter — (hostname={HOST.NAME})

  8. Set the Request type to GET.

  9. Add the following Header, replacing <API_TOKEN> with your NXLog Platform API token.

    • Authorization — Bearer <API_TOKEN>

  10. Your settings should look similar to the following screenshot:

    Adding an item in Zabbix
  11. Click the Add button to finish adding the item.

Create triggers

  1. Navigate to Data collection > Hosts, find your host, and click Triggers.

  2. Click the Create trigger button in the top right corner.

  3. Enter a trigger Name. For example, NXLog Agent offline.

  4. Choose the relevant Severity.

  5. Click the Add button next to the Expression field.

  6. Select the Item you just created.

  7. Set the Function to jsonpath().

  8. Enter the JSONPath. For example, $.[0].online.

  9. Set the Result to = and false.

    Adding a trigger in Zabbix
  10. Click the Insert button.

  11. Click the Add button to finish adding the trigger.

  12. Repeat these steps for every property you want to monitor.

Test your configuration

Once you’ve set up Zabbix to monitor NXLog Agent, you can test your configuration by temporarily stopping the NXLog Agent service and verifying that Zabbix detects the problem.

  1. Navigate to Data collection > Hosts, find your host, and click Items.

  2. Select your new item and click the Execute now button.

  3. Navigate to Monitoring > Problems, and the page should list the NXLog Agent offline as a problem.

    Problem monitorng in Zabbix

Sample Zabbix template

To make testing easier, we’ve prepared a Zabbix template with the configuration described above. To apply the template:

  1. Download zbx_nxlog_agent_template.yaml.

  2. Open Zabbix and navigate to Data collection > Templates.

  3. Click the Import button in the top right corner.

  4. Choose the zbx_nxlog_agent_template.yaml file and click Import.

  5. Click Import again to finish importing the template.

Once you’ve imported the template, configure it with your settings:

  1. Click on the template name NXLog Agent by HTTP.

  2. Switch to the Macros tab.

  3. Set the value of {$NXLOG_API_TOKEN} to your NXLog Platform API token.

  4. Update the value of {$NXLOG_PLATFORM}:

    • Replace example.com with your NXLog Platform domain.

    • Replace ORG_ID with your NXLog Platform organization ID.

  5. Click the Update button to save the settings.

Finally, follow the steps to Add the NXLog Agent host and select the NXLog Agent by HTTP template under Templates/Applications.

Adding a new hos in Zabbix

Closing thoughts

Monitoring NXLog Agent with Zabbix through the Agent Management API is a powerful way to maintain visibility into your logging pipeline. This method provides richer data, enhancing your observability setup and ensuring logs are collected and forwarded without disruption.

In this blog post, we’ve only touched the surface of what you can do with the NXLog Platform Agent Management API. We invite you to check out the Agent Management API documentation for in-depth information and how-tos. Our blog post on Installing and enrolling NXLog Agent automatically with Ansible and the Agent Management API might also interest you.

NXLog Platform is an on-premises solution for centralized log management with
versatile processing forming the backbone of security monitoring.

With our industry-leading expertise in log collection and agent management, we comprehensively
address your security log-related tasks, including collection, parsing, processing, enrichment, storage, management, and analytics.

Start free Contact us
  • agent management
  • monitoring
Share

Facebook Twitter LinkedIn Reddit Mail
Related Posts

The benefits of log aggregation
8 minutes | August 1, 2022
Install and enroll NXLog Agent automatically with Ansible and the Agent Management API
9 minutes | February 10, 2025
How to choose a log management solution
14 minutes | January 6, 2025

Stay connected:

Sign up

Keep up to date with our monthly digest of articles.

By clicking singing up, I agree to the use of my personal data in accordance with NXLog Privacy Policy.

Featured posts

Announcing NXLog Platform 1.6
April 22, 2025
Announcing NXLog Platform 1.5
February 27, 2025
Announcing NXLog Platform 1.4
December 20, 2024
NXLog redefines log management for the digital age
December 19, 2024
2024 and NXLog - a review
December 19, 2024
Announcing NXLog Platform 1.3
October 25, 2024
NXLog redefines the market with the launch of NXLog Platform: a new centralized log management solution
September 24, 2024
Welcome to the future of log management with NXLog Platform
August 28, 2024
Announcing NXLog Enterprise Edition 5.11
June 20, 2024
Raijin announces release of version 2.1
May 31, 2024
Ingesting log data from Debian UFW to Loki and Grafana
May 21, 2024
Announcing NXLog Enterprise Edition 6.3
May 13, 2024
Raijin announces release of version 2.0
March 14, 2024
NXLog Enterprise Edition on Submarines
March 11, 2024
The evolution of event logging: from clay tablets to Taylor Swift
February 6, 2024
Migrate to NXLog Enterprise Edition 6 for our best ever log collection experience
February 2, 2024
Raijin announces release of version 1.5
January 26, 2024
2023 and NXLog - a review
December 22, 2023
Announcing NXLog Enterprise Edition 5.10
December 21, 2023
Raijin announces release of version 1.4
December 12, 2023
Announcing NXLog Enterprise Edition 6.2
December 4, 2023
Announcing NXLog Manager 5.7
November 3, 2023
Announcing NXLog Enterprise Edition 6.1
October 20, 2023
Raijin announces release of version 1.3
October 6, 2023
Upgrading from NXLog Enterprise Edition 5 to NXLog Enterprise Edition 6
September 11, 2023
Announcing NXLog Enterprise Edition 6.0
September 11, 2023
The cybersecurity challenges of modern aviation systems
September 8, 2023
Raijin announces release of version 1.2
August 11, 2023
The Sarbanes-Oxley (SOX) Act and security observability
August 9, 2023
Log Management and PCI DSS 4.0 compliance
August 2, 2023
Detect threats using NXLog and Sigma
July 27, 2023
HIPAA compliance logging requirements
July 19, 2023
Announcing NXLog Enterprise Edition 5.9
June 20, 2023
Industrial cybersecurity - The facts
June 8, 2023
Raijin announces release of version 1.1
May 30, 2023
CISO starter pack - Security Policy
May 2, 2023
Announcing NXLog Enterprise Edition 5.8
April 24, 2023
CISO starter pack - Log collection fundamentals
April 3, 2023
Raijin announces release of version 1.0
March 9, 2023
Avoid vendor lock-in and declare SIEM independence
February 13, 2023
Announcing NXLog Enterprise Edition 5.7
January 20, 2023
NXLog - 2022 in review
December 22, 2022
Need to replace syslog-ng? Changing to NXLog is easier than you think
November 23, 2022
The EU's response to cyberwarfare
November 22, 2022
Looking beyond Cybersecurity Awareness Month
November 8, 2022
GDPR compliance and log data
September 23, 2022
NXLog in an industrial control security context
August 10, 2022
Raijin vs Elasticsearch
August 9, 2022
NXLog provides native support for Google Chronicle
May 11, 2022
Aggregating macOS logs for SIEM systems
February 17, 2022
How a centralized log collection tool can help your SIEM solutions
April 1, 2020

Categories

  • SIEM
  • STRATEGY
  • SECURITY
  • ANNOUNCEMENT
  • DEPLOYMENT
  • COMPLIANCE
  • COMPARISON
logo

Subscribe to our newsletter to get the latest updates, news, and products releases. 

© Copyright 2024 NXLog FZE.

Privacy Policy. General Terms of Use

Follow us

  • Product
  • NXLog Platform 
  • Log collection
  • Log management and analysis
  • Log storage
  • Integration
  • Professional Services
  • Plans
  • Resources
  • Documentation
  • Blog
  • White papers
  • Videos
  • Webinars
  • Case studies
  • Community Program
  • Community forum
  • Support
  • Getting started guide
  • Support portals
  • About NXLog
  • About us
  • Careers
  • Find a reseller
  • Partner program
  • Contact us