green-sys v1.0.6

green-sys

System monitoring agent for AWS Greengrass.

Current version: 1.0.5

Lead Maintainer: Halim Qarroum

Table of contents

• Installation
• Features
• Dependencies
• See also

Install

green add npm://green-sys

Features

• Monitoring of system components (CPU, Memory, Processes, Network, Storage, OS) within AWS Greengrass.
• Integration with green-watch to synchronize system metrics on AWS Cloudwatch.
• Exposes a Restful API to other applications, accessible over the local or remote Greengrass MQTT broker.
• Remote terminal access over MQTT to manage the local Greengrass host system.

Dependencies

For the green-sys lambda function to properly work, the sys-get agent needs to be running on the host operating system in order to obtain system information not accessible within Greengrass containers. The sys-get agent should be run under the user ggc_user which is the default user under which Greengrass Lambda functions are running.

To install the sys-get agent, run the following command on the host :

npm install --global sys-get

To start sys-get under the ggc_user, run the following command on the host system running your Greengrass core :

sudo -u ggc_user sh -c "`which sys-get` serve --use-expressify ipc"

This command will expose the system information API provided by sys-get on an Expressify IPC channel accessible by green-sys in the context of a Greengrass container.

See also

• The green-cli command-line deployment tool.
• The Expressify framework.
• The sys-get command-line tool.
• The expressify-ipc strategy supporting local sockets as a transport.
• The systeminformation module.