# loganalyzer

**Repository Path**: mirrors_rsyslog/loganalyzer

## Basic Information

- **Project Name**: loganalyzer
- **Description**: Adiscon LogAnalyzer, a web frontend to log data from the same folks the created rsyslog
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-18
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# LogAnalyzer

**LogAnalyzer** is a PHP web application for browsing syslog and related log data from **files** or **databases**. It comes from the same ecosystem as [rsyslog](https://www.rsyslog.com/).

| Main log view | Login | Admin |
|:---:|:---:|:---:|
| ![LogAnalyzer main view](doc-site/docs/assets/user-guide/index.png) | ![Login page](doc-site/docs/assets/user-guide/login.png) | ![Admin panel](doc-site/docs/assets/user-guide/admin.png) |

| Reports | Statistics |
|:---:|:---:|
| ![Reports](doc-site/docs/assets/user-guide/reports.png) | ![Statistics](doc-site/docs/assets/user-guide/statistics.png) |

## Documentation

- **Handbook** (Docker install, Docker development & CI, **LogAnalyzer user guide**, third-party components): [rsyslog.github.io/loganalyzer](https://rsyslog.github.io/loganalyzer/)
- **[`docker/README.md`](https://github.com/rsyslog/loganalyzer/blob/master/docker/README.md)** — install walkthrough (`docker compose` from repo root, `.env`), file map (`Dockerfile`, compose files, scripts), handbook links
- **[`AGENTS.md`](https://github.com/rsyslog/loganalyzer/blob/master/AGENTS.md)** — contributor notes: developer Docker stack (`docker-compose.dev.yml`), environment variables, PHPUnit, Playwright E2E
- **User guide chapters** (imported into the handbook) are maintained as HTML under [`doc/`](https://github.com/rsyslog/loganalyzer/tree/master/doc/)

## Quick start (Docker — default stack)

Step-by-step install: **[`docker/README.md`](https://github.com/rsyslog/loganalyzer/blob/master/docker/README.md)** · handbook: **[Docker overview](https://rsyslog.github.io/loganalyzer/docker/)**, **[Docker install](https://rsyslog.github.io/loganalyzer/docker-install/)**.

[`docker/docker-compose.yml`](https://github.com/rsyslog/loganalyzer/blob/master/docker/docker-compose.yml) ships a **fresh install** by default: the database bootstrap creates schema, default views, and the **admin user** — **no** auto-added sample log sources. Fixture files remain available under **`/samplelogs`** in the image if you set **`LOGANALYZER_SEED_SAMPLE_SOURCES=1`**. MySQL data and **`config.php`** persist in **named Compose volumes**.

From the repository root, optionally copy [`docker/env.example`](https://github.com/rsyslog/loganalyzer/blob/master/docker/env.example) → **`.env`** to customise **`LOGANALYZER_ADMIN_*`**, **`MYSQL_*`**, **`LOGANALYZER_DISK_*`**, and demo seeding — or use the handbook section **[Docker helper scripts](https://rsyslog.github.io/loganalyzer/docker-install/#docker-helper-scripts-install-focused)** (`init-env-interactive`, `rebuild-consumer`, etc.).

```bash
docker compose --project-directory . -f docker/docker-compose.yml up --build
```

Open **http://localhost:8080/**.

- **Credentials / DB defaults:** see [`doc-site/docs/docker-install.md`](https://github.com/rsyslog/loganalyzer/blob/master/doc-site/docs/docker-install.md). Dev-only stack with a bind-mounted repo `src/`: [`doc-site/docs/docker-develop.md`](https://github.com/rsyslog/loganalyzer/blob/master/doc-site/docs/docker-develop.md) and [`docker/docker-compose.dev.yml`](https://github.com/rsyslog/loganalyzer/blob/master/docker/docker-compose.dev.yml).

**Clean reset everything** (drops MySQL and generated config volumes): `sh docker/rebuild-consumer.sh` or `docker\rebuild-consumer.bat`.

## Tests and CI

| Area | Where |
|------|--------|
| PHPUnit | `composer install` then `composer test` |
| Playwright E2E | [`e2e/README.md`](https://github.com/rsyslog/loganalyzer/blob/master/e2e/README.md), `docker/docker-compose.e2e.yml` |
| Workflows | [`.github/workflows/`](https://github.com/rsyslog/loganalyzer/tree/master/.github/workflows/) (PHP CI, Docker publish on tag `v*`, Playwright E2E, GitHub Pages) |

On GitHub, the Playwright workflow can open an issue when E2E fails (same repository only); see [`AGENTS.md`](https://github.com/rsyslog/loganalyzer/blob/master/AGENTS.md) and [`e2e.yml`](https://github.com/rsyslog/loganalyzer/blob/master/.github/workflows/e2e.yml).

## Maintainer backlog

Informal TODOs and dated change bullets that previously lived here are archived in [`CHANGELOG.md`](https://github.com/rsyslog/loganalyzer/blob/master/CHANGELOG.md).