Quantcast
Channel:  RPi-Experiences
Viewing all 30 articles
Browse latest View live

RPi-Monitor: Version 2.9.1 is available

$
0
0
Note: A new version of RPi-Monitor is available: Version 2.10.
All the details about the latest version of Rpi-Monitor are in RPi-Monitor overview
 
The version 2.9.1 of RPi-Monitor has been released.

If you don't know yet what RPI-Monitor do, have a look to RPi-Monitor Overview.


What's new in this version?
This version is coming with internal changes, improvement and bug fixes.

Here is the changelog of version 2.9:
  • Sign repository to remove authentication warning during install
  • Migrate style to bootstrap 3
  • Add color into progressbar orange for warning and red for danger
  • Move qrcode to about menu (link is related to the page display)
  • Add justgage generating colored gauges 
  • Add visibility parameter defining if a row of status page should be shown
  • Add example configuration files showing rpimonitor rendering features
  • Fix multi page issue #63

New: Signed repository 

RPi-Monitor repository is now signed. This means that you will no more have the authentication warning. It is then required to install my public key to trust RPi-Monitor repository:

        sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 2C0D3C0F




Installation or upgrade from the repository 

If you already have installed the public key of RPi-Monitor repository and the latest version of RPi-Monitor using the repository, you can execute the  following commands to upgrade:

    sudo apt-get update
    sudo apt-get upgrade


If required, you can install the repository following the instruction bellow. This repository will make installation and update of RPi-Monitor accessible with the commands apt-get or aptitude.

Activate https transport for apt and add certificate authority:
 

    sudo apt-get install apt-transport-https ca-certificates

Install my public key to trust RPi-Monitor repository:


    sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 2C0D3C0F

Execute the following command to add RPi-Monitor into your list of repository: 

    sudo wget http://goo.gl/rsel0F -O /etc/apt/sources.list.d/rpimonitor.list

To install RPi-Monitor, execute the following command: 

    sudo apt-get update
    sudo apt-get install rpimonitor

After installation or upgrade you should excute the following command to update information about upgradable packages:

  sudo /usr/share/rpimonitor/scripts/updatePackagesStatus.pl

Manual installation is still working. Refer to RPi-Monitor Installation page for explaination.


New: Example files

RPi-Monitor comes with example files showing the capabilities of some features and functions available in status page. To see how a specific file is behaving, you can include this file into your configuration file using the 'include' directive. Files are included  and commented out into raspbian.conf. To activate them, you can simply uncomment them. 
The following files are available:
  • example.badge_and_label.conf : Show colors of labels and badg
 
  • example.progressbar.conf : Show warning and critical and colors 


  • example.justgage.conf : Show justgage and customisation




  • example.visibility.conf : Show visibility feature
 
Remember to restart RPi-Monitor to apply the configuration change:

  sudo /etc/init.d/rpimonitor restart

New: Bootstrap 3

Now, RPi-Monitor is using the popular framewrok bootstrap 3. This change fix the bug of menu when using RPi-Monitor in tablet or smartphone.


This change also have sides effects on the Label and Badge. If you had customized your installation or RPi-Monitor, you should read with attention the man page related to these feature. A configuration file is also available, example.badge_and_label.conf, show how label and badges are now displayed.

New: JustGageBar

A new widget is now available to display information in status page. Justgage is a handy JavaScript plugin for generating and animating nice & clean gauges. It is based on Raphaël library for vector drawing, so it’s completely resolution independent and self-adjusting.


  JustGageBar(title, label,min, value, max, width, height, levelColors, warning, critical)
 

To see how justgage behave, you can activate the configuration file example.justgage.conf (Ref example explaination and screenshot upper).

The detail of function usage is available into the manpage:


  man rpimonitord.conf

New: Visibility

A new parameter can be used in configuration file defining a visibility of a row:


  web.status.<page id>.content.<row id>.visibility=<visibility formula>

<visibility formula> should be a valid javascript formula returning
          0: to hide the row
          anything else but 0: show the row



Customization

RPi-Monitor is fully configurable so if the displayed information doesn't match you need, customize it.
Everything display in status pages or in statistics pages can be modified, tuned and customized to your needs.

To see how to customize it, use the command
    man rpimonitord
and
    man rpimonitord.conf

To define the configuration you can use RPi-Monitor Interactive Configuration Helper whit the command:
    rpimonitord -i

You will find some examples of customization in RPi-Monitor articles.

Usage

Once RPi-Monitor is configured as you wished, browse http://RPiIpAddress:8888/ to access to the web interface.

Note: The graphs rendering may have strange behavior on Google-Chrome on Windows while it works fine on Linux. Internet Explorer is even not able to display statistics, it is then advised to use Firefox on Windows or better... switch to Linux! ;-). 
Note 2: Since RPi-Monitor is now using bootstrap 3, the behavior may have changed. Your comments are welcome.

About shellinabox

Shellinabox allow you to access to the shell of your Raspberry Pi through a web interface. You can activate this feature into the configuration dialog box.
By default, the link is set to '''/shellinabox'''. When RPi-Monitor will recieve this request, it will automatically do a redirect to http://RPiIpAddress:4200/. You can modify this address to point to your shellinabox address. This address is used inside the iframe of shellinabox page.

RPi-Monitor-Peeble: RPi-Monitor is now available on Pebble Smart Watch

$
0
0
Alexander Kropochev did develop an interface of RPi-Monitor forPebble Smart Watch. So you can now monitor your Raspberry Pi from anywhere and directly on your watch.



RPi-Monitor-Pebble is a new companion to RPi-Monitor which allow you to keep an eye on your monitored device and show its status directly on your wrist.




Installation can be done from your phone directly from the Pebble Application Store on Android or iOS.


Configuration is very easy: Enter the address of RPi-Monitor in the dedicated interface. Of course, to make is work, RPi-Monitor has to be installed and reachable from your handset.


Reminder: The installation and configuration of RPi-Monitor are described in articles listed in this page

Thanks again Alexander for your contribution to this project.



RPi-Monitor: Version 2.10 is not yet available... but it will come soon

$
0
0
The version 2.10 of RPi-Monitor is not ready yet for publication. I didn't had the time to test it yet.I did prepare the article and it has been published automatically (due to a mistake I made).
If you want to participate to the tests, you can have a look to github, branch devel.
Your feedback are welcome and can help me to publish the next version faster.

Happy new year and stay tuned, the future version will come soon.

RPi-Monitor: Version 2.10 is available

$
0
0
The version 2.10 of RPi-Monitor has been ( really ;-) ) released.

If you don't know yet what RPI-Monitor do, have a look to RPi-Monitor Overview.

Photo from flickrby-nc-nd bylittle-greene-paint-company

What's new in this version?
This version is coming with internal changes, improvement and bug fixes.

Here is the changelog of version 2.10:
  • Add addons allowing to create custom page
    -
    Top3 addon

    - Example addon
    -
    Shellinabox addon
    -
    Custom addon

    -
    Webcam: use hawkeye and custom addon to display webcam
  • Support UTF-8 fixing issue #43
  • Add BananaPi configuration files (found in BananaPi forum)
Note: A closing parenthesis ' ) ' is missing in the last line of  service.conf .
If you want to use this file as a source of your customisation, remember to add to fix this issue. It is already fixed in github repositories (and future releases).
Installation or upgrade from the repository 

If you already have installed the latest version of RPi-Monitor using the repository, you can execute the following commands to upgrade:


    sudo apt-get update
    sudo apt-get upgrade


If you install RPi-Monitor for the first time, follow to the instruction bellow to install the repository and install RPi-Monitor with the apt-get command.

Activate https transport for apt and add certificate authority:
 

    sudo apt-get install apt-transport-https ca-certificates

Install my public key to trust RPi-Monitor repository:


    sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 2C0D3C0F

Execute the following command to add RPi-Monitor into your list of repository: 

    sudo wget http://goo.gl/rsel0F -O /etc/apt/sources.list.d/rpimonitor.list

To install RPi-Monitor, execute the following command: 

    sudo apt-get update
    sudo apt-get install rpimonitor

After installation or upgrade you should excute the following command to update information about upgradable packages:

  sudo /usr/share/rpimonitor/scripts/updatePackagesStatus.pl

Manual installation is still working. Refer to RPi-Monitor Installation page for explaination.


New: Addons and custom pages

RPi-Monitor is now supporting addons. Addons can be custom pages designed to give you the possibility to free your imagination and cutomise RPi-Monitor to your needs.

