lifailon/logporter repository overview

A lightweight alternative to 🦉 cAdvisor⁠ for exporting metrics from Docker containers, a log collector for sending to Lok, and searching for new image versions in remote registries based on semantic analysis of tags or digests in a single container.

⁠Quick start

Clone the repository and run the monitoring full-stack with one command:

git clone https://github.com/Lifailon/logporter
cd logporter
docker-compose up -d --pull always

The stack includes Prometheus with an exporter connected and alerts configured, a Loki server targeted by a log collector, and Grafana with pre-configured data sources and added dashboards.

Go to Grafana UI: http://localhost:3000 and enter admin:admin.

⁠Dashboard

The project supports a built-in dashboard that contains summary information on the status of all containers, images, and volumes. The interface is based on go-template⁠ and does not affect performance in any way, as it uses cached data.

Go to Dashboard: http://localhost:9333.

The dashboard allows you to view container logs in real time, with support for content filtering.

⁠Manual setup

⁠Exporter

• Run the exporter in a container using the image published on Docker Hub⁠:

docker run -d --name logporter \
  -v /var/run/docker.sock:/var/run/docker.sock:ro \
  -p 9333:9333 \
  --restart=always \
  lifailon/logporter:latest

All metrics are retrieved directly from the Docker socket, which requires read-only access (:ro).

Or use compose⁠ to fine-tune access to the Docker socket through a proxy:

services:
  logporter:
    image: lifailon/logporter:latest
    container_name: logporter
    restart: always
    ports:
      - 9333:9333
    environment:
      - DOCKER_HOST=tcp://docker-proxy:2375

  docker-proxy:
    image: lscr.io/linuxserver/socket-proxy:latest
    container_name: docker-proxy
    restart: always
    environment:
      - CONTAINERS=1
      - INFO=1
      - SYSTEM=1
      - IMAGES=1
      - DISTRIBUTION=1
      - ALLOW_LOGS=1
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:ro

List of environment variables to configure:

• Connect the new target to the Prometheus configuration file:

scrape_configs:
  - job_name: logporter
    scrape_interval: 15s
    scrape_timeout: 2s
    static_configs:
      - targets:
        - localhost:9333

• Import the prepared public Grafana dashboard⁠ using the id 23848 or from json⁠ file.

⁠Loki

• Configure a connection with Loki to send logs using environment variables:

By default, metrics collection is disabled if the LOKI_URL variable is empty.

• Import the prepared Loki log dashboard into Grafana from json⁠ file.