Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Observe Pulse

Lightweight CLI for real-time observability metrics

Status: v0.1.0 (Alpha)


Overview

Observe Pulse is a command-line tool that collects and displays real-time metrics from your infrastructure.

Features

  • ✅ Real-time CPU, memory, disk monitoring
  • ✅ Network I/O tracking
  • ✅ Process monitoring
  • ✅ Custom metric collectors
  • ✅ Export to Prometheus/Grafana
  • ✅ Zero-config (works out of the box)

Installation

From Source

git clone https://github.com/observeco/pulse.git
cd pulse
go build -o pulse cmd/pulse/main.go
sudo mv pulse /usr/local/bin/

Via Homebrew (Coming Soon)

brew install observeco/tap/pulse

Quick Start

# Start monitoring (displays to terminal)
pulse monitor

# Export to Prometheus
pulse export --format prometheus --port 9090

# Monitor specific process
pulse monitor --pid 1234

# Custom metrics file
pulse monitor --config metrics.yaml

Usage

# Show all commands
pulse --help

# Monitor system (refreshes every 1s)
pulse monitor --interval 1s

# Export to file
pulse export --format json --output metrics.json

# Background mode (writes to log)
pulse daemon --start

# Stop daemon
pulse daemon --stop

# Check status
pulse status

Configuration

Create ~/.pulse/config.yaml:

monitor:
  interval: 1s
  metrics:
    - cpu
    - memory
    - disk
    - network
    - processes

export:
  format: prometheus
  port: 9090
  path: /metrics

collectors:
  - name: http
    interval: 5s
    endpoints:
      - http://localhost:8080/health

Architecture

pulse/
├── cmd/
│   └── pulse/          # Main CLI entry point
├── pkg/
│   ├── collector/      # Metric collectors
│   ├── exporter/       # Export formats
│   └── daemon/         # Daemon mode
└── config/
    └── config.go       # Configuration management

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to the branch
  5. Open a Pull Request

License

MIT License - see LICENSE for details.


Support


ObservecO - Built for observability, designed for developers.

About

Lightweight CLI for real-time observability metrics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages