Public Repository

Last pushed: 2 months ago
Short Description
Simple kafka-stream of psutil information.
Full Description

Data structure

Simple wrapper around psutil lib to send kafka messages with system utilization information (cpu, memory, network). For now only cpu percentage and memory info is used, more information will be added later.

Current json format is:

{
  "timestamp": unix_timestamp_in_milliseconds,
  "cpu_percent": double_value,
  "memory_total": number_of_bytes,
  "memory_used" number_of_bytes,
  "memory_free" number_of_bytes,
}

Usage

The module requires the following configurations that have to be set as environment variables:

  • KAFKA_BOOSTRAP_SERVER is the hostname and port to kafka broker i.e. kafka_host:9092, only single instance can be passed for now. The port can be ommited, since the default port for kafka ist 9092.
  • KAFKA_TOPIC topic name you want to push your messages to

Supported kafka versions

Since I use kafka-1.3.5 python library, the image is best used with newer brokers (0.9+), but is backwards-compatible with older versions (to 0.8.0).

Support

Feel free to drop a comment if you have any troubles or would like to have more features, configurations etc. I would also be glad to know how you use this image which might help me to steer the development.

Docker Pull Command
Owner
am29d