# grok-debugger

**Repository Path**: xiaoyuwifi/grok-debugger

## Basic Information

- **Project Name**: grok-debugger
- **Description**: grok-debugger
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-30
- **Last Updated**: 2025-07-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: sre

## README

[grokdebugger.com](https://www.grokdebugger.com)

This client-side application uses WebAssembly to emulate the logstash grok library in the browser. It is responsive, feature-rich, and can help you quickly debug your grok patterns. Although it works well in most cases, it is not an exact port of logstash grok, so be sure to test your patterns in your environment before deploying. 

**Features:**

- Real-time processing (see changes as you type)
- Autocomplete
- Match highlighting
- Syntax highlighting
- Multiline debugging
- 20+ pattern sets (AWS, Grok, firewalls, Java, etc.)
- Add more pattern sets with a URL
- Save and use your own custom patterns

**Limitations:**

- Does not support nested objects in naming e.g. `%{IP:user.ip}` or `<%{NONNEGINT:[log][syslog][priority]}>`
- Does not support explicitly defined output types e.g. `%{NUMBER:status:int}`
- Does not support inline flag modifiers e.g. `(?i)opid=%{NOTSPACE:event_operation_id}` https://github.com/cjslack/grok-debugger/issues/6

**Run locally:**

Must have [node.js](https://nodejs.org/en) installed
```
git clone https://github.com/cjslack/grok-debugger.git
cd grok-debugger
npm install
npm start
```

**How I made this:**

[node-grok](https://github.com/Beh01der/node-grok) is a library that emulates the grok libarary, but it is not an exact port of it. I [forked](https://github.com/cjslack/grok-js-web) this node.js library and adapted it to run in the browser with Web Assembly.