Open Source
Contribute to LogsDB
Help build the universal log encyclopedia. Every contribution helps engineers around the world understand and parse logs faster.
100%
Open Source
MIT
License
Community Driven
How to Contribute
1. Study the Format
Look at existing log types to understand the data structure. Each log type follows a consistent schema.
2. Gather Real Examples
Collect real log samples from actual systems. Include multiple formats and edge cases.
3. Document Everything
Add paths for all platforms, parsing patterns (regex, grok), field descriptions, and use cases.
4. Submit a PR
Fork the repository, add your log type to the data folder, and submit a pull request.
Log Type Structure
Each log type follows this JSON schema. Add your log type to src/data/technologies/
example-log-type.jsonjson
{
"id": "access",
"name": "Access Log",
"description": "HTTP request logs",
"defaultPath": "/var/log/nginx/access.log",
"paths": [
{
"os": "linux",
"path": "/var/log/nginx/access.log"
}
],
"formats": [
{
"name": "Combined",
"pattern": "$remote_addr - $remote_user [$time_local]...",
"example": "192.168.1.1 - - [25/Dec/2025:10:15:30 +0000]...",
"fields": [
{
"name": "remote_addr",
"type": "IP Address",
"description": "Client IP address"
}
]
}
]
}Contribution Guidelines
- Use real log examples from actual systems, not fabricated data
- Include paths for all supported operating systems
- Provide both regex and grok patterns when possible
- Document all fields with clear descriptions and types
- Add common use cases and troubleshooting scenarios
- Test your parsing patterns against the examples
- Follow the existing code style and structure
Wanted Log Types
These log types are highly requested. Pick one and start contributing!
Kubernetes
API Server
Kubelet
Controller Manager
AWS
CloudTrail
VPC Flow Logs
ALB Access Logs
Elasticsearch
Cluster Logs
Slow Logs
Deprecation
Redis
Server Log
Slow Log
MongoDB
mongod Log
Audit Log
HAProxy
HTTP Log
TCP Log
Ready to contribute?
Join the community and help make log parsing easier for everyone.