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 vanilla JavaScript. Cached data is used for rendering, so it does not impact the exporter performance.

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

The dashboard provides real-time access to container logs using an SSE stream. It handles large log histories efficiently through DOM virtualization (rendering only visible lines to ensure high performance), offers various filtering modes, and allows navigation through the loaded content using an interactive timeline.

⁠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.