summaryrefslogtreecommitdiffstats
path: root/fluent-bit/examples/filter_rust_clib/README.md
blob: 9be89598bebfe042077d25756356691778bf02cb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
# Fluent Bit / filter_rust_clib

This source source tree provides an example of WASM program with WASI mode mainly written in Rust.

## Prerequisites

* Rust
  * rustc 1.61.0 (fe5b13d68 2022-05-18)
* [rustup](https://rustup.rs/) (For preparing rust compiler and toolchains)
* [cbindgen](https://github.com/eqrion/cbindgen) (For preparing C headers to include exported Rust's c style function(s))
* [WASI SDK](https://github.com/WebAssembly/wasi-sdk)

For Ubuntu, it's easy to install with:

```console
$ export WASI_VERSION=14
$ export WASI_VERSION_FULL=${WASI_VERSION}.0
$ wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-${WASI_VERSION}/wasi-sdk-${WASI_VERSION_FULL}-linux.tar.gz
$ sudo mkdir -p /opt/wasi-sdk/
$ sudo tar xvf wasi-sdk-${WASI_VERSION_FULL}-linux.tar.gz --strip-components=1 -C /opt/wasi-sdk
```

## How to build

Add `wasm32-unknown-unknown` target for Rust toolchain:

```console
$ rustup target add wasm32-unknown-unknown
```

Install `cbindgen` command as follows:

```console
$ cargo install --force cbindgen
```

Then, execute _make build_ as follows:

```console
$ make build
```

Finally, `*.wasm` file will be created:

```console
$ ls *.wasm
rust_clib_filter.wasm
```

## How to confirm WASI 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/rust_clib_filter.wasm
    Function_Name rust_clib_filter
    accessible_paths .,/path/to/fluent-bit

[OUTPUT]
    Name  stdout
    Match *
```