DISCONTINUATION OF PROJECT.

This project will no longer be maintained by Intel.

This project has been identified as having known security escapes.

Intel has ceased development and contributions including, but not limited to, maintenance, bug fixes, new releases, or updates, to this project.

Intel no longer accepts patches to this project.

DISCONTINUATION OF PROJECT

This project will no longer be maintained by Intel. Intel will not provide or guarantee development of or support for this project, including but not limited to, maintenance, bug fixes, new releases or updates. Patches to this project are no longer accepted by Intel. If you have an ongoing need to use this project, are interested in independently developing it, or would like to maintain patches for the community, please create your own fork of the project.

This Plugin is in Alpha.

It is being worked on in the open in an effort to replace the node manager plugin. Please report any bugs by creating an issue.

snap collector plugin - Intel OPEN DCM Platform Collector

Plugin to collect inventory, health, power/thermal related metrics from platforms which expose such data through Intel Node Manager, DCMI or generic IPMI interfaces. Currently it is using Ipmitool or open ipmi driver to collect data. This plugin is based on the snap-plugin-collector-node-manager and extend the coverage to more IPMI enabled platforms.

1. Getting Started
   • System Requirements
   • Installation
   • Configuration and Usage
2. Documentation
   • Collected Metrics
   • Examples
   • Roadmap
3. Community Support
4. Contributing
5. License
6. Acknowledgements

Getting Started

Plugin collects specified metrics in-band on OS level

System Requirements

• Support server platforms with Intel Node Manager, DCMI or generic IPMI support.
• Currently it works only on Linux Servers (will be tested on a subset of Linux distributions)
• Ipmitool needs to be installed on platform

Installation

Download Intel OPEN DCM Platform plugin binary:

You can get the pre-built binaries for your OS and architecture at snap's Github Releases page.

To build the plugin binary:

Fork https://github.com/intelsdi-x/snap-plugin-collector-intel-dcm-platform
Clone repo into $GOPATH/src/github/intelsdi-x/:

$ git clone https://github.com/<yourGithubID>/snap-plugin-collector-intel-dcm-platform

Build the plugin by running make in repo:

$ make

This builds the plugin in /build/rootfs

Configuration and Usage

On OS level user needs to load modules:

• ipmi_msghandler
• ipmi_devintf
• ipmi_si

Those modules provides specific IPMI device which can collect data from NM, DCMI or generic IPMI

There are currently 7 configuration options:

• mode - defines mode of plugin work, possible values: legacy_inband, legacy_inband_openipmi, oob
• channel - defines communication channel address (default: "0x00")
• slave - defines target address (default: "0x00")
• user - for OOB mode only, user for authentication to remote host
• password - for OOB mode only, password for authentication to remote host
• host - for OOB mode only, BMC IP address of host which will be monitored OOB
• protocol - defines the communication protocol used to collect metric data, possible values: node_manager, dcmi, ipmi

Sample configuration of intel dcm platform plugin:

{
    "control" : {
        "plugins": {
            "collector": {
                "intel-dcm-platform": {
                    "all": {
                        "protocol": "node_manager",
                        "mode": "legacy_inband",
                        "channel": "0x06",
                        "slave": "0x2C"
                    }
                }
            }
        }
    }
}

Documentation

Collected Metrics

This plugin has the ability to gather the following metrics:

Metric Tags

Examples

In one terminal window, open the Snap daemon with path to config file (see examplary config file). In this case with logging set to 1 and trust disabled:

$ snapteld -l 1 -t 0 --config config.json

Load snap-plugin-collector-intel-dcm-platform plugin:

$ snaptel plugin load snap-plugin-collector-intel-dcm-platform

See available metrics for your system:

$ snaptel metric list

Create task manifest to use Intel OPEN DCM Platform plugin (or use an examplary task manifest):

{
    "version": 1,
    "schedule": {
        "type": "simple",
        "interval": "5s"
    },
    "workflow": {
        "collect": {
            "metrics": {
                "/intel/dcm/power/system/avg": {},
                "/intel/dcm/power/system/max": {},
                "/intel/dcm/power/system/min": {},
            "/intel/dcm/inventory/product_name ": {},
            "/intel/dcm/inventory/product_manufacturer ":{},
            "/intel/dcm/inventory/firmware_version":{},
            "/intel/dcm/health/powersupply":{},
            "/intel/dcm/health/fan":{},
            "/intel/dcm/health/processor":{},
            "/intel/dcm/thermal/inlet/cur":{},
            "/intel/dcm/thermal/inlet/max":{},
            },
            "config": {
            },
            "process": null,
            "publish": [
                {
                    "plugin_name": "file",
                    "plugin_version": 2,
                    "config": {
                        "file": "/tmp/published_dcminfo"
                    }
                }
            ]
        }
    }
}

Get file plugin for publishing and load it:

$ wget  http://snap.ci.snap-telemetry.io/plugins/snap-plugin-publisher-file/latest/linux/x86_64/snap-plugin-publisher-file
$ snaptel plugin load snap-plugin-publisher-file

Create a task:

$ snaptel task create -t dcm-file.json
Using task manifest to create task
Task created
ID: 02dd7ff4-8106-47e9-8b86-70067cd0a850
Name: Task-02dd7ff4-8106-47e9-8b86-70067cd0a850
State: Running

See realtime output from snaptel task watch <task_id> (CTRL+C to exit)

snaptel task watch 02dd7ff4-8106-47e9-8b86-70067cd0a850

Watching Task (02dd7ff4-8106-47e9-8b86-70067cd0a850):
NAMESPACE                        DATA    TIMESTAMP
/intel/dcm/power/cpu/avg         44      2017-04-14 12:18:39.31235067 +0000 UTC
/intel/dcm/power/memory/avg      18      2017-04-14 12:18:39.31235067 +0000 UTC
/intel/dcm/power/system/avg      129     2017-04-14 12:18:39.31235067 +0000 UTC
/intel/dcm/thermal/inlet/avg     26      2017-04-14 12:18:39.31235067 +0000 UTC

Roadmap

As we launch this plugin, we have a few items in mind for the next release:

• Remove IPMI tool support
• More health info support
• Scalability support for multiple hosts

Community Support

This repository is one of many plugins in snap, a powerful telemetry framework. See the full project at http://github.com/intelsdi-x/snap To reach out to other users, head to the main framework

Contributing

We love contributions!

There's more than one way to give back, from examples to blogs to code updates. See our recommended process in CONTRIBUTING.md.

License

snap, along with this plugin, is an Open Source software released under the Apache 2.0 License.

Acknowledgements

• Author: Dancy Ding
• Author: Xin Dong
• Author: Jialei Wang

And thank you! Your contribution, through code and participation, is incredibly important to us.