EaseProbe is a simple, standalone, and lightweight tool that can do health/status checking, written in Go.
- 1. Introduction
- 2. Getting Started
- 3. Deployment
- 4. User Manual
- 5. Benchmark
- 6. Contributing
- 7. Community
- 8. License
EaseProbe is designed to do three kinds of work - Probe, Notify, and Report.
EaseProbe supports a variety of methods to perform its probes such as:
- HTTP. Checking the HTTP status code, Support mTLS, HTTP Basic Auth, setting Request Header/Body, and XPath response evaluation. ( HTTP Probe Manual )
- TCP. Check whether a TCP connection can be established or not. ( TCP Probe Manual )
- Ping. Ping a host to see if it is reachable or not. ( Ping Probe Manual )
- Shell. Run a Shell command and check the result. ( Shell Command Probe Manual )
- SSH. Run a remote command via SSH and check the result. Support the bastion/jump server (SSH Command Probe Manual)
- TLS. Connect to a given port using TLS and (optionally) validate for revoked or expired certificates ( TLS Probe Manual )
- Host. Run an SSH command on a remote host and check the CPU, Memory, and Disk usage. ( Host Load Probe Manual )
- Client. The following native clients are supported. They all support mTLS and data checking. ( Native Client Probe Manual )
- MySQL. Connect to a MySQL server and run the
SHOW STATUS
SQL. - Redis. Connect to a Redis server and run the
PING
command. - Memcache. Connect to a Memcache server and run the
version
command or validate a given key/value pair. - MongoDB. Connect to a MongoDB server and perform a ping.
- Kafka. Connect to a Kafka server and perform a list of all topics.
- PostgreSQL. Connect to a PostgreSQL server and run
SELECT 1
SQL. - Zookeeper. Connect to a Zookeeper server and run
get /
command.
- MySQL. Connect to a MySQL server and run the
EaseProbe supports notification delivery to the following:
- Slack. Using Slack Webhook for notification delivery
- Discord. Using Discord Webhook for notification delivery
- Telegram. Using Telegram Bot for notification delivery
- Teams. Support the Microsoft Teams notification delivery
- Email. Support email notification delivery to one or more email addresses
- AWS SNS. Support the AWS Simple Notification Service
- WeChat Work. Support Enterprise WeChat Work notification delivery
- DingTalk. Support the DingTalk notification delivery
- Lark. Support the Lark(Feishu) notification delivery
- SMS. SMS notification delivery with support for multiple SMS service providers
- Log. Write the notification into a log file or Syslog.
- Shell. Run a shell command to deliver the notification (see example)
- RingCentral. Using RingCentral Webhook for notification delivery
Note:
The notification is Edge-Triggered Mode by default, if you want to config it as Level-Triggered Mode with different interval and max notification, please refer to the manual - Alerting Interval.
Windows platforms do not support syslog as notification method.
Check the Notification Manual to see how to configure it.
EaseProbe supports the following report and metrics:
- SLA Report Notify. EaseProbe would send the daily, weekly, or monthly SLA report using the defined
notify:
methods. - SLA Live Report. The EaseProbe would listen on the
0.0.0.0:8181
port by default. By accessing this service you will be provided with a live SLA report either as HTML athttp://localhost:8181/
or as JSON athttp://localhost:8181/api/v1/sla
- SLA Data Persistence. The SLA data will be persisted in
$CWD/data/data.yaml
by default. You can configure this path by editing thesettings
section of your configuration file.
For more information, please check the Global Setting Configuration
- Prometheus Metrics. The EaseProbe would listen on the
8181
port by default. By accessing this service you will be provided with Prometheus metrics athttp://easeprobe:8181/metrics
.
The metrics are prefixed with easeprobe_
and are documented in Prometheus Metrics Exporter
You can get started with EaseProbe, by any of the following methods:
- Download the release for your platform from https://github.com/megaease/easeprobe/releases
- Use the available EaseProbe docker image
docker run -it megaease/easeprobe
- Build
easeprobe
from sources
Compiler Go 1.21+
(Generics Programming Support), checking the Go Installation to see how to install Go on your platform.
Use make
to build and produce the easeprobe
binary file. The executable is produced under the build/bin
directory.
$ make
Read the User Manual for detailed instructions on how to configure all EaseProbe parameters.
Create a configuration file (eg. $CWD/config.yaml
) using the configuration template at ./resources/config.yaml, which includes the complete list of configuration parameters.
The following simple configuration example can be used to get started:
http: # http probes
- name: EaseProbe Github
url: https://github.com/megaease/easeprobe
notify:
log:
- name: log file # local log file
file: /var/log/easeprobe.log
settings:
probe:
timeout: 30s # the time out for all probes
interval: 1m # probe every minute for all probes
You can check the EaseProbe JSON Schema section to use a JSON Scheme file to make your life easier when you edit the configuration file.
You can run the following command to start EaseProbe once built
$ build/bin/easeprobe -f config.yaml
-f
configuration file or URL or path for multiple files which will be automatically merged into one. Can also be achieved by setting the environment variablePROBE_CONFIG
-d
dry run. Can also be achieved by setting the environment variablePROBE_DRY
EaseProbe can be deployed by Systemd, Docker, Docker-Compose, & Kubernetes.
You can find the details in Deployment Guide
For detailed instructions and features please refer to the User Manual
We have performed an extensive benchmark on EaseProbe. For the benchmark results please refer to - Benchmark Report
If you're interested in contributing to the project, please spare a moment to read our CONTRIBUTING Guide
- Join Slack Workspace for requirements, issues, and development.
- MegaEase on Twitter
EaseProbe is under the Apache 2.0 license. See the LICENSE file for details.