Hidra allows you to monitor the status of your services without headaches.
Precompiled binaries for released versions are available in the release section on Github. Using the latest production release binary is the recommended way of installing Hidra. You can find latest release here
Docker images are available on Github Container Registry.
If you want to install Hidra easily, please use the package repositories.
curl https://repo.hidra.cloud/apt/gpg.key | sudo apt-key add -
echo "deb [trusted=yes] https://repo.hidra.cloud/apt /" | sudo tee /etc/apt/sources.list.d/hidra.list
apt install -y hidra
curl https://repo.hidra.cloud/rpm/gpg.key | sudo rpm --import -
echo "[hidra]" | sudo tee /etc/yum.repos.d/hidra.repo
echo "name=Hidra" | sudo tee -a /etc/yum.repos.d/hidra.repo
echo "baseurl=https://repo.hidra.cloud/rpm/" | sudo tee -a /etc/yum.repos.d/hidra.repo
echo "enabled=1" | sudo tee -a /etc/yum.repos.d/hidra.repo
echo "gpgcheck=1" | sudo tee -a /etc/yum.repos.d/hidra.repo
yum install -y hidra
After installing Hidra, test the installation by running:
By default, Hidra will install one systemd unit for running hidra exporter, disabled by default. You can enable it by running:
systemctl enable hidra_exporter --now
You can modify the behaviour of exporter by editing the file
/etc/hidra_exporter/config.yml, and you can add samples directly to /etc/hidra_exporter/samples/ folder, and after adding them, you can reload the service by running:
systemctl reload hidra_exporter
You can use the install script to install Hidra on your system. The script will download the latest release binary and install it in your system. You can find the script here.
sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/hidracloud/hidra/main/install.sh)"
To build Hidra from source code, you need:
- Go version 1.19 or greater.
To build Hidra, run the following command:
goreleaser release --snapshot --rm-dist
You can find the binaries in the
Hidra has support for exposing metrics to Prometheus. If you want to use Hidra in exporter mode, run:
hidra exporter /etc/hidra/exporter.yml
You can find an example of the configuration file here
You can find a Grafana dashboard here
Hidra has support for running in test mode. Test mode will allow you to run one time a set of samples, and check if the results are as expected. If you want to use Hidra in test mode, run:
hidra test sample1.yml sample2.yml ... samplen.yml
If you want to exit on error, just add the flag
You can find some sample examples here
You can find an example of a docker compose file here
Samples are the way Hidra knows what to do. A sample is a YAML file that contains the information needed to run a test. You can find some sample examples here. You can also find a sample example below:
# Description of the sample
description: "This is a sample to test the HTTP plugin"
# Tags is a key-value list of tags that will be added to the sample. You can add here whatever you want.
# Interval is the time between each execution of the sample.
# Timeout is the time that Hidra will wait for the sample to finish.
# Steps is a list of steps that will be executed in order.
# Plugin is the name of the plugin that will be used to execute the step.
- plugin: http
# Action is the action that will be executed by the plugin.
# Parameters is a key-value list of parameters that will be passed to the plugin.
- plugin: http
You can find more information about plugins in next section.