Initial

Author: bhemar

.gitignore

@@ -0,0 +1,3 @@
+*.retry
+
+.idea/

README.md

@@ -0,0 +1,64 @@
+Raspberry metrics
+=================
+
+Expose raspberry PI metrics using [Grafana](https://grafana.com/) and [Prometheus](https://prometheus.io/):
+
+![Example](./preview/Screen_Shot.jpg)
+
+## About ##
+
+This project contains [Ansible](https://www.ansible.com/) playbook which installs three services on Raspberry:
+
+* [Node exporter](https://github.com/prometheus/node_exporter) - expose Raspberry metrics (v0.14.0)
+* [Prometheus](https://prometheus.io/) - collect and store metrics (v1.7.1)
+* [Grafana](https://grafana.com/) - metrics visualization (v4.3.2)
+
+![Scheme](./preview/scheme.jpg)
+
+### Prerequisites ###
+
+* Raspberry PI with ARMv7 processor (Tested on [Raspberry PI 2 Model B](https://www.raspberrypi.org/products/raspberry-pi-2-model-b/))
+* Debian installed on Raspberry (like [Raspbian Jessie](https://www.raspberrypi.org/downloads/raspbian/))
+* open port 22 on raspberry (SSH)
+* open port 3000 on raspberry (Grafana)
+
+## How to install ##
+
+[Ansible](https://www.ansible.com/) is required for installation.
+
+If you don't have Ansible installed, see [Ansible installation](http://docs.ansible.com/ansible/intro_installation.html).
+
+### 1. Configure Raspberry IP address ###
+
+Checkout project.
+
+Edit file **ansible/hosts** and set Raspberry IP address.
+
+### 2. Run ansible playbook ###
+
+Run Ansible playbook with password authentication:
+```
+    cd ansible/
+    ansible-playbook raspberry.yml -i hosts -u pi -k -K
+```
+
+Run Ansible playbook with SSH keys authentication:
+
+```
+    cd ansible/
+    ansible-playbook raspberry.yml -i hosts -u pi
+```
+
+### 3. Configure Grafana datasource ###
+
+* Go to Grafana URL http://raspberry:3000/
+* login with admin/admin
+* add new Data Source:
+
+![DataSource](./preview/dataSource.jpg)
+
+* Click on "Raspberry metrics" dashboard:
+
+![Dashboard](./preview/dashboard.png)
+
+That's it.

ansible/group_vars/all/default

@@ -0,0 +1,10 @@
+# Node_exporter variables
+node_exporter_install_path: '/opt/node-exporter'
+node_exporter_service_name: 'node-exporter'
+
+# Prometheus variables
+prometheus_install_path: '/opt/prometheus'
+prometheus_service_name: 'prometheus'
+
+# Grafana variables
+grafana_install_path: '/opt/grafana'

ansible/hosts

@@ -0,0 +1,2 @@
+[hosts]
+192.168.0.20

ansible/raspberry.yml

@@ -0,0 +1,14 @@
+- name: Install Node exporter service
+  hosts: hosts
+  roles:
+  - { role: 'node-exporter' }
+
+- name: Install Prometheus service
+  hosts: hosts
+  roles:
+  - { role: 'prometheus' }
+
+- name: Install Grafana service
+  hosts: hosts
+  roles:
+  - { role: 'grafana' }

ansible/roles/grafana/defaults/main.yml

@@ -0,0 +1,2 @@
+grafana_download_url: https://bintray.com/fg2it/deb-rpi-1b/download_file?file_path=main%2Fg%2Fgrafana_4.3.2_armhf.deb
+grafana_filename: grafana_4.3.2_armhf.deb