Skip to content

ADORSYS-GIS/wazuh-agent-status

Repository files navigation

Wazuh Agent Status

Release Client

Wazuh Agent Status is an application designed to monitor the state of Wazuh agents. This tool provides real-time insights into the operational status of agents, ensuring they are functioning correctly and efficiently.

Key Features

  • Real-time Status Monitoring: Constantly monitors each Wazuh agent, updating statuses directly within your system tray.

  • Status and Connection Indicators: Uses color-coded icons to show agent activity (Active/Inactive) and connection status (Connected/Disconnected).

  • Control Options: Easily manage agents through the tray menu with options to pause, restart, or quit the agent.

  • Cross-Platform Compatibility: Compatible with Linux, macOS, and Windows.

  • Embedded Icons: Custom, embedded icons ensure immediate visual recognition for easy status assessment.

Core Functionalities

  • Instant Agent Status Updates: The system tray displays live updates on each agent’s operational state, ensuring administrators can act promptly if issues arise.

  • Connection Health Validation: Regular checks confirm each agent’s connection integrity, with clear indications for connection loss or re-establishment.

Installation from code

To install the application, follow these steps:

  1. Clone the repository:
    git clone https://github.com/ADORSYS-GIS/wazuh-agent-status.git
  2. Navigate to the project directory:
    cd wazuh-agent-status
  3. Install dependencies:
    go mod tidy
    go mod download
    
    ### Additional steps for Ubuntu
    sudo apt-get update
    sudo apt-get install -y libayatana-appindicator3-dev

Building Binaries

You can build binaries for different systems using this command:

  • Cross Platform build For Linux, macOS and Windows:
      GOOS=linux GOARCH=amd64 go build -o dist/wazuh-agent-status-linux
      GOOS=darwin GOARCH=amd64 go build -o dist/wazuh-agent-status-macos
      GOOS=windows GOARCH=amd64 go build -o dist/wazuh-agent-status-windows

Note: Ensure you have a suitable C compiler installed on your system for this to work.

Quick Start

After building or installing the binary, you can start the application as follows:

Run the application with:

./dist/wazuh-agent-status

Alternative Installation

Run the following commands to install the app

  • Ubuntu and macOS

    1. Admin app

    curl -sL https://raw.githubusercontent.com/ADORSYS-GIS/wazuh-agent-status/main/scripts/install.sh | PROFILE=admin sh
    1. Simple users app

    curl -sL https://raw.githubusercontent.com/ADORSYS-GIS/wazuh-agent-status/main/scripts/install.sh | sh

After installation, launch the application with:

wazuh-agent-status