Addons are html pages, javascript and css directly integrated into RPi-Monitor.

 The activation of an addon is done into RPi-Monitor configuration file. The following line is showing how to activate the default addons explaing addons feature: 

  web.addons.1.name=Addons
  web.addons.1.addons=about


It is possible to use an addon many time into a same configuration file (using different parameters if the addon support them).

The next part of this article will show you some example of addons and is highlighting the possibilities of this new feature.

Top3 Addon 
 
Top3 is showing how to use addons to add additionnal information into status page. This addons is designed to periodically generate HTML content. This content can be accessible from the addons menu (if addon is configured in rpimonotord configuration file) and/or can be inserted into status page using the function InsertHTML().


To activate this addon, add the following line to your configuration file
 
  web.addons.2.name=Top3
  web.addons.2.addons=top3


and configure the cron of your Raspberry Pi to update the HTML content periodically. This can be done with the following lines:

* * * * * root cd /usr/share/rpimonitor/web/addons/top3; ./top3 > top3.html

For deeper details, refer to rpimonitor manpage and to comments available into the script top3.

Example Addon

If you want to develop your own addon, you can refer to the example addons to see how to implement such a feature.
Example addon is providing a HTML page, a javacript and a CSS showing how an addon page can interact with RPi-Monitor.  

Example addon can activate by adding the following lines into the configuration file:

  web.addons.3.name=Addon example
  web.addons.3.addons=example
  web.addons.3.parameter=parameter_example

Shellinabox Addon

Shellinabox is now an addon. It activation should now be activated as an addons
  web.addons.4.name=ShelleInABox
  web.addons.4.addons=shellinabox

The behavior of this addon remain the same as previously embedded feature.

Custom Addon

If you are not confortable with html, javascript and css, the addon custom may help you to customise RPi-Monitor to your wishes. This addons implement an iframe that can display any other web pages.

  web.addons.5.name=Custom addons
  web.addons.5.addons=custom
  web.addons.5.url=/addons/custom/custominfo.html

url is defining the page to be displayed into the iframe. It can be a file reachable from RPi-Monitor internal server or a site available into the Internet.

Webcam

If you want to see the image of your webcam in your brower, you can use hawkeye. Once hawkeye installed, it is very easy to add it into RPi-Monitor interface using the custom addon. The configuration will then be the following:

  web.addons.3.name=Webcam - Hawkeye
  web.addons.3.addons=custom
  web.addons.3.url=http://raspberry_adress:8000/


url parameter point to hawkeye web interface. If you are doing such a configuration, keep in mind about the security of your images. You should use the capacity of hawkeye to restrict the access to the image using a login and a password. You can also have a look to my article showing how to secure the access to RPi-monitor.
 

Customization

RPi-Monitor is fully configurable so if the displayed information doesn't match you need, customize it.
Everything display in status pages or in statistics pages can be modified, tuned and customized to your needs.

To see how to customize it, use the command
    man rpimonitord
and
    man rpimonitord.conf

To define the configuration you can use RPi-Monitor Interactive Configuration Helper whit the command:
    rpimonitord -i

You will find some examples of customization in RPi-Monitor articles.

Usage

Once RPi-Monitor is configured as you wished, browse http://RPiIpAddress:8888/ to access to the web interface.

Note: The graphs rendering may have strange behavior on Google-Chrome on Windows while it works fine on Linux. Internet Explorer is even not able to display statistics, it is then advised to use Firefox on Windows or better... switch to Linux! ;-). 
Note 2: Since RPi-Monitor is now using bootstrap 3, the behavior may have changed. Your comments are welcome.

RPi-Monitor: Version 2.11 Beta is ready for test

$
0
0
The version 2.11 beta of RPi-Monitor is ready for test.


Photo from flickr cc-byby DaveBleasdale
Test and validation requires your help.

A new model of publication

I'm changing the way to publish RPi-Monitor. Until now, I was immediately publishing stable versions. From now, when version will be ready for publication, I will create a beta version and ask user to try and test this version. From my point of view, the quality of beta version will be the same as the previous release but it will let me the chance to correct or improve some features before official release.

Why changing the model of publication

RPi-Monitor has more and more functionalities and testing them become more and more complex. You are a user of RPi-Monitor and want to try the new feature in advance? You can then install this beta version and give your feedback on new functionalities and share your feeling about the current developments.

If you don't know yet what RPI-Monitor do, you should better install a stable releae and have a look to RPi-Monitor Overview.



What's new in this version?
This version is coming with internal changes, improvement and bug fixes.

Here is the changelog of version 2.11 beta:
  • RRD structure are now configurable per KPI
  • Support multicolumn view in status page for large screen (Enhancement #77)
  • Allow to use addons when RPi-Monitor is protected by a reverse proxy
  • Set Status page as default landing page
  • Add logfile in configurable destination (Default: /var/log/rpimonitor.log)
  • Bug fixes
Upgrade to beta version from the repository 

I'm supposing here that you already have installed the latest stable version of RPi-Monitor using the repository.
You can execute the following commands to upgrade to latest beta version:


  sudo sed -i "s/master/devel/" /etc/apt/sources.list.d/rpimonitor.list
  sudo apt-get update 
  sudo apt-get upgrade

After  upgrade you should execute the following command to update information about upgradeable packages:

  sudo /usr/share/rpimonitor/scripts/updatePackagesStatus.pl


Note: If you don't want to change your apt sources, you can download the latest deb in github and install it with dpkg -i.

New: RRD structure are now configurable per KPI

RPi-Monitor is now allowing you to define the Round Robin Database structure for each data extracted.
To us this new feature, you should understand how RRD works. Then it will be possible for you to customize the RRD of every data.

Here is the extract of the command man rpimonitor.conf related to the configuration of RRD:
  dynamic.<dynamic data id>.rrd=<GAUGE|COUNTER|DERIVE|ABSOLUTE|COMPUTE>
    The 5th parameter is defining if the KPI has to be stored into a RRD
    database and how <|GAUGE|COUNTER|DERIVE|ABSOLUTE|COMPUTE>. If the
    parameter is defined as empty, no RRD database will be created. If
    this parameter is defined, a RRD database will be created and data
    will be stored at every extraction.
    Ref http://oss.oetiker.ch/rrdtool/doc/rrdcreate.en.html for RRD
    parameter description.
  dynamic.<dynamic data id>.min=<minimal value acceptable in RRD>
  dynamic.<dynamic data id>.max=<maximal value acceptable in RRD>
    If a value extracted by is less than minimal of greater than maximal
    value, it will be stored int RRD database as unknown.
    These limits are usefull to handle counter that fall down to 0 when
    they reach their limit (Ex: network graphs)
  dynamic.<dynamic data id>.heartbeat=<heartbeat>
    the maximum number of seconds that may pass between two updates of
    this data source before the value of the data source is assumed to
    be unknown. Default value: 600.
  dynamic.<dynamic data id>.rra.<rra id>.definition=<cf>:<xff>:<steps>:<rows>
    <rra id> is a number comprise between 1 and 5 defining a Round Robin
    Archive. This RRA is defined by a label, displayed in the web
    interface and a definition.
    The definition is defining the structure of the RRD.
    <cf> is then Consolidate Function and can be AVERAGE|MIN|MAX|LAST
    <xff> define the xfiles factor defines what part of a consolidation
          interval may be made up from *UNKNOWN* data while the
          consolidated value is still regarded as known. It is given
          as the ratio of allowed *UNKNOWN* PDPs to the number of PDPs
          in the interval. Thus, it ranges from 0 to 1 (exclusive).
    <steps> defines how many of these primary data points are used to
            build a consolidated data point which then goes into the archive.
    <rows> rows defines how many generations of data values are kept in
           an RRA. Obviously, this has to be greater than zero.
           Duration of data stored depends on
     Note, the duration of the total data can be calculated with the
     following formula:
        duration = daemon.delay * interval * steps * rows
    Default values of definition are :
    | rra id | definition           |
    +--------+----------------------+
    |   1    | AVERAGE:0.5:1:8640   |
    |   2    | AVERAGE:0.5:6:2880   |
    |   3    | AVERAGE:0.5:60:2016  |
    |   4    | AVERAGE:0.5:180:1488 |
    |   5    | AVERAGE:0.5:360:8784 |


Share your feedback and feeling about this version

A dedicated github's issue is created for each beta version ready for test. 

Everything is working fine for you? 
Share your experience or just let me know it works on the github's issue dedicated to this beta version.
 
You find something not working as expected or you find a bug?
Share your experience on github or open a new issue.


When will stable version be publish?

It's depends on you... If I have feedback saying that all the new feature are working correctly on your machine, I'll then be confident enough on the code of RPi-Monitor and I'll publish the next stable version soon.

RPi-Monitor: Version 2.11 is available

$
0
0
The version 2.11-r5 of RPi-Monitor has been released.

If you don't know yet what RPI-Monitor do, have a look to RPi-Monitor Overview.


RPi-Monitor is Still Alive (clip by Jonathan Coulton)

What's new in this version?
This version is coming with internal changes, improvement and bug fixes.

Here is the changelog of version 2.11-r5:
  • New repository hosted on http://giteduberger.fr to avoid issue with github
  • Add multicolumn view in status page for large screen
  • Add alert feature able to execute script when necessary (Recovery action, SMS, e-mail, etc.)
  • Add possibility to use result of KPI into source or in alert commands with keyword 'data.<kpi>' 
  • Add logfile in configurable destination (Default: /var/log/rpimonitor.log)
  • Add arch configuration files
  • Add possibility to set a default value for KPI when source is not existing
  • Add possibility to set interval to reduce the number of data extraction frequency
  • Set Status Page as default landing page
  • Bug fixes and cleanup code


Still Alive

This revision come 19 month after version 2.10. It is quite long and some people were asking if the project was dead or not.  
The response is no, the project is not dead.
Version 2.11-beta7 was, one year ago a candidate to release but some bugs introduce with a new feature prevent the publication. I then decided to remove the buggy feature and to publish this new version.
RPi-Monitor is now a mature project and the frequency of update willnaturally decrease but the project is Still Alive.

How to install RPi-Monitor's the new repository

Execute the following command to add or update RPi-Monitor repository in you repository list.

    sudo wget http://goo.gl/vewCLL -O /etc/apt/sources.list.d/rpimonitor.list

Installation or upgrade from the repository 

If you already have installed the latest version of RPi-Monitor using the repository, you can execute the following commands to upgrade:

    sudo apt-get update
    sudo apt-get upgrade


If you install RPi-Monitor for the first time, execute the following command to add RPi-Monitor into your list of repository: 

    sudo wget http://goo.gl/vewCLL -O /etc/apt/sources.list.d/rpimonitor.list

To install RPi-Monitor, execute the following command: 

    sudo apt-get update
    sudo apt-get install rpimonitor

After installation or upgrade you should execute the following command to update information about upgradeable packages:

  sudo /etc/init.d/rpimonitor update

Manual installation is still working. Refer to RPi-Monitor Installation page for explanation.

New: Multi-column display


New: Alerts

RPi-Monitor is now embedding a mechanism of alerts. The idea is to execute a script when a KPI reach a limit. To avoid executing this script to frequently, some timer have to be configured.
The file example.alert.confshow how to configure alertsWe will see here how to simulate a temperature monitoring and how this configuration can raise and clear alerts.



To better understand the following explanation you should open the file.

The first part defines dynamic data and howRPi-Monitorshould do to extract information from the file /tmp/alert_test.

These data are added in statistics page to graphs the temperature. 

Then we configure 2 alerts too_hot and too_cold. Here is the example for too_hot. 
  alert.too_hot.active=data.uptime>120
  alert.too_hot.trigger=data.test_alert>50
  alert.too_hot.maxalertduration=20
  alert.too_hot.cancelvalidation=20
  alert.too_hot.resendperiod=60 
  alert.too_hot.raisecommand=commandTooHot
  alert.too_hot.cancelcommand=CommandItIsOkNow 

The alert will be evaluated only when it will become active, when active parameter will be evaluate to true. In my example 120 seconds after computer starts.

When the alert is active, the trigger is evaluated. In my example, when test if the value of test_alert is greater than 50.

When the trigger returns trueduring maxalertduration seconds (20 seconds), the command commandTooHot is executed.
If the trigger is still true after resendperiod seconds after (60 seconds), the command commandTooHot is executed again.

When the trigger become false during cancelvalidation seconds (20 seconds), the  command commandItIsOkNow is executed. 

Into the example file, you can see how these data are used to display label on status page. You will see that limit exceed is immediately detected and you will see alert send after the defined delay.

You want to test this example. It is easy:
  • Uncomment the example.alert.confinclude line into /etc/rpimonitor/data.conf
  • Execute the following command to generate data
    while ( true ); do echo $(( ( RANDOM % 100 ) - 20 )) > /tmp/test_alert; sleep 90; done
  • Execute the following command  to see alerts
    watch 'cat /tmp/alert*' 
  • Open the status page and check the auto update option to see the example running in real time.
You know how Alerts are behaving so you can start RPi-Monitor customization.

New: Automatic update packages status

When you update your system manually, it is require to execute the following command:

  sudo /etc/init.d/rpimonitor update

If you don't want to execute this command each time you update your system, RPi-Monitor can do this for you.To add or remove automatic update of this data, execute:
 

  sudo /etc/init.d/rpimonitor install_auto_package_status_update

or 
  sudo /etc/init.d/rpimonitor remove_auto_package_status_update


Customization

RPi-Monitor is fully configurable so if the displayed information doesn't match you need, customize it.
Everything display in status pages or in statistics pages can be modified, tuned and customized to your needs.

To see how to customize it, use the command

    man rpimonitord

and

    man rpimonitord.conf

To define the configuration you can use RPi-Monitor Interactive Configuration Helper whit the command:

    rpimonitord -i

You will find some examples of customization in RPi-Monitor articles.

Usage

Once RPi-Monitor is configured as you wished, browse http://RPiIpAddress:8888/ to access to the web interface.
 

[Update] RPi-Monitor : The repository is again online

$
0
0
Due to a hacking on the website which is also hosting RPi-Monitor repository, I did removed the repository for a couple of hours.
The issue is fixed and as it was not coming from the repository I did restore it and everything is now behaving as before. 

You can execute the following command to add RPi-Monitor repository in you repository list.

    sudo wget http://goo.gl/vewCLL -O /etc/apt/sources.list.d/rpimonitor.list


Thank you for your understanding.

--------------------------------------------------------------------------------------------------------------------------------


RPi-Monitor : The repository is closed but the project is still working

The success of RPi-Monitor looks to be greater than I was imagining and the traffic generated on the website hosting the repository is now too important.

I had to remove the repository from this web site and I will never publish update using this repository.

You should then now remove the file/etc/apt/sources.list.d/rpimonitor.list from your system to avoid further update errors.

The current action is done in emergency and I will later how see how I can reactivate such a repository.

Thank you for your understanding.

RPi-Monitor: Version 2.12 is available

$
0
0
The version 2.12-r0 of RPi-Monitor has been released.

If you don't know yet what RPI-Monitor do, have a look to RPi-Monitor Overview.

...bug fixing...
Photo from flickrcc-by byNguyen Vu Hung (vuhung)

What's new in this version?
This version is coming with few internal changes, improvement and mainly bug fixes to ensure compatibility with Raspbian (Stretch).

Here is the changelog of version 2.12-r0:
  • Fix interactive configuration mode to accept commands with parameters
  • Fix various bug occuring with raspbian stretch
  • Fix info updated packages after upgrade
  • Fix typos and other bugs
  • Add configuration and tools (/usr/share/rpimonitor/scripts/) for OrangePi and Allwinner_H3
Note: Due to a change on network interface name, it is not possible to create a generic configuration file which will work on every installation. If you want to activate this feature, you will need to do a customization of network.conf.

Keep in mind that RPi-Monitor is a tool designed to be customized to your need and it will never cover all the situation without customization. The default configuration files proposed are installed in a directory named template. These templates are showing examples of what can be done and should help you during the customization.

How to install RPi-Monitor

To perform a manual installation of RpiMonitor, refer to RPi-Monitor Installation page.


To perform an installation from the official repository, follow the instruction bellow:

Execute the following command to add or update RPi-Monitor repository in you repository list.

    sudo wget http://goo.gl/vewCLL -O /etc/apt/sources.list.d/rpimonitor.list

Installation or upgrade from the repository 

If you already have installed the latest version of RPi-Monitor using the repository, you can execute the following commands to upgrade:

    sudo apt-get update
    sudo apt-get upgrade


If you install RPi-Monitor for the first time, execute the following command to add RPi-Monitor into your list of repository: 

    sudo wget http://goo.gl/vewCLL -O /etc/apt/sources.list.d/rpimonitor.list

Activate https transport for apt and add certificate authority: 

    sudo apt-get install apt-transport-https ca-certificates dirmngr

Install my public key to trust RPi-Monitor repository:


    sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 2C0D3C0F

To install RPi-Monitor, execute the following command: 

    sudo apt-get update
    sudo apt-get install rpimonitor

After installation or upgrade you should execute the following command to update information about upgradeable packages:

  sudo /etc/init.d/rpimonitor update


Customization

RPi-Monitor is fully configurable so if the displayed information doesn't match you need, customize it.
Everything display in status pages or in statistics pages can be modified, tuned and customized to your needs.

To see how to customize it, use the command

    man rpimonitord

and

    man rpimonitord.conf

To define the configuration you can use RPi-Monitor Interactive Configuration Helper whit the command:

    rpimonitord -i

You will find some examples of customization in RPi-Monitor articles.

Usage

Once RPi-Monitor is configured as you wished, browse http://RPiIpAddress:8888/ to access to the web interface.

RPi-Monitor Docker Container

$
0
0

Michael Miklis did create a Docker image for RPi-Monitor. 
Let's have a look to the capabilities of this image and how to use this container.

Docker in few words    Source: Wikipedia

Docker is a tool that can package an application and its dependencies in a virtual container that can run on any Linux server. This helps enable flexibility and portability on where the application can run, whether on premises, public cloud, private cloud, bare metal, etc.

Docker technology is providing operating-system-level virtualization also known as containers. [...] Docker uses the resource isolation features of the Linux kernel [...] to allow independent "containers" to run within a single Linux instance, avoiding the overhead of starting and maintaining virtual machines (VMs).

RPi-Monitor running in Docker container

As specified in Wikipedia's description, the goal of Docker is to isolate programs in containers. It has the advantage to keep the host system clean since programs and dependencies are installed inside a container but this advantage could become
a problem if your goal is to perform monitoring of host.

The solution provided by Michael is to share the part of host system with RPi-Monitor's container to allow access to KPI.

/opt/vc
/boot
/sys
/etc
/proc
/usr/lib
All volumes are mapped as read-only to ensure the container can't modify the data on the docker host. Additionally access to the Raspberry Pi's vchiq and vcsm device needs to be mapped to the container to access hardware sensors, like CPU Temperature, e.g.

The following command does the job:
docker run --device=/dev/vchiq \
--device=/dev/vcsm \
--volume=/opt/vc:/opt/vc \
--volume=/boot:/boot \
--volume=/sys:/dockerhost/sys:ro \
--volume=/etc:/dockerhost/etc:ro \
--volume=/proc:/dockerhost/proc:ro \
--volume=/usr/lib:/dockerhost/usr/lib:ro \
-p=8888:8888 \
--name="rpi-monitor" \
-d \
michaelmiklis/rpi-monitor:latest
All the detail are gathered in the README and DockerHub pages of the Docker-RPi-Minitor project.

Note: This docker image is based on resin/rpi-raspbian:latest image and is then designed to run on ARM based architecture such as Raspberry Pi.

RPi-Monitor documentation

$
0
0
RPi-Monitor documentation is available (in early access - Work is still in progress).

Photo from flickrcc-by-nc-nd bypwkpwkpwk


This blog was gathering information example showing how RPi-Monitor could be installed, used and configured.  As RPi-Monitor become a mature software, we reached the limit of such blog based documentation. Then I dicided to gather all information, examples, tips and trick into one unique location: RPi-Monitor-docs.

Work in progress

As specified in introduction, the documentation is not completed yet and work is still in progress.

On some pages, you will see a "Work in progress" ribbon.
This means that data of the page is not yet validated and may contains mistake of fuzzy information.


Warning: The documentation is refering to v2.13 of RPi-Monitor which is not yet published. Some features such as snmp may not be present on your version of RPi-Monitor. But even if the current documentation is not fully completed, it should be clearer than articles of this blog.  So, RPi-Monitor-docsbecome from now the official source of documentation for RPi-Monitor.


A new logo


The next version of RPi-Monitor will introduce a new logo and a new catchline "Real time monitoring for embedded devices"because, even is RPi-Monitor was initially designed for Raspberry Pi, it can do much more...
Viewing all 30 articles
Browse latest View live