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: 14 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 (7 months ago)
• Default Branch: main
• Last Pushed: 2024-06-02T15:45:20.000Z (5 months ago)
• Last Synced: 2024-06-19T14:52:08.136Z (5 months ago)
• Topics: docker, go, moby, prometheus, restarts, unixsocket
• Language: Go
• Homepage:
• Size: 105 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 "26.0.1" and API version "1.45" is being monitored.

container_restart_count{id="2c35a3500c6384cd88b1cb30182ba39e54c74e4047515d2e6db662aaa7116bb2",name="mobyspulse",image="mobyspulse-mobyspulse:latest",created="1713079803",started_at="1713079803"} 0

```