Gregpaskal: Created page with "{{: Header_Nav}} = The following steps were used to set up a monitoring solution. = ---- = Prepare a base VM = Let's begin by making a new VM based on the VM_Deb12_Master_v02 ---- = Install Prometheus = == Ensure apt is up to date == `sudo apt update` == Install Prometheus == `sudo apt install prometheus` == Verify Prometheus is installed == `systemctl status prometheus` == Configuring Prometheus == * By default, Prometheus..."

2025-04-05T03:49:00Z

Created page with "{{: Header_Nav}} = The following steps were used to set up a monitoring solution. = ---- = Prepare a base VM = Let's begin by making a new VM based on the VM_Deb12_Master_v02 ---- = Install Prometheus = == Ensure apt is up to date == <code>sudo apt update</code> == Install Prometheus == <code>sudo apt install prometheus</code> == Verify Prometheus is installed == <code>systemctl status prometheus</code> == Configuring Prometheus == * By default, Prometheus..."

New page

{{: Header_Nav}}

= The following steps were used to set up a monitoring solution. =

----

= Prepare a base VM =

Let's begin by making a new VM based on the VM_Deb12_Master_v02

----

= Install Prometheus =

== Ensure apt is up to date ==

<code>sudo apt update</code>

== Install Prometheus ==

<code>sudo apt install prometheus</code>

== Verify Prometheus is installed ==

<code>systemctl status prometheus</code>

== Configuring Prometheus ==

* By default, Prometheus uses a basic configuration.
* You can customize the configuration by editing the Prometheus configuration file located at /etc/prometheus/prometheus.yml.
* Add your targets (endpoints to monitor) and other settings as needed.

<code>cd /etc/etc/prometheus</code>

Remember to run nano with sudo so you can write this file.
<code>sudo nano prometheus.yml</code>

== Start Prometheus ==

<code>sudo systemctl start prometheus</code>

== Stop Prometheus ==

<code>sudo systemctl stop prometheus</code>

== Restarting Prometheus ==

<code>sudo systemctl restart prometheus</code>

== Accessing Prometheus ==

* Prometheus runs as a service and listens on port 9090 by default.
* Open a web browser and navigate to http://192.168.2.243:9090

== Getting Started with Prometheus ==

https://prometheus.io/docs/prometheus/latest/getting_started/

= Install Prometheus - Blackbox Exporter =

== Ensure apt is up to date ==

<code>sudo apt update</code>

== Install Prometheus - Blackbox Exporter ==

<code>sudo apt install prometheus-blackbox-exporter</code>

== Configure Blackbox Exporter with permissions to perform a ping ==

<code>sudo setcap cap_net_raw+ep /usr/bin/prometheus-blackbox-exporter</code>

== Configure Blackbox Exporter ==

<code>cd /etc/prometheus</code>

<code>sudo nano blackbox.yml</code>
(At the moment I don't think I need to do anything in here)

== Launch Blackbox Exporter ==

<code>sudo systemctl start prometheus-blackbox-exporter</code>

== Enable Blackbox Exporter to start on boot ==

<code>sudo systemctl enable prometheus-blackbox-exporter</code>

----

= Install Prometheus Pushgateway =

== Create a directory for prometheus pushgateway ==
<code>sudo mkdir /var/lib/prometheus-pushgateway</code>

== Create the Pushgateway config directories ==
<code>for i in rules rules.d files_sd; do sudo mkdir -p /etc/prometheus-pushgateway/${i} done</code>

== Create a temporary directory for Pushgateway download ==
<code>sudo mkdir -p /tmp/prometheus-pushgateway</code>

<code>cd /tmp/prometheus-pushgateway</code>

== Download the latest Prometheus Pushgateway binary package: ==
<code>wget https://github.com/prometheus/pushgateway/releases/download/v1.9.0/pushgateway-1.9.0.linux-amd64.tar.gz/code>

== Extract the downloaded file ==
<code>sudo tar xvf pushgateway*.tar.gz</code>

== Relocate the binary files extracted ==
<code>cd pushgateway*/</code>

<code>sudo mv pushgateway /usr/local/bin/</code>

== Create a service unit file for Prometheus Pushgateway ==
<code>sudo nano /etc/systemd/system/prometheus-pushgateway.service</code>

== Add the following code (using Nano) ==
<code>
[Unit]
Description=Prometheus Pushgateway
After=network.target

[Service]
User=prometheus
Group=prometheus
ExecStart=/usr/local/bin/pushgateway --web.listen-address=:9091
Restart=always

[Install]
WantedBy=multi-user.target
</code>

== Reload systemd to pick up the new service unit ==
<code>sudo systemctl daemon-reload</code>

== Enable to start on boot ==
<code>sudo systemctl enable prometheus-pushgateway</code>

== Start the service ==
<code>sudo systemctl start prometheus-pushgateway</code>

== Verify the service is running ==
<code>sudo systemctl status prometheus-pushgateway</code>

== Access Prometheus Pushgateway Dashboard via Web Interface ==

http://192.168.2.243:9091/

= Install Go =

<code>sudo apt update</code>

<code>sudo apt upgrade -y</code>

<code>sudo apt install golang-go -y</code>

== Verify Go is installed ==

<code>go version</code>

== Add Go to the path ==
TBD

= Install NodeJS =

<code>sudo apt update</code>

<code>sudo apt upgrade -y</code>

<code>sudo apt install nodejs npm -y</code>

== Check NodeJS installed ==

<code>nodejs --version</code>

== Check that Node Package Manager is Installed ==

<code>npm --version</code>

= Install PromLens =

== Clone Repo ==

Change directory to Downloads folder

<code>cd Downloads</code>

<code>wget https://github.com/prometheus/promlens/releases/download/v0.3.0/promlens-0.3.0.linux-amd64.tar.gz</code>

<code>tar -xvzf promlens-0.3.0.linux-amd64.tar.gz</code>

<code>chmod +x promlens-0.3.0.linux-amd64</code>

<code>mv promlens-0.3.0.linux-amd64 promlens-linux-adm64</code>

<code>sudo mv promlens-linux-amd64 /usr/local/bin/promlens</code>

== Create a service unit file for PromLens ==
<code>sudo nano /etc/systemd/system/promlens.service</code>

== Add the following code to this file ==

[Unit]
Description=PromLens Service
After=network.target

[Service]
ExecStart=/usr/local/bin/promlens/promlens
WorkingDirectory=/usr/local/bin/promlens
User=gregpaskal
Restart=always

[Install]
WantedBy=multi-user.target

== Reload systemd to pick up the new service ==

<code>sudo systemctl enable promlens.service</code>

== Enable the service to start on boot ==

<code>sudo systemctl enable promlens.service</code>

== Start the service ==

<code>sudo systemctl start promlens.service</code>

== verify the service is running ==

<code>sudo systemctl status promlens.service</code>

= Install Grafana =

== Ensure apt is up to date ==

<code>sudo apt update</code>

== Add Grafana APT Repository ==

Import the GPG key to allow installation of signed Grafana packages:

<code>sudo mkdir -p /etc/apt/keyrings/</code>

<code>wget -q -O - https://apt.grafana.com/gpg.key | gpg --dearmor | sudo tee /etc/apt/keyrings/grafana.gpg > /dev/null</code>

== Choose the stable repository ==

<code>echo "deb [signed-by=/etc/apt/keyrings/grafana.gpg] https://apt.grafana.com stable main" | sudo tee -a /etc/apt/sources.list.d/grafana.list</code>

== Update the package list ==

<code>sudo apt-get update</code>

== Install Grafana using apt ==

<code>sudo apt-get install grafana</code>

== Start Grafana ==

<code>sudo systemctl start grafana-server</code>

== Configure Grafana to start on boot ==

<code>sudo systemctl enable grafana-server.service</code>

== Check if Grafana is enabled ==

<code>sudo systemctl status grafana-server</code>

== Access Grafana ==

http://192.168.2.243:3000

== Setup a username and password for Grafana ==

When you install Grafana, it comes with a default administrator account. To set up a new username and password, follow these steps:
Enter the default username: admin and password: admin

Enter a new password: (Whatever you choose)

Create a new user

http://192.168.2.243:3000/admin/users

= Install Apache 2 =

== Check if Apache is already installed ==

<code>apachectl -v</code>

== Update the package list ==

<code>sudo apt update</code>

<code>sudo apt upgrade</code>

== Install Apache2 ==

<code>sudo apt install apache2</code>

<code>sudo systemctl status apache2</code>

<code>apachectl -v</code>

<code>sudo systemctl is-enabled apache2</code>

= Install Dokuwiki =

== Download Docuwiki ==

<code>cd /var/www/html</code>

<code>sudo wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz</code>

== Extract ==

<code>sudo tar xzvf dokuwiki-stable.tgz -C /var/www/html/</code>

== Rename folder ==

<code>sudo mv dokuwiki-*/ dokuwiki/</code>

== Set proper permissions ==

<code>sudo chown -R www-data:www-data /var/www/html/dokuwiki/</code>

== Setup Docuwiki ==

<code>http://192.168.2.243/install.php</code>

= Install Cockpit =
Cockpit monitors local system resources.

== Update the package list ==

<code>sudo apt-get update</code>

== Install Cockpit ==

<code>sudo apt install cockpit</code>

== Setup Cockpit to use a specific port ==
<pre>
sudo mkdir -p /etc/systemd/system/cockpit.socket.d/
sudo nano /etc/systemd/system/cockpit.socket.d/listen.conf
</pre>

Enter the following in nano
<pre>
[Socket]
ListenStream=
ListenStream=1111
</pre>

== Save and exit Nano ==

== Reload the system daemon ==

<code>sudo systemctl daemon-reload</code>

== Start Cockpit ==

<code>sudo systemctl start cockpit.socket</code>

== Verify Cockpit is installed correctly ==

<code>sudo systemctl status cockpit</code>

== Go to Cockpit ==

https://192.168.2.243:1111/

= Setup a ping to monitor using Prometheus and Grafana =

== Configure Prometheus for ping ==

<code>cd /etc/prometheus/</code>

<code>sudo nano prometheus.yml</code>

Add the following code as a scrape_config

<code>
- job_name: 'website-ping-gregpaskal.com'
metrics_path: /probe
params:
module: [icmp]
static_configs:
- targets:
- gregpaskal.com # Replace with the actual website URL
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: localhost:9115 # Blackbox exporter address
----

= Client Dashboards =

Grafana is an excellent solution for creating separate dashboards for different clients while managing user access and permissions.

Here’s how Grafana can address your requirements:

Multiple Organizations:
* Grafana allows you to create multiple organizations, each acting as a separate workspace.
* Each organization can have its own set of users, dashboards, and data sources.
* This separation ensures that clients’ data and configurations remain isolated.

User Management:
* Grafana provides robust user management features:
** User Accounts: You can create individual user accounts for each client.
** Roles and Permissions: Assign roles (e.g., Viewer, Editor, Admin) to control what each user can access.
** LDAP/AD Integration: Grafana can integrate with LDAP or Active Directory for centralized user management.
** SAML Authentication: Use SAML for single sign-on (SSO) and secure authentication.

Dashboard Access Control:
* Grafana allows you to set permissions at the dashboard level:
** Folder Permissions: Control access to specific folders containing dashboards.
** Team Permissions: Assign teams to dashboards and manage access for those teams.
** Data Source Permissions: Restrict access to specific data sources per dashboard.

Customization:
* Grafana lets you customize each client’s dashboards:
** Variables: Create client-specific variables (e.g., for filtering data by client ID).
** Annotations: Add annotations to highlight events or specific data points relevant to each client.

White-Labeling:
* Grafana Enterprise offers white-labeling options:
** Customize the Grafana interface with your clients’ branding (logo, colors, etc.).

In summary, Grafana’s multi-organization support, user management, and fine-grained access control make it an ideal choice for creating separate dashboards tailored to different clients’ needs. 🌐📊🔒

Setting up Monitoring - Revision history