https://github.com/gowizzard/mobyspulse

An little prometheus exporter to check the restarts of the cotnainers.
https://github.com/gowizzard/mobyspulse

docker go moby prometheus restarts unixsocket

Last synced: 5 days ago
JSON representation

An little prometheus exporter to check the restarts of the cotnainers.

• Host: GitHub
• URL: https://github.com/gowizzard/mobyspulse
• Owner: gowizzard
• Created: 2024-04-09T07:18:10.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-16T15:47:49.000Z (6 months ago)
• Last Synced: 2025-04-19T19:26:13.427Z (3 months ago)
• Topics: docker, go, moby, prometheus, restarts, unixsocket
• Language: Go
• Homepage:
• Size: 117 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        




# Moby's Pulse

[![Go Test](https://github.com/gowizzard/mobyspulse/actions/workflows/go-test.yml/badge.svg)](https://github.com/gowizzard/mobyspulse/actions/workflows/go-test.yml) [![Docker Test](https://github.com/gowizzard/mobyspulse/actions/workflows/docker-test.yml/badge.svg)](https://github.com/gowizzard/mobyspulse/actions/workflows/docker-test.yml) [![Docker Build](https://github.com/gowizzard/mobyspulse/actions/workflows/docker-build.yml/badge.svg)](https://github.com/gowizzard/mobyspulse/actions/workflows/docker-build.yml) [![Pull Request Labels](https://github.com/gowizzard/mobyspulse/actions/workflows/pull-request-labels.yml/badge.svg)](https://github.com/gowizzard/mobyspulse/actions/workflows/pull-request-labels.yml)

A little prometheus exporter to get the restarts of containers, with multiple attributes to get specific container information.



## Installation

The easiest way to install Moby's Pulse is to use the provided Docker image. You can pull the image from the GitHub Container Registry:

```bash

docker pull ghcr.io/gowizzard/mobyspulse:latest

```

## Usage

To start the exporter, you can use the following docker compose file:

```yaml

services:

    mobyspulse:

        container_name: mobyspulse

        environment:

            - BASIC_AUTH_USERNAME=moby

            - BASIC_AUTH_PASSWORD=pulse

        volumes:

            - /var/run/docker.sock:/var/run/docker.sock

        ports:

            - "3000:3000"

        image: ghcr.io/gowizzard/mobyspulse:latest

```

If you want to use the exporter without basic auth, you can remove the environment variables. The exporter will be available on port 3000.

### Metrics

The exporter provides the following metrics:

```text

# Moby's Pulse - Docker metrics exporter for Prometheus.

# This is a custom exporter for Docker metrics. Your system running Docker version "27.4.0" and API version "1.47" is being monitored.

container_restart_count{id="d21881ca074683ed47467bd952b4a1c008c59d0d70ef9686641c9cff0257a733",name="mobyspulse",image="ghcr.io/gowizzard/mobyspulse:latest",status="running",health="healthy",created="1736067482",started_at="1736067482"} 0

```