Skip to content

Commit

Permalink
chore(*) document metric name prefixing differences betweeen SDK hosts
Browse files Browse the repository at this point in the history
  • Loading branch information
casimiro authored and thibaultcha committed Sep 19, 2024
1 parent 982e5b5 commit 22810ac
Showing 1 changed file with 22 additions and 0 deletions.
22 changes: 22 additions & 0 deletions docs/PROXY_WASM_HOST_DIFFERENCES.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Proxy-Wasm Host Differences

Listed here are noteworthy internal discrepancies (implementation differences)
between ngx_wasm_module and other Proxy-Wasm host implementations.

## Table of Contents

- [Metrics Prefixing](#metrics-prefixing)

## Metrics Prefixing

- Envoy internally prefixes metric names with `wasmcustom.*` and only exposes
this prefix in the output of the `/metrics` endpoint.
- For internal implementation reasons, ngx_wasm_module prefixes metric names
with `pw.[filter_name].*`, where `filter_name` is the name of the filter
that defined the metric. Only the ngx_wasm_module FFI library may expose the
existence of this prefix.

Proxy-Wasm SDK users need not worry as metric names are never exposed through
the SDK in the first place.

[Back to TOC](#table-of-contents)

0 comments on commit 22810ac

Please sign in to comment.