diff --git a/node-exporter/.gitignore b/node-exporter/.gitignore new file mode 100644 index 0000000..35f3568 --- /dev/null +++ b/node-exporter/.gitignore @@ -0,0 +1,164 @@ + +# Created by https://www.gitignore.io/api/macos,python,ansible +# Edit at https://www.gitignore.io/?templates=macos,python,ansible + +### Ansible ### +*.retry + +### macOS ### +# General +.DS_Store +.AppleDouble +.LSOverride + +# Icon must end with two \r +Icon + +# Thumbnails +._* + +# Files that might appear in the root of a volume +.DocumentRevisions-V100 +.fseventsd +.Spotlight-V100 +.TemporaryItems +.Trashes +.VolumeIcon.icns +.com.apple.timemachine.donotpresent + +# Directories potentially created on remote AFP share +.AppleDB +.AppleDesktop +Network Trash Folder +Temporary Items +.apdisk + +### Python ### +# Byte-compiled / optimized / DLL files +__pycache__/ +*.py[cod] +*$py.class + +# C extensions +*.so + +# Distribution / packaging +.Python +build/ +develop-eggs/ +dist/ +downloads/ +eggs/ +.eggs/ +lib/ +lib64/ +parts/ +sdist/ +var/ +wheels/ +pip-wheel-metadata/ +share/python-wheels/ +*.egg-info/ +.installed.cfg +*.egg +MANIFEST + +# PyInstaller +# Usually these files are written by a python script from a template +# before PyInstaller builds the exe, so as to inject date/other infos into it. +*.manifest +*.spec + +# Installer logs +pip-log.txt +pip-delete-this-directory.txt + +# Unit test / coverage reports +htmlcov/ +.tox/ +.nox/ +.coverage +.coverage.* +.cache +nosetests.xml +coverage.xml +*.cover +.hypothesis/ +.pytest_cache/ + +# Translations +*.mo +*.pot + +# Django stuff: +*.log +local_settings.py +db.sqlite3 + +# Flask stuff: +instance/ +.webassets-cache + +# Scrapy stuff: +.scrapy + +# Sphinx documentation +docs/_build/ + +# PyBuilder +target/ + +# Jupyter Notebook +.ipynb_checkpoints + +# IPython +profile_default/ +ipython_config.py + +# pyenv +.python-version + +# pipenv +# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control. +# However, in case of collaboration, if having platform-specific dependencies or dependencies +# having no cross-platform support, pipenv may install dependencies that don’t work, or not +# install all needed dependencies. +#Pipfile.lock + +# celery beat schedule file +celerybeat-schedule + +# SageMath parsed files +*.sage.py + +# Environments +.env +.venv +env/ +venv/ +ENV/ +env.bak/ +venv.bak/ + +# Spyder project settings +.spyderproject +.spyproject + +# Rope project settings +.ropeproject + +# mkdocs documentation +/site + +# mypy +.mypy_cache/ +.dmypy.json +dmypy.json + +# Pyre type checker +.pyre/ + +# Downloaded files +root@* + +# End of https://www.gitignore.io/api/macos,python,ansible \ No newline at end of file diff --git a/node-exporter/.idea/.gitignore b/node-exporter/.idea/.gitignore new file mode 100644 index 0000000..13566b8 --- /dev/null +++ b/node-exporter/.idea/.gitignore @@ -0,0 +1,8 @@ +# Default ignored files +/shelf/ +/workspace.xml +# Editor-based HTTP Client requests +/httpRequests/ +# Datasource local storage ignored files +/dataSources/ +/dataSources.local.xml diff --git a/node-exporter/.idea/inspectionProfiles/profiles_settings.xml b/node-exporter/.idea/inspectionProfiles/profiles_settings.xml new file mode 100644 index 0000000..105ce2d --- /dev/null +++ b/node-exporter/.idea/inspectionProfiles/profiles_settings.xml @@ -0,0 +1,6 @@ + + + + \ No newline at end of file diff --git a/node-exporter/.idea/misc.xml b/node-exporter/.idea/misc.xml new file mode 100644 index 0000000..f851336 --- /dev/null +++ b/node-exporter/.idea/misc.xml @@ -0,0 +1,7 @@ + + + + + + \ No newline at end of file diff --git a/node-exporter/.idea/modules.xml b/node-exporter/.idea/modules.xml new file mode 100644 index 0000000..9f79441 --- /dev/null +++ b/node-exporter/.idea/modules.xml @@ -0,0 +1,8 @@ + + + + + + + + \ No newline at end of file diff --git a/node-exporter/.idea/node-exporter.iml b/node-exporter/.idea/node-exporter.iml new file mode 100644 index 0000000..7c3a99e --- /dev/null +++ b/node-exporter/.idea/node-exporter.iml @@ -0,0 +1,17 @@ + + + + + + + + + + + + + \ No newline at end of file diff --git a/node-exporter/.idea/vcs.xml b/node-exporter/.idea/vcs.xml new file mode 100644 index 0000000..6c0b863 --- /dev/null +++ b/node-exporter/.idea/vcs.xml @@ -0,0 +1,6 @@ + + + + + + \ No newline at end of file diff --git a/node-exporter/Makefile b/node-exporter/Makefile new file mode 100644 index 0000000..0789436 --- /dev/null +++ b/node-exporter/Makefile @@ -0,0 +1,9 @@ +install: + sudo dnf install ansible + ansible-galaxy collection install community.general + ansible-galaxy collection install containers.podman + ansible-galaxy collection install ansible.posix +list-hosts: + ansible-inventory -i inventory.ini --list +run: + ansible-playbook -i inventory.ini playbook.yaml --ask-become-pass diff --git a/node-exporter/img.png b/node-exporter/img.png new file mode 100644 index 0000000..1d53370 Binary files /dev/null and b/node-exporter/img.png differ diff --git a/node-exporter/inventory.ini b/node-exporter/inventory.ini new file mode 100644 index 0000000..6270370 --- /dev/null +++ b/node-exporter/inventory.ini @@ -0,0 +1,5 @@ +[nuculabs] +my-server ansible_user=ansible + +[local] +localhost \ No newline at end of file diff --git a/node-exporter/playbook.yaml b/node-exporter/playbook.yaml new file mode 100644 index 0000000..d30142d --- /dev/null +++ b/node-exporter/playbook.yaml @@ -0,0 +1,55 @@ +- name: Install Prometheus Node Exporter + hosts: nuculabs + become: true + become_method: sudo + vars_files: + - variables.yaml + tasks: + - name: Setup Container + block: + - name: Ensure Podman is installed + ansible.builtin.package: + name: podman + state: present + - name: Pull image + containers.podman.podman_image: + name: "{{ node_exporter.container_image }}" + state: present + - name: "Copy container" + ansible.builtin.template: + src: ./templates/container/node_exporter.container.j2 + dest: /etc/containers/systemd/node_exporter.container + mode: "0644" + - name: Reload systemd + ansible.builtin.command: + cmd: systemctl daemon-reload + - name: Stop service + ansible.builtin.systemd_service: + name: node_exporter.service + state: stopped + enabled: true + - name: Enable service + ansible.builtin.systemd_service: + name: node_exporter.service + state: started + enabled: true + - name: Setup firewall + block: + - name: Create firewalld service + ansible.builtin.template: + src: ./templates/firewall/node_exporter.xml.j2 + dest: /etc/firewalld/services/node_exporter.xml + mode: "0644" + - name: Reload firewalld + ansible.builtin.command: + argv: + - firewall-cmd + - --reload + - name: Enable firewalld service + ansible.posix.firewalld: + service: node_exporter + state: enabled + permanent: true + immediate: true + offline: true + when: setup_firewall diff --git a/node-exporter/readme.md b/node-exporter/readme.md new file mode 100644 index 0000000..c9bfa91 --- /dev/null +++ b/node-exporter/readme.md @@ -0,0 +1,16 @@ +# Node Exporter + +![grafana dashboard](./img.png) + +This playbook allows you to install and run the prometheus node exporter in Podman. + +Using the node exporter allows export metrics from your server, have a Prometheus server scrape them and +create beautiful dashboard in Grafana. + +It was tested on Fedora 41 & Fedora Server. + +References: + +- https://grafana.com/grafana/dashboards/1860-node-exporter-full/ +- https://hub.docker.com/r/bitnami/prometheus +- \ No newline at end of file diff --git a/node-exporter/templates/container/node_exporter.container.j2 b/node-exporter/templates/container/node_exporter.container.j2 new file mode 100644 index 0000000..a9e0796 --- /dev/null +++ b/node-exporter/templates/container/node_exporter.container.j2 @@ -0,0 +1,20 @@ +[Unit] +Description=node_exporter + +[Container] +Image={{ node_exporter.container_image }} +AutoUpdate=registry +Network=host +AddCapability=SYS_TIME +Volume=/proc:/host/proc:ro +Volume=/sys:/host/sys:ro +Volume=/:/rootfs:ro,rslave +Exec=--path.procfs="/host/proc" --path.sysfs="/host/sys" --collector.filesystem.ignored-mount-points="^/(sys|proc|dev|host|etc)($|/)" --web.listen-address="0.0.0.0:{{ node_exporter.port }}" + +[Service] +# Inform systemd of additional exit status +SuccessExitStatus=0 143 + +[Install] +# Start by default on boot +WantedBy=default.target \ No newline at end of file diff --git a/node-exporter/templates/firewall/node_exporter.xml.j2 b/node-exporter/templates/firewall/node_exporter.xml.j2 new file mode 100644 index 0000000..d794b17 --- /dev/null +++ b/node-exporter/templates/firewall/node_exporter.xml.j2 @@ -0,0 +1,5 @@ + + Prometheus Node Exporter + The prometheus metrics node exporter. + + diff --git a/node-exporter/variables.yaml b/node-exporter/variables.yaml new file mode 100644 index 0000000..c90986a --- /dev/null +++ b/node-exporter/variables.yaml @@ -0,0 +1,4 @@ +setup_firewall: true +node_exporter: + container_image: "docker.io/bitnami/node-exporter:latest" + port: 9100 \ No newline at end of file