diff options
Diffstat (limited to 'src/fluent-bit/examples/filter_wasm_go/README.md')
| -rw-r--r-- | src/fluent-bit/examples/filter_wasm_go/README.md | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/src/fluent-bit/examples/filter_wasm_go/README.md b/src/fluent-bit/examples/filter_wasm_go/README.md new file mode 100644 index 000000000..863cf8360 --- /dev/null +++ b/src/fluent-bit/examples/filter_wasm_go/README.md @@ -0,0 +1,63 @@ +# Fluent Bit / filter_wasm_go + +This source source tree provides an example of WASM filter program with WASI mode. + +## Prerequisites + +Tested on + +* TinyGo + * [tinygo](https://tinygo.org/) tinygo version 0.23.0 linux/amd64 (using go version go1.18.2 and LLVM version 14.0.0) + * [tinygo](https://tinygo.org/) tinygo version 0.24.0 linux/amd64 (using go version go1.18.2 and LLVM version 14.0.0) + +For Ubuntu, it's easy to install with: + +```console +$ wget https://github.com/tinygo-org/tinygo/releases/download/v0.24.0/tinygo_0.24.0_amd64.deb +$ sudo dpkg -i tinygo_0.24.0_amd64.deb +``` + +## How to build + +Execute _tinygo build_ as follows: + +```console +$ tinygo build -wasm-abi=generic -target=wasi -o filter.wasm filter.go +``` + +Finally, under the same directory, `*.wasm` file will be created: + +```console +$ ls *.wasm +filter.wasm +``` + +## How to confirm WASM filter integration + +Create fluent-bit configuration file as follows: + +```ini +[SERVICE] + Flush 1 + Daemon Off + Log_Level info + HTTP_Server Off + HTTP_Listen 0.0.0.0 + HTTP_Port 2020 + +[INPUT] + Name dummy + Tag dummy.local + +[FILTER] + Name wasm + match dummy.* + WASM_Path /path/to/filter.wasm + Function_Name go_filter + accessible_paths .,/path/to/fluent-bit + +[OUTPUT] + Name stdout + Match * + +``` |