You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
80 lines
2.5 KiB
80 lines
2.5 KiB
5 months ago
|
# JITSI MEET LOG ANALYSER - Grafana Loki and OpenTelemetry Integration
|
||
|
|
|
||
|
|
Welcome to the Grafana Loki and OpenTelemetry integration project! This repository provides a simple and effective setup for log management and analysis using Docker, Grafana Loki, and OpenTelemetry.
|
||
|
|
Currently this is an in-progress GSoC Summer of Code project and so the instructions may change before being finalized. Please treat all this as alpha code.
|
||
|
|
|
||
|
|
## Overview
|
||
|
|
|
||
|
|
This project demonstrates how to configure and use Grafana Loki with OpenTelemetry to collect, parse, and visualize log data. It includes:
|
||
|
|
|
||
|
|
- A Docker Compose setup (`log-analyser.yml`) for Loki and OpenTelemetry Collector.
|
||
|
|
- A Docker Compose setup (`grafana.yml`) for Grafana.
|
||
|
|
- Configuration files for log parsing and exporting.
|
||
|
|
- Instructions to set up and access Grafana with Loki as a data source.
|
||
|
|
-
|
||
|
|
## Getting Started
|
||
|
|
|
||
|
|
### Prerequisites
|
||
|
|
|
||
|
|
- Docker
|
||
|
|
- Docker Compose
|
||
|
|
|
||
|
|
### Setup
|
||
|
|
|
||
|
|
1. **Clone the repository:**
|
||
|
|
|
||
|
|
```bash
|
||
|
|
git clone https://github.com/jitsi/docker-jitsi-meet.git
|
||
|
|
```
|
||
|
|
|
||
|
|
### Log Analyser
|
||
|
|
|
||
|
|
1. **Add your log files:**
|
||
|
|
|
||
|
|
Place your log file in the `log-analyser/jitsi-logs` directory. Update the `otel-collector-config.yaml` file with the correct file path to start ingesting the logs. This setup allows OpenTelemetry to read logs from the file and forward them to Loki.
|
||
|
|
|
||
|
|
2. **Update the otel-collector-config.yaml file:**
|
||
|
|
|
||
|
|
Update the file path to point to your log file for ingestion by OpenTelemetry.
|
||
|
|
|
||
|
|
3. **Start the Docker containers:**
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker-compose -f docker-compose.yml -f log-analyser.yml up -d
|
||
|
|
```
|
||
|
|
|
||
|
|
### Grafana
|
||
|
|
|
||
|
|
1. **Start the Docker container:**
|
||
|
|
|
||
|
|
```bash
|
||
|
|
docker-compose -f docker-compose.yml -f grafana.yml up -d
|
||
|
|
```
|
||
|
|
|
||
|
|
2. **Access Grafana:**
|
||
|
|
|
||
|
|
Open your web browser and navigate to [http://localhost:3000](http://localhost:3000).
|
||
|
|
|
||
|
|
3. **Log in to Grafana:**
|
||
|
|
|
||
|
|
Use the default credentials:
|
||
|
|
|
||
|
|
```
|
||
|
|
Username: admin
|
||
|
|
Password: admin
|
||
|
|
```
|
||
|
|
|
||
|
|
### Dashboard Setup
|
||
|
|
|
||
|
|
The dashboard setups are available as JSON files in the `log-analyser/grafana-dashboards` directory. You can import these JSON files into Grafana to use the pre-configured dashboards. In the future, we plan to automate this import process.
|
||
|
|
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
- **Log Parsing and Visualization:** After setting up, you can use Grafana to explore and visualize your logs. Check our dashboards and panels to monitor log data effectively.
|
||
|
|
|
||
|
|
|
||
|
|
## Acknowledgements
|
||
|
|
|
||
|
|
Thanks for checking out this project! If you have any questions or need further assistance, don't hesitate to reach out.
|