rsca

module
v0.8.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Feb 13, 2024 License: GPL-3.0

README

rsca

ci GoDoc GitHub issues GitHub forks GitHub stars GitHub license

Remote Service Check Acceptor (alternative to NSCA)

Design

Three components:

  • rsc: admin client.
  • rsca: check client, executes checks on servers.
  • rscad: check daemon, receives check results and writes them to the nagios command file.

Deployment

rsc tool

This can be run on any host with network access to the rscad server.

rsca service

This should be run on the server to check, it runs the checks in the config file and sends them to rscad on schedule.

Copy rsca.service to /etc/systemd/system/rsca.service. Copy rsca.toml to /etc/nagios/rsca.toml.

rscad service

This should be run on the nagios server, it handles the connections from the rsca clients.

Copy rscad.service to /etc/systemd/system/rscad.service.

Support

Reach out to the maintainer at one of the following places:

GitHub discussions GitHub issues The email which is located in GitHub profile.

Directories

Path Synopsis
Package api contains the RSCA protobuf files and definitions.
Package api contains the RSCA protobuf files and definitions.
Package client handles satisfying the api.RSCAClient interface for the gRPC connection to the server.
Package client handles satisfying the api.RSCAClient interface for the gRPC connection to the server.
cmd
rsc
internal
checks
Package checks contains the Check handlers and helper functions for calling processes and returning results.
Package checks contains the Check handlers and helper functions for calling processes and returning results.
common
Package common contains helper functions and calls that don't belong to other parts of the project.
Package common contains helper functions and calls that don't belong to other parts of the project.
mainconfig
Package mainconfig contains the configuration defaults that span the admin client, the server and the client.
Package mainconfig contains the configuration defaults that span the admin client, the server and the client.
metrics
Package metrics contains the prometheus metrics handlers and hooks.
Package metrics contains the prometheus metrics handlers and hooks.
register
Package register contains the RegistrationMessage and all helper methods for generating the message.
Package register contains the RegistrationMessage and all helper methods for generating the message.
state
Package state contains the interface and a disk-based implementation of a state storage for connected member clients.
Package state contains the interface and a disk-based implementation of a state storage for connected member clients.
Package server handles satisfying the api.RSCAServer interface for the gRPC connection from the clients.
Package server handles satisfying the api.RSCAServer interface for the gRPC connection from the clients.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL