Cougar

LGTM Stack Playground

Usage

1. Install docker and docker-compose.

$ apt-get update
$ apt-get upgrade -y

$ apt install docker.io docker-compose -y
$ systemctl enable docker

2. Run the docker containers.

$ docker-compose up -d

Grafana Alloy

To install and run alloy on hosts

$ mkdir -p /opt/alloy
$ mkdir -p /var/lib/alloy

$ cd /tmp
$ wget https://github.com/grafana/alloy/releases/download/v1.1.1/alloy-linux-amd64.zip
$ unzip alloy-linux-amd64.zip

$ mv alloy-linux-amd64 /opt/alloy/agent

$ groupadd -f alloy
$ useradd -g alloy --no-create-home --shell /bin/false alloy

$ chown -R alloy:alloy /opt/alloy
$ chown -R alloy:alloy /var/lib/alloy

Create /opt/alloy/config.alloy from config.alloy in this repo. Then run alloy as a systemd service.

$ echo "[Unit]
Description=Alloy
Documentation=https://github.com/grafana/alloy
Wants=network-online.target
After=network-online.target

[Service]
User=alloy
Group=alloy
Type=simple
Restart=on-failure
Environment="REMOTE_LOKI_WRITE_URL=http://X.X.X.X:3100/loki/api/v1/push"
Environment="REMOTE_PROMETHEUS_WRITE_URL=http://X.X.X.X:9090/api/v1/write"
Environment="REMOTE_PROMETHEUS_USERNAME=admin"
Environment="REMOTE_PROMETHEUS_PASSWORD=password"
ExecStart=/opt/alloy/agent run --storage.path=/var/lib/alloy /opt/alloy/config.alloy

[Install]
WantedBy=multi-user.target" > /etc/systemd/system/alloy.service

$ systemctl daemon-reload
$ systemctl enable alloy.service
$ systemctl start alloy.service

Versioning

For transparency into our release cycle and in striving to maintain backward compatibility, Cougar is maintained under the Semantic Versioning guidelines and release process is predictable and business-friendly.

See the Releases section of our GitHub project for changelogs for each release version of Cougar. It contains summaries of the most noteworthy changes made in each release. Also see the Milestones section for the future roadmap.

Bug tracker

If you have any suggestions, bug reports, or annoyances please report them to our issue tracker at https://github.com/Uptimedog/Cougar/issues

Security Issues

If you discover a security vulnerability within Cougar, please send an email to hello@clivern.com

Contributing

We are an open source, community-driven project so please feel free to join us. see the contributing guidelines for more details.

License

© 2023, Clivern. Released under MIT License.

Cougar is authored and maintained by @clivern